Claude Code Game Studios 配備 78 個技能後,入口技能為何先不執行任務
给 AI 装上 78 个技能之后,最难的不是让它干活,是让它先别干
Claude Code Game Studios 設有 49 個智能體、78 個技能和 17 個 hooks;其 `/start` 入口技能先讀取項目狀態、詢問用戶進度,再將建置工作交給 `/prototype`,不直接執行。
2026-11-21 7
版权
版权声明:
本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
简介: Claude Code Game Studios 有 49 个 agent、78 个 skill,但它的入口 skill 故意不写代码。它会先读项目状态、问你在哪一步、把假设摆给你看,再把你交给 /prototype。这篇拆它的两个设计:为什么入口要拒绝执行,以及 `allowed-tools` 只用三个脚本前缀是怎么做到的。
先说结论
这个仓库装完之后,你输入 /start,它不会给你写游戏。
它做的事是:读一遍项目现状,问你从哪来,把它的假设列出来给你改,然后告诉你下一步该敲什么。真正动手的是另一个 skill。
听起来像脱裤子放屁。但拆开看,这个「拒绝执行」的设计解决了一个具体问题:多技能系统里,入口的职责不是做事,是确定该做哪件事。
系统有多大
| 项 | 数量 |
|---|---|
| Agent | 49 个 |
| Skill | 78 个 |
| Hooks | 17 个 |
| 仓库星数 | 40,224 |
这么大的系统,一上来就动手,只会在错误的分支上跑很远。
它的入口 skill 在 skills.pub 上有收录:https://skills.pub/en/skills/donchitos-claude-code-game-studios-start
为什么入口要拒绝执行
SKILL.md 开头就写清了它假设什么:没有游戏想法、没有引擎、没有经验。
然后它按顺序做三件事:
- 跑
bash .claude/scripts/project-state.sh,拿到 18 行项目状态; - 问用户一个问题(用提问工具,问完就停,不在后面追加建议);
- 把四个设置写进
project.yaml——但要用户明确同意之后才写。
那四个设置是 project.stage、project.goal、modes.rigor、modes.automation。
最值得抄的是它「不写」什么
真正体现作者踩过坑的,是排除清单。
skill 明确声明:从不写 modes.review_mode,也不写 rigor 会派生的那些开关——modes.workflow、docs.density、qa.level、modes.story_granularity、team.size。
理由一句话:「写死的值会把这个开关钉住,盖过 rigor 的自动展开;而旧的镜像文件优先级比新文件还高。」
翻译成白话:你写了一个本该自动推导的配置,它就再也不变了;更糟的是有个历史遗留的镜像文件在悄悄覆盖新文件,导致你改了没生效,还查不出原因。
| 它写 | 它不写 |
|---|---|
project.stage |
modes.review_mode |
project.goal |
modes.workflow |
modes.rigor |
docs.density |
modes.automation |
qa.level、team.size |
写过配置系统的人都懂:能推导的就别写死,写死等于永久冻结。
allowed-tools 只用三个脚本前缀
它的 frontmatter 长这样:
allowed-tools: Read, Glob, Grep, AskUserQuestion, Skill,
Bash(bash .claude/scripts/project-state.sh*),
Bash(bash .claude/scripts/set-stage.sh *),
Bash(bash .claude/scripts/config-set.sh *)
model: sonnet
注意三点:
- 没有通用的
Bash。只能跑那三个脚本,跑不了任意 shell。 - 没有
Write/Edit。想改配置,只能通过脚本改。 model: sonnet。这个入口 skill 固定在便宜的模型上跑,不占用主会话的贵模型。
第三条背后有个不太明显的理由,SKILL.md 自己解释了:如果用户是主动敲 /start,那一轮跑在这个 skill 的模型上;而真正的构建必须跑在会话的模型上。
所以它把构建这一步交给 /prototype,用 Skill 工具转出去——这样工序就回到了主会话的模型。
它聪明在哪一步
Phase 1 跑的那个 project-state.sh 会输出 18 行状态。其中两行有防御性处理:
一、source_files 返回 unknown。
这表示找不到代码根目录。skill 要求如实报告这个状态,不能说「没有代码」——因为用户可能真的以为自己有代码。这两个说法对用户的意义完全不同。
二、origin_url 检查。
它会拿 origin_url 去匹配 donchitos/claude-code-game-studios(大小写不敏感)。如果匹配上了,说明你还是从模板仓库克隆的,没换成自己的仓库。
后果很实际:这时候你的第一次 push 或 PR 会发到上游模板仓库,不是你的。
这是个真安全护栏,不是锦上添花。
提问的规矩
三条,都针对具体的失败模式:
- 「用提问工具问。没有工具就把选项编号列出来,然后结束这一轮等回答。」
- 「问题必须是回复的最后一句话:后面不放路径、说明或建议。」
- 「被跳过或关闭的问题不算回答,要用纯文本再问一次。」
第二条是界面问题:问题后面跟一堆建议,用户就会去回答建议,而不是回答问题。
第三条堵的是漏洞:弹窗被误关,不能被当成同意。
用之前该检查什么
- 先自己跑一遍
project-state.sh。如果source_files是unknown,先搞清楚为什么——skill 会如实报,但你得知道是配置错了还是真没代码。 - 检查
origin_url。还指向模板仓库的话,先改 remote,否则第一次 push 就发错地方。 - 确认你的 harness 认
allowed-tools。如果它不限制 Bash,那三个脚本前缀就只是建议,不是约束。 - 留意配置有没有被多写。跑完
/start后如果project.yaml里出现了modes.workflow或qa.level,说明它违反了自己的规则,那个值从此会盖过 rigor 展开。
小结
| 你的问题 | 这个设计怎么回答 |
|---|---|
| 技能太多,不知道先用哪个 | 入口先问、再路由,不直接动手 |
| 配置改了不生效 | 能推导的不写死,避免冻结 |
| AI 乱跑命令 | 三个脚本前缀,无通用 Bash |
| 入口占用了贵模型 | 钉在 sonnet,构建转交主会话 |
| 从模板仓库克隆忘了改 | 检查 origin_url,防止 push 到上游 |
值得抄的不是 78 这个数字,是入口只负责决策、不负责执行这条边界。系统越大,这条边界越值钱。
原文(英文):https://skills.pub/en/blog/claude-code-game-studios-pipeline-of-skills
这个 skill 在 skills.pub 上的页面:https://skills.pub/en/skills/donchitos-claude-code-game-studios-start
來源:阿里雲開發者社區 AI · developer.aliyun.com