Show, not tell

你只说一句话，它自己做完

装好技能后，在一个空文件夹里打开 Claude Code / Codex，点名总监技能，剩下的交给它：

claude code · 你的项目

你： 用 threejs-game-director 从零做一个精品未来风的塔防游戏。
     自动调用玩法、画质、UI、建模、音频、调试、质检各技能。
     先做出能玩的循环，再迭代到通过浏览器、移动端、视觉、UI、性能、发布各项检查。

# Agent 自己做完这些，不用你逐个点名专家技能：
✓ 加载 threejs-game-director → 拆解为 玩法/画质/UI/资产/音频/调试/质检 各阶段
✓ 用内置 Vite + TypeScript + Three.js 脚手架起项目
✓ 先跑出一个能玩的核心循环（可控、有目标、有胜负）
✓ npm run build → 浏览器实跑 → 控制台报错检查 → Playwright 截图
✓ 画布非空像素检查 → 桌面/移动端视口 → 主操作交互验证
✓ 填「视觉评分卡」，把原型级和精品级分清楚，剩余风险写明

它的价值不在“会写 Three.js”，而在把“做一个游戏”这件事拆成有验收、有证据、有台账的流水线——不让原型级的东西冒充精品。

Install

两种装法，30 秒接入

安装器只把 skills/ 复制进对应 agent 的技能目录；同名默认跳过，也绝不删除你其它无关技能。

方式一 · 克隆后本地安装（推荐，最稳）

$ git clone https://github.com/shushuitie2017/threejs-skills.git && cd threejs-skills && ./install.sh --claude

方式二 · 一行远程安装（skills CLI）

$ pnpm dlx skills add shushuitie2017/threejs-skills --skill '*' -a claude-code -g -y

装好后，在你的项目里对 agent 说出你想要的游戏、点名 threejs-game-director 即可——它会拉起需要的专家技能。Codex 用 --codex，两个都装 --all。

The Crew

九个技能，各管一段产线

一个总监统筹，八个专家各守一段。每个技能安装后自包含，自带 SKILL.md、参考资料、检查清单与脚本。

🎬

threejs-game-director

总入口：完整游戏搭建与编排，自动分阶段调度其余技能。

总监

🕹️

threejs-gameplay-systems

可玩循环、架构、机制、实体、输入、相机、物理、手感。

🎨

threejs-aaa-graphics-builder

视觉评分卡、资产架构、模型、材质、光照、VFX、渲染打磨。

🖼️

threejs-game-ui-designer

HUD、菜单、浮层、响应式布局、图标、安全区、触控。

🐛

threejs-debug-profiler

黑屏、运行时报错、加载/缩放/移动端 Bug、性能与渲染指标。

✅

threejs-qa-release

生产构建、浏览器质检、截图、画布像素、移动端检查、发布风险报告。

🧊

threejs-3d-generator

Tripo API 文/图生 3D、纹理、骨骼绑定、动画、GLB/FBX 资产。

🖌️

threejs-image-generator

Gemini 生成概念原画、纹理、贴花、天空、图标、界面美术、图生 3D 源图。

🔊

threejs-audio-generator

ElevenLabs 音效、环境音、界面音、解说/配音 TTS、变声、降噪。

Optional

可选 API 密钥

核心 Three.js 技能不需要任何付费密钥就能用。缺密钥时总监会回退到程序化/本地资产。只在你想让 agent 生成外部模型/图像/音频时才配：

提供方	技能	环境变量	用途
Tripo	`threejs-3d-generator`	`TRIPO_API_KEY`	文/图生 3D、可直接用的 GLB/FBX 主角/载具/道具、纹理、绑定、动画
Gemini	`threejs-image-generator`	`GEMINI_API_KEY`	概念原画、图生 3D 源图、纹理、贴花、天空、图标、界面美术
ElevenLabs	`threejs-audio-generator`	`ELEVENLABS_API_KEY`	音效、环境音、界面音、解说/对白 TTS、变声、音频清理

🔒 红线：绝不把 API 密钥提交进 git、也绝不写进浏览器端游戏代码。技能只在本地 agent 工具里调用这些 API，再把生成的资产存进你的游戏项目。

How it works

为什么它能“做完”，而不只是“生成”

一个总监，八个专家

总监拿到需求后拆阶段、点名对应专家技能，你不必手动选。

证据驱动

每步产出都要有构建、浏览器实跑、截图、像素/视口检查作证，才允许声称“做完”。

自包含脚手架

从空文件夹起步时，内置 Vite + TypeScript + Three.js 游戏脚手架直接开跑。

精品有门槛

「视觉评分卡」把原型级和精品级分开，占位方块、静态场景、没验证的截图不算精品。

Honest boundaries

诚实边界

这是开源技能包的中文改编版：9 个 SKILL.md 与说明已全面中文化；深层 references 技术参考目前仍是英文，会按需逐步中文化。
不自带可玩 demo：本项目是让你的 agent 去“造”游戏的技能，不附带成品游戏站点。
需要 Claude Code 或 Codex：它是给这类编码 agent 用的技能编排，不是独立可执行程序。
AI 不保证一次到位：它把流程、验收和回退讲清楚，但复杂游戏仍需你参与迭代与判断。