Claude Code Game Studios真实会话实录：/story-readiness在实现前抓到一个Bug（13轮复盘）
【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios
一次真实的AI游戏开发会话：故事就绪检查如何提前拦截Bug
Claude Code Game Studios是一个把 Claude Code 变成完整游戏开发工作室的开源项目：49 个 AI 智能体、72 个工作流技能，模拟真实游戏公司的层级协作。本文复盘一次真实会话——在动写代码之前，/story-readiness技能就抓住了一个隐藏的方向逻辑 Bug。
💡 核心看点：AI 写代码不可怕，可怕的是写错了还不知道。这个项目用"就绪门禁"把问题挡在实现之前。
为什么需要"故事就绪检查"？
在 AI 辅助游戏开发中，单个聊天会话往往缺乏结构约束：没人阻止你硬编码魔法数字、跳过设计文档、或者在验收标准含糊时就动手写代码。
Claude Code Game Studios 的思路是：先验证任务卡（Story）是否真的可以开工，再让程序员智能体开始实现。这套流程来自 72 个斜杠技能中的故事管理系列：/create-stories→/story-readiness→ 实现 →/story-done。
/story-readiness是一个只读技能（它绝不修改文件），它会从四个维度验证一个故事文件：
| 维度 | 检查内容 |
|---|---|
| 设计完整性 | 是否引用了具体 GDD 需求、验收标准是否可测试 |
| 架构完整性 | ADR 状态是否为 Accepted、控制清单版本是否一致 |
| 范围清晰度 | 验收标准数量与可测量性、范围外事项 |
| 完成定义（DoD） | 测试要求、集成信号是否明确 |
最终输出三种判定之一：READY / NEEDS WORK / BLOCKED。技能定义见 SKILL.md。
13轮会话复盘：从检查到关单
第1-2轮：运行就绪检查，发现1处歧义
会话开始时，移动系统（movement system）的 GDD 和架构文档已完成，由/create-stories生成的故事文件STORY-MOV-001尚未验证。用户输入：
/story-readiness production/stories/STORY-MOV-001.mdAI 依次检查了四个维度，结果几乎全绿——GDD 已引用、8 个 TR-ID 全部内嵌、ADR 状态 Accepted、9 条可测量验收标准……但在"范围清晰度"检查中发现 1 处歧义：
⚠️ 故事文件说"翻滚方向跟随最后输入方向"，而 GDD 说"沿移动方向翻滚"——当玩家原地站立时按下翻滚，两条规则互相矛盾。
这就是那个 Bug：一个典型的边界条件逻辑冲突。如果此时直接开始实现，程序员智能体只能二选一"猜"一个实现，错误就会潜伏到手动测试甚至上线阶段才暴露。
判定：NEEDS WORK——必须先消除歧义才能开工。
第3-4轮：30秒消除歧义，故事转为 READY
用户一句话给出决策：
"翻滚使用最后一次移动方向。如果玩家静止站立，翻滚使用当前朝向代替。"
AI 将这条规则写回故事文件，状态更新为ready-for-dev：
判定：READY—— 故事已可实施。
第5-9轮：实现阶段——提案先行，代码后写
进入实现后，游戏程序员智能体先读取故事、GDD 和 ADR，先给出文件结构提案（movement_component.gd、地形修正表、单元测试文件），并展示关键代码摘录——所有数值都是@export导出变量而非硬编码——经用户确认后才落盘。这体现了该项目的规则体系（11 条路径作用域编码规范 + 12 个钩子）对写操作的约束。
第10-12轮：/story-done 关闭故事，9条标准逐条核验
用户手动测试后运行/story-done，AI 生成完成度报告：
| 核验项 | 结果 |
|---|---|
| 走跑速度公式、翻滚耐力 | ✅ 单元测试自动通过 |
| 翻滚无敌帧、地形修正、陡坡阻挡 | ✅ 用户手动确认 |
| 无硬编码数值（grep 魔法数字 = 0） | ✅ 自动通过 |
| 重物携带禁用奔跑、耐力信号集成 | ⏳ 延迟到后续库存故事 |
两条无法验证的标准被记录为DEFERRED（延迟项），而不是被忽略或阻塞关单——这是"完成带备注"（COMPLETE WITH NOTES）的设计哲学。关单后 AI 还自动指出下游依赖已解锁的下一个故事，建议继续运行/story-readiness。
完整 13 轮对话可阅读官方示例：session-story-lifecycle.md
这次会话教会我们的5件事
- 就绪门禁能抓"文档级Bug"——翻滚方向冲突不是代码错误，而是规格冲突，只有交叉比对故事与 GDD 才能发现，普通 code review 抓不到。
- ADR 状态是硬门禁——若引用的架构决策记录（ADR）状态还是
Proposed而非Accepted，故事直接判定 BLOCKED，实现不会开始。 - NEEDS WORK 与 BLOCKED 有区别——前者可自行修复，后者需要外部行动（比如先批准 ADR）。
- 延迟标准不阻塞关单——
/story-done会跟踪那些"现在无法验证"的验收项，自动在未来的相关故事中浮现。 - TR-ID 解耦文档与故事——故事存
TR-MOV-001这类 ID 引用而非复制 GDD 原文，GDD 后续润色措辞时不会产生虚假的"偏离"告警。ID 注册表见 tr-registry.yaml。
快速上手：如何运行同样的检查
如果你想在自己的项目里体验这套流程：
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios - 阅读总览与启动指南：README.md、WORKFLOW-GUIDE.md
- 在 Claude Code 中依次使用
/start→/create-stories→/story-readiness <故事文件路径> - 想批量检查整个冲刺的所有故事？直接运行
/story-readiness sprint或/story-readiness all
技能的测试规约（5 个用例，覆盖 Happy Path / Blocked / Needs Work / 清单过期 / 评审模式门禁）也开源在 CCGS Skill Testing Framework/skills/readiness/story-readiness.md，可见其判定逻辑是经过系统验证的。
结语
AI 编码的速度不再是瓶颈，质量门禁才是。Claude Code Game Studios 用 49 个智能体和 72 个技能把"真实工作室的流程纪律"装进一个 Claude Code 会话：这次 13 轮会话证明，/story-readiness只花了不到 1 分钟，就换回了一个本会在实现后期付出数倍代价的 Bug。对独立开发者来说，这或许正是"AI 游戏工作室"最划算的一笔投资。
【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
