开发者指南如何校验、维护并扩展 threejs-game-skills 技能包install.sh 与 validate:skills 详解【免费下载链接】threejs-game-skillsAgent skills for building playable, polished Three.js browser games with gameplay, AAA-style graphics, UI, QA, and optional AI-generated 3D, image, and audio assets.项目地址: https://gitcode.com/gh_mirrors/th/threejs-game-skillsthreejs-game-skills是用于构建可玩、精致的Three.js 浏览器游戏的 Agent 技能包内置 9 个技能覆盖玩法系统、AAA 级画面、UI、调试性能与 QA 发布。本文面向新手详解如何用install.sh一键安装技能、用validate:skills一键校验技能包以及如何扩展自己的新技能。 技能包是什么一分钟了解结构克隆仓库后即可在本地检出中工作git clone https://gitcode.com/gh_mirrors/th/threejs-game-skills每个技能都是一个自包含目录包含SKILL.md技能说明、references/参考文档与检查清单、scripts/辅助脚本和assets/资源。技能包内置的 9 个技能分工如下技能职责threejs-game-director总指挥负责调度其余技能推荐入口threejs-gameplay-systems玩法循环、输入、物理、手感 Vite 游戏模板threejs-aaa-graphics-builderAAA 级画面建模、材质、灯光、视觉评分卡threejs-game-ui-designerHUD、菜单、响应式 UI、安全区threejs-debug-profiler黑屏、运行时报错、性能剖析threejs-qa-release浏览器 QA、截图、画布像素检查、发布报告threejs-3d-generatorTripo API 文本/图片转 3D 模型threejs-image-generatorGemini 生成概念图、贴图、天空、图标threejs-audio-generatorElevenLabs 音效、环境音、语音其中threejs-aaa-graphics-builder还打包了一组视觉评分卡校准锚点截图供 Agent 比对画面质量。下面两张就是内置的校准锚点示例展示了技能包追求的 HUD 与场景完成度⚡ 快速安装技能包install.sh 一键部署install.sh 的作用是把skills/目录复制到本地 Agent 的技能目录让 Codex 或 Claude Code 自动发现这些技能./install.sh --codex # 安装到 ~/.codex/skills ./install.sh --claude # 安装到 ~/.claude/skills ./install.sh --all # 两个目标都装也可以用 npm 脚本package.json 中已定义npm run install:codex npm run install:claude npm run install:allinstall.sh 参数详解--force覆盖同名技能。默认安装会跳过已存在的同名技能并提示Skipping existing skill加--force才会替换适合更新技能包后强制刷新。--prune-managed清理本仓库曾经安装、但当前skills/中已不存在的过期技能。安装状态记录在目标目录的.threejs-game-skills-managed清单文件中未列出的用户自有技能绝不会被误删。--agents安装到~/.agents/skills仅建议用于只读.agents/skills的 Agent 环境否则可能与 Codex 目录产生重复。目标目录可用环境变量CODEX_HOME、CLAUDE_SKILLS_DIR、AGENTS_SKILLS_DIR自定义。 安装脚本在复制时会自动排除node_modules/、__pycache__/、dist/等缓存目录优先使用rsync缺失时回退到cp -R因此在 macOS 和 Linux 上均可直接使用。✅ 一键校验技能包validate:skills 与 check:scripts修改过技能内容后维护者应运行两道官方检查见 README.md 的 Maintainer Checks 一节npm install npm run check:scripts # 校验所有辅助脚本的语法 npm run validate:skills # 逐个校验每个技能的 SKILL.mdcheck:scripts检查三类脚本语法Shell 脚本用bash -n检查含 install.sh、scripts/validate-skills.sh 及 probe_asset_credentials.shNode 脚本用node --check检查如 inspect-threejs-canvas.mjsPython 脚本通过 check-python-syntax.py 做纯语法编译不产生__pycache__文件避免污染仓库。validate:skills则调用 Codex 自带的技能校验器对skills/下每个含SKILL.md的目录逐一运行结构校验npm run validate:skills # 等价于 scripts/validate-skills.sh skills需要注意一个前置条件validate-skills.sh 依赖${CODEX_HOME:-~/.codex}/skills/.system/skill-creator/scripts/quick_validate.py。如果找不到该校验器脚本会直接报错退出——此时先安装好 Codex 的 skill-creator 组件或设置CODEX_HOME指向正确的 Codex 目录。 维护技能包日常更新该改哪里维护场景修改位置调整技能的触发时机各技能的SKILL.mdfrontmatter 中description增加检查清单 / 参考文档对应技能的references/如 visual-scorecard.md修改游戏脚手架代码threejs-vite-game/ 内的src/、tests/修改仓库级协作规则AGENTS.md调整质量门禁threejs-game-director/SKILL.md维护流程建议改动 →npm run check:scripts→npm run validate:skills→./install.sh --all --force刷新本地技能。三条全绿即可放心提交。 扩展教程5 步添加一个新技能建目录在skills/下新建skills/my-new-skill/。写 SKILL.md文件顶部必须有 frontmattername与目录名一致description决定 Agent 何时路由到该技能请写清楚触发场景--- name: my-new-skill description: 何时使用本技能的一句话描述含关键词 ---可选补全资源按需添加references/文档、scripts/辅助脚本、assets/资源文件。可选配 Codex 展示添加agents/openai.yaml提供显示名与默认开场提示。校验并安装npm run check:scripts # 新增了 shell/node/python 脚本时必跑 npm run validate:skills # 确认新技能结构合法 ./install.sh --all --force # 强制刷新本地安装⚠️ 注意技能包遵循自包含原则——新技能不要依赖仓库根部的文档或脚本所需资源全部放进技能自己的目录内否则安装到其他机器后路径会失效。 常用维护脚本路径清单安装器install.sh技能校验器scripts/validate-skills.shPython 语法检查scripts/check-python-syntax.pyAPI 凭证探测只打印SET|MISSING不泄露密钥probe_asset_credentials.sh交付报告审计audit_reference_report.py画布像素检查inspect-threejs-canvas.mjs游戏脚手架生成器create_threejs_game.py按改动 → 校验 → 安装三步走你就能安全地维护并持续扩展 threejs-game-skills 技能包让 Agent 稳定地产出高质量 Three.js 浏览器游戏。【免费下载链接】threejs-game-skillsAgent skills for building playable, polished Three.js browser games with gameplay, AAA-style graphics, UI, QA, and optional AI-generated 3D, image, and audio assets.项目地址: https://gitcode.com/gh_mirrors/th/threejs-game-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考