跳到正文
阿里雲開發者社區 AI·· 21 小時前AI 評分59

Claude Code Game Studios 配備 78 個技能後,入口技能為何先不執行任務

给 AI 装上 78 个技能之后,最难的不是让它干活,是让它先别干

AI 導讀

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 开头就写清了它假设什么:没有游戏想法、没有引擎、没有经验。

然后它按顺序做三件事:

  1. 跑 bash .claude/scripts/project-state.sh,拿到 18 行项目状态;
  2. 问用户一个问题(用提问工具,问完就停,不在后面追加建议);
  3. 把四个设置写进 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 会发到上游模板仓库,不是你的。

这是个真安全护栏,不是锦上添花。

提问的规矩

三条,都针对具体的失败模式:

  • 「用提问工具问。没有工具就把选项编号列出来,然后结束这一轮等回答。」
  • 「问题必须是回复的最后一句话:后面不放路径、说明或建议。」
  • 「被跳过或关闭的问题不算回答,要用纯文本再问一次。」

第二条是界面问题:问题后面跟一堆建议,用户就会去回答建议,而不是回答问题。

第三条堵的是漏洞:弹窗被误关,不能被当成同意。

用之前该检查什么

  1. 先自己跑一遍 project-state.sh。如果 source_files 是 unknown,先搞清楚为什么——skill 会如实报,但你得知道是配置错了还是真没代码。
  2. 检查 origin_url。还指向模板仓库的话,先改 remote,否则第一次 push 就发错地方。
  3. 确认你的 harness 认 allowed-tools。如果它不限制 Bash,那三个脚本前缀就只是建议,不是约束。
  4. 留意配置有没有被多写。跑完 /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