企业官网建设流程全解析

开发者指南：如何校验、维护并扩展 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-skills

threejs-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-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:all

install.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.md

check:scripts检查三类脚本语法：

• Shell 脚本用bash -n检查（含 install.sh、scripts/validate-skills.sh 及 probe_asset_credentials.sh）；
• Node 脚本用node --check检查（如 inspect-threejs-canvas.mjs）；
• Python 脚本通过 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 目录。

🔧 维护技能包：日常更新该改哪里

维护流程建议：改动 →npm run check:scripts→npm run validate:skills→./install.sh --all --force刷新本地技能。三条全绿即可放心提交。

🚀 扩展教程：5 步添加一个新技能

1. 建目录：在skills/下新建skills/my-new-skill/。

2. 写 SKILL.md：文件顶部必须有 frontmatter，name与目录名一致，description决定 Agent 何时路由到该技能，请写清楚触发场景：

   --- name: my-new-skill description: "何时使用本技能的一句话描述，含关键词" ---

3. （可选）补全资源：按需添加references/文档、scripts/辅助脚本、assets/资源文件。

4. （可选）配 Codex 展示：添加agents/openai.yaml提供显示名与默认开场提示。

5. 校验并安装：

   npm run check:scripts # 新增了 shell/node/python 脚本时必跑 npm run validate:skills # 确认新技能结构合法 ./install.sh --all --force # 强制刷新本地安装

⚠️ 注意：技能包遵循自包含原则——新技能不要依赖仓库根部的文档或脚本，所需资源全部放进技能自己的目录内，否则安装到其他机器后路径会失效。

🧰 常用维护脚本路径清单

• 安装器：install.sh
• 技能校验器：scripts/validate-skills.sh
• Python 语法检查：scripts/check-python-syntax.py
• API 凭证探测（只打印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