Claude Code Game Studios 真实会话实录：/adopt 一键接入存量项目，30分钟搞定7步迁移计划

Claude Code Game Studios 真实会话实录/adopt 一键接入存量项目30分钟搞定7步迁移计划【免费下载链接】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-StudiosClaude Code Game Studios是一个把 Claude Code 变成完整游戏开发工作室的开源框架——49 个 AI 智能体、72 个工作流技能、一套模拟真实工作室层级的协调系统。本文以一份真实会话实录为例带你看看/adopt 存量项目接入是如何工作的扫描格式、分级缺口、输出一份7 步迁移计划全程约 30 分钟且绝不覆盖你已有的任何内容。一、什么是 /adopt存量游戏项目接入 AI 工作室的第一站很多开发者都是先写了几个月代码才遇到这套 Agent 系统。此时项目里已经有代码、有零散设计文档但格式和技能流水线对不上——这时候运行的就是/adopt。它和/project-stage-detect的分工不同技能回答的问题/project-stage-detect项目里有什么存在性检查/adopt已有的东西能不能被 72 个技能正确消费格式合规审计/adopt的核心行为三步走 格式审计逐份检查 GDD、ADR、Story、基础设施文件是否符合模板要求缺口分级每个缺口按 BLOCKING / HIGH / MEDIUM / LOW 四级分类生成迁移计划编号排序写入docs/adoption-plan-[date].md需你明确批准才落盘它的行为契约可以在技能测试规范 adopt.md 里查到——包括写文件前必须 AskUserQuestion迁移项按 BLOCKING 优先排序等硬性断言。二、真实会话实录8 轮对话完成接入以下场景来自官方示例会话 session-adopt-brownfield.md一位开发者做了 3 个月游戏——src/gameplay/下约 4000 行 Godot 4.6 GDScriptdesign/下有 3 个粗糙的 markdown 设计笔记没有docs/architecture/没有production/没有系统索引。会话数据⏱️ 约 30 分钟 · 8 轮对话 · ✅ 结果迁移计划落盘 最紧急缺口当场修复第 1 轮输入 /adopt先出项目状态体检表用户只输入了/adopt。Agent 在 fork 上下文中静默读完所有工件后输出 Phase 1 检测结果工件类别状态说明引擎配置✅CLAUDE.md 中已配置 Godot 4.6源代码✅src/gameplay/约 4000 行设计文档⚠️design/下 3 个文件非 GDD 模板格式架构文档❌docs/architecture/缺失系统索引❌design/gdd/systems-index.md缺失生产跟踪❌production/目录缺失关键细节它不是检查文件存不存在而是检查文件内部结构——一个叫gdd.md但没有 8 个模板章节的文件同样会被判为缺口。第 2 轮逐份格式审计缺口四级分类Phase 2 检查了 3 个设计文件的内部结构会话实录 L42-L58combat-notes.md有规则和伤害公式缺 8 个必需章节中的 6 个crafting-ideas.md纯脑暴笔记还谈不上 GDDinventory.md最接近 GDD缺 5 个章节随后 Phase 3 输出缺口分级表L60-L68缺口严重级理由无系统索引 BLOCKING/design-system、/create-stories、/gate-check全部依赖它GDD 文件非模板格式 HIGH技能无法从畸形 GDD 引用 TR-ID无架构文档 HIGH无法运行/architecture-review无生产跟踪 MEDIUM进入生产阶段前不影响crafting 笔记属前 GDD 内容 LOW作为输入很有用暂不阻塞第 3 轮7 步迁移计划出炉本文主角这是整场会话最有价值的产出L70-L89——7 个有序步骤NEVER 覆盖已有内容每一步只填补缺口#步骤技能优先级1创建design/gdd/systems-index.md/map-systems或/adopt内联 BLOCKING2改造inventory.md→ GDD 格式/design-system retrofit design/inventory.md HIGH3改造combat-notes.md→ GDD 格式/design-system retrofit design/combat-notes.md HIGH4将crafting-ideas.md写成完整 GDD/design-system crafting全新增写 MEDIUM5从现有代码反推架构 ADR/reverse-document/architecture-decision HIGH6创建主架构文档/create-architecture HIGH7搭建生产跟踪/sprint-plan new MEDIUM注意第 4 步的微妙之处太随意的笔记不做 retrofit而是以它为原料全新增写 GDD——计划会区分补全与新写两种策略。另外第 1 步必须先行其余步骤可并行或按你的优先级重排。Agent 落盘前会明确询问May I write this plan todocs/adoption-plan-2026-03-12.md?——这正是 COLLABORATIVE-DESIGN-PRINCIPLE.md 定义的Question → Options → Decision → Draft → Approval协作协议。第 4-6 轮BLOCKING 缺口当场修复计划落盘后Agent 没有止步于报告问题而是主动提出读你现有代码和设计文档推断出你已构建的系统直接生成系统索引草稿——比从头跑/map-systems更快。它从代码目录结构推断出 6 个系统边界Movement、World/Terrain、Combat、Inventory、Crafting、UI/HUD并生成带依赖关系的草稿表。用户补充了一个 Agent 没发现的 Stamina 系统Agent 随即更新依赖关系写入design/gdd/systems-index.md。第 7-8 轮展示解锁了什么收尾BLOCKING 缺口解除后Agent 明确列出现在可运行的技能✅/design-system [name]— 任意系统的引导式 GDD 撰写✅/design-system retrofit [path]— 补全现有文档缺失章节✅/gate-check— 有了系统索引可供校验✅/help— 能显示正确的阶段工作流并给出推荐顺序先 retrofit 完成度最高的inventory.md最小胜利再处理combat-notes.md最后用/review-all-gdds做跨系统一致性检查再进入架构阶段。整个工作流的阶段定义可参考 WORKFLOW-GUIDE.md。三、为什么这份迁移计划可信4 个设计原则格式审计而非存在审计文件在不在不重要能不能被技能流水线消费才重要迁移而非替换已有内容绝不覆盖只做增量补全retrofitBLOCKING 优先浮现按阻塞多少下游技能定级修复顺序由影响面决定从代码中推断答案brownfield 项目的代码结构本身就是系统索引的现成答案Agent 读代码推断、人来确认另外/adopt全程运行在forked context中——避免把整个代码库的大文件读取污染主会话上下文且它是纯工具型审计不触发任何 director 门禁无 CD-*/TD-*/PR-* 等 gate 判定。四、上手路径与关键文件速查 快速接入你的存量项目克隆仓库git clone https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios my-game用你的代码和设计文档替换/合并对应目录在 CLAUDE.md 中确认引擎配置打开 Claude Code 会话输入/adopt批准计划落盘 → 批准 BLOCKING 缺口修复 → 按 7 步计划逐步推进想了解什么看哪里完整 8 轮会话原文docs/examples/session-adopt-brownfield.md/adopt 行为契约与测试用例CCGS Skill Testing Framework/skills/utility/adopt.md技能/智能体全量目录CCGS Skill Testing Framework/README.md7 阶段流水线全指南docs/WORKFLOW-GUIDE.md旧版本模板升级迁移UPGRADING.md项目总览49 agents / 72 skills / hooksREADME.md一句话总结/adopt把我的老项目能不能用这套系统怎么用这个模糊问题变成了一张可执行的 7 步清单——存量代码不被碰坏BLOCKING 缺口当场修复剩下每一步都对应一条明确的斜杠命令。【免费下载链接】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），仅供参考