Claude Code Game Studios真实会话实录/story-readiness在实现前抓到一个Bug13轮复盘【免费下载链接】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游戏开发会话故事就绪检查如何提前拦截BugClaude 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-doneAI 生成完成度报告核验项结果走跑速度公式、翻滚耐力✅ 单元测试自动通过翻滚无敌帧、地形修正、陡坡阻挡✅ 用户手动确认无硬编码数值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），仅供参考 Claude Code Game Studios真实会话实录：/story-readiness在实现前抓到一个Bug（13轮复盘）
Claude Code Game Studios真实会话实录/story-readiness在实现前抓到一个Bug13轮复盘【免费下载链接】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游戏开发会话故事就绪检查如何提前拦截BugClaude 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-doneAI 生成完成度报告核验项结果走跑速度公式、翻滚耐力✅ 单元测试自动通过翻滚无敌帧、地形修正、陡坡阻挡✅ 用户手动确认无硬编码数值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），仅供参考