Three.js Game Skills 游戏开发技能包

Three.js Game Skills 是什么

Three.js Game Skills 是一套面向 AI 编程代理（Codex、Claude Code）的自包含技能包，目标是让代理帮你做出「可玩且打磨到位」的 Three.js 浏览器游戏。安装后只需在提示中点名 threejs-game-director，它就会自动调度玩法、画面、UI、素材生成、音频、调试与发布验证等专项技能，而不需要你逐个挑选。

核心设计

一个 director 统领九个技能

• director 技能：保留你的范围与美术方向，自动调用专项指导，在宿主支持时委派独立任务，并按改动规模调整验证力度。
• 专项技能：覆盖玩法系统、AAA 风格图形、UI、调试与性能分析、QA 与发布、3D 生成、图像生成、音频生成等。
• 规模自适应：完整游戏走一遍完整生产流程，小到一个 HUD 修复就只做小改动。

自带运行时材料

技能包内含代理所需的全部素材：SKILL.md 文件、参考资料、辅助脚本，以及打包在技能目录中的 Vite + TypeScript + Three.js 脚手架。生成的游戏自带确定性测试钩子、种子随机数（seeded RNG）和 Playwright 模板，用于冒烟测试、视觉回归基线与机器人试玩。

安装与使用

为 Codex 安装全部技能：

npx skills add majidmanzarpour/threejs-game-skills --skill '*' -a codex -g -y

为 Claude Code 安装：

npx skills add majidmanzarpour/threejs-game-skills --skill '*' -a claude-code -g -y

也可以克隆仓库后用本地脚本安装：

./install.sh --codex   # 仅 Codex
./install.sh --claude  # 仅 Claude Code
./install.sh --all     # 两者都装

安装后在空项目或已有 Three.js 项目中打开代理，用类似下面的提示即可：

Use threejs-game-director to build a premium futuristic tower defense game from scratch.

代理会做什么

• 先加载 threejs-game-director，再按需加载兄弟技能。
• 从空目录开始时，内部使用打包好的脚手架。
• 先确立美术方向、玩法镜头尺度与一个可玩场景，再扩展关卡与素材族。
• 对大型构建，用紧凑的项目笔记保留约束、已完成工作、待处理素材任务与下一步动作。
• 按改动运行相应检查：完整游戏包含生产构建、真实输入、截图、画布像素、受支持视口与动画证据。

可选 API Key

核心 Three.js 技能不需要付费 API Key。缺少 Key 或额度耗尽时，director 会继续使用程序化/本地素材，并报告受影响的限制。只有想生成外部模型、图像或音频时才需要配置：

在 shell 配置中设置后重启终端即可：

export TRIPO_API_KEY="..."
export GEMINI_API_KEY="..."
export ELEVENLABS_API_KEY="..."

切勿把 API Key 提交到仓库或写进浏览器端游戏代码。这些技能通过本地代理工具调用提供方 API，再把生成的素材保存到你的游戏项目中。

适用人群

适合希望用 AI 代理快速产出可玩 Three.js 网页游戏原型的开发者，以及想为现有 Three.js 项目引入自动化 QA 与素材生成流程的团队。需要具备基本的 Node.js 与前端工程经验，并对 Codex / Claude Code 的用法有初步了解。