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代理能可靠地验证自身工作。