一句话原型到 itch.io:七阶段工作流与安全钩子

这是工作室系列的收尾篇:跟着一条命令走进去,看一个想法怎么变成 design/game-brief.md、变成浏览器里能玩的 build、最后变成 itch.io 上的一个干净副本。中间那些"敢放手让 AI 干"的安全设计,才是这套模板真正的护城河。

七个阶段,一条主线

仓库的 docs/ 目录把工作流切成 7 个阶段,配了 62 个文档模板。整条主线长这样:

  1. /prototype 一句话描述游戏,比如官方示例"a fishing game where the rare fish only bite at dusk"(稀有的鱼只在黄昏咬钩);
  2. Claude 反问几个问题,补齐它不能瞎猜的部分——黄昏怎么判定?稀有度怎么体现?
  3. 把答案写成单页简报 design/game-brief.md,rigor 默认 minimal 档下就这一页;
  4. 在 prototypes/<名称>/ 里构建可玩的浏览器游戏;
  5. 无头浏览器自动验证:截图看画面、模拟按键测操作;
  6. 生成交付卡(handover card),写明哪些通过、哪些还有问题;
  7. 之后自由生长:用对话继续改、用滑杆面板调参数、导出干净副本上传 itch.io、逐步长成真正的 Vite/TypeScript 网页项目(规则是一次只专注做一个功能),最后用 /cut 规划发布。

别被"7 个阶段"吓到:62 个文档模板意味着每一步都有现成的表格与清单,AI 负责填,你负责看和签。项目目录也早就划好了——设计文档、sprint 追踪、游戏代码、QA 证据各归其位,一次性实验全部隔离在 prototypes/ 里,互不污染。导出干净副本时,带走的只有该带走的东西。

让 AI 自己验收自己

第 5、6 步是整套流程的精髓。LLM 说"我做完了"不可信,但截图不会说谎:无头浏览器真实打开游戏、按下按键、拍下画面,AI 再对着截图和测试结果判断对错。更难得的是交付卡的诚实——它被要求写清"哪些还没修好",而不是一片全绿的虚假通过。你拿到手的不是一句"完成",而是一份带已知问题的验收单。这正是它敢自称"协作而非自主"的底气:AI 可以干活,但结论要经得起证据检验。

之后的迭代跑的是同一个闭环:你在对话里说"角色跳得太高了",它改代码、重跑无头测试、更新交付卡;不想打字就用滑杆面板调参数——重力、移动速度、生成概率这类数值直接拖动,改完立刻在浏览器里试。验证成本被压到几乎为零,改起来才毫无心理负担。

安全网:15 个钩子、18 个脚本、14 条路径规则

为什么这套模板敢让你放手?因为放手的前提是绊网。.claude/ 里装着 18 个 hook 脚本,实现 15 个事件钩子,自动验证提交、推送、素材 JSON、设计文档阅读、agent 产物——AI 想跳过流程,钩子会把流程拽回来。权限规则负责红线:force push、rm -rf、读取 .env 这类危险操作直接被阻止。另外还有 14 条路径限定规则,划定 AI 能碰哪些目录、不能碰哪些。再次提醒:这一切只在仓库根目录运行 claude 时生效,进子目录启动会跳过钩子与权限,等于裸奔。

两条路线,两种成熟度

浏览器路线(原型即网页游戏)是这套系统的主场:经过盲测、验证闭环完整、itch.io 导出顺理成章,原型长成 Vite/TypeScript 项目也有明确路径。引擎路线(Godot 4、Unity、Unreal 5)可用,有对应专家智能体,但没有经过同样的盲测——官方自己也承认这一点。

想走引擎路线,先降低预期

用引擎路线做项目没问题,但别拿浏览器路线的顺滑度去期待它:验证与调试链路没有盲测背书,遇到问题要多自己上手。对 R36S 玩家来说,浏览器路线产出的网页游戏反而更现实——浏览器内核的自制固件可以直达。

下一步

回到起点看全貌:Claude Code 游戏工作室:49 个智能体的协作系统;团队怎么分层见 导演、主管与 30 个专家:AI 团队怎么分工。想把"截图验收"的思路用进自己的自制游戏质检,参考 AI 测试实战;要把 AI 融进更完整的日常开发流程,看 发行指南 与 AI 自动测试,进阶工作流见 AI 开发工作流。

↑