majidmanzarpour/threejs-game-skills

解決的問題

透過提供一組專門的「技能」給AI代理（特別是Codex與Claude Code），簡化了建立專業且精緻的Three.js瀏覽器遊戲的流程。使用者無需手動引導每一項技術細節，這些技能讓代理能自動協調遊戲機制、高階圖形、UI設計、資產生成與品質保證。

如何運作

本專案提供一組 SKILL.md 檔案、提示範本與輔助腳本，安裝至AI代理的技能目錄中。一個中央的「導演」技能（threejs-game-director）擔任協調者，將任務導向特定需求的專業技能：

• 遊戲玩法與UI：處理機制、物理與反應式HUD。
• 圖形與資產：管理AAA級光照、著色器與材質。可與外部API（Tripo用於3D，Gemini用於影像，ElevenLabs用於音訊）整合，生成遊戲就緒的資產。
• QA與除錯：使用內建的Vite + TypeScript架構與Playwright範本，執行煙霧測試、視覺回歸檢查與效能分析。

適用對象

使用AI代理（如Claude Code或Codex）開發3D網頁遊戲，並希望從基礎原型進階至生產級、精緻體驗的開發者。

特色

• 代理協調：一個導演技能，可自動協調多個專業技能，完成完整的遊戲開發生命週期。
• 自動化QA：內建畫布像素檢查、機器人測試與視覺評分卡工具，用以驗證遊戲品質。
• AI資產流程：透過API金鑰原生整合，生成3D模型、貼圖與音效。
• 決定性測試：附帶種子隨機數生成器與測試鈎子，確保AI代理能可靠地驗證自身工作。