企业官网建设流程全解析

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-Studios

Claude Code Game Studios是一个把 Claude Code 变成完整游戏开发工作室的开源框架——49 个 AI 智能体、72 个工作流技能、一套模拟真实工作室层级的协调系统。本文以一份真实会话实录为例，带你看看/adopt 存量项目接入是如何工作的：扫描格式、分级缺口、输出一份7 步迁移计划，全程约 30 分钟，且绝不覆盖你已有的任何内容。

一、什么是 /adopt：存量游戏项目接入 AI 工作室的第一站

很多开发者都是"先写了几个月代码，才遇到这套 Agent 系统"。此时项目里已经有代码、有零散设计文档，但格式和技能流水线对不上——这时候运行的就是/adopt。

它和/project-stage-detect的分工不同：

/adopt的核心行为三步走 🎯：

1. 格式审计：逐份检查 GDD、ADR、Story、基础设施文件是否符合模板要求
2. 缺口分级：每个缺口按 BLOCKING / HIGH / MEDIUM / LOW 四级分类
3. 生成迁移计划：编号排序，写入docs/adoption-plan-[date].md（需你明确批准才落盘）

它的行为契约可以在技能测试规范 adopt.md 里查到——包括"写文件前必须 AskUserQuestion""迁移项按 BLOCKING 优先排序"等硬性断言。

二、真实会话实录：8 轮对话完成接入

以下场景来自官方示例会话 session-adopt-brownfield.md：一位开发者做了 3 个月游戏——src/gameplay/下约 4000 行 Godot 4.6 GDScript，design/下有 3 个粗糙的 markdown 设计笔记，没有docs/architecture/，没有production/，没有系统索引。

会话数据：⏱️ 约 30 分钟 · 💬 8 轮对话 · ✅ 结果：迁移计划落盘 + 最紧急缺口当场修复

第 1 轮：输入 /adopt，先出"项目状态体检表"

用户只输入了/adopt。Agent 在 fork 上下文中静默读完所有工件后，输出 Phase 1 检测结果：

关键细节：它不是检查"文件存不存在"，而是检查文件内部结构——一个叫gdd.md但没有 8 个模板章节的文件，同样会被判为缺口。

第 2 轮：逐份格式审计，缺口四级分类

Phase 2 检查了 3 个设计文件的内部结构（会话实录 L42-L58）：

• combat-notes.md：有规则和伤害公式，缺 8 个必需章节中的 6 个
• crafting-ideas.md：纯脑暴笔记，还谈不上 GDD
• inventory.md：最接近 GDD，缺 5 个章节

随后 Phase 3 输出缺口分级表（L60-L68）：

第 3 轮：7 步迁移计划出炉（本文主角）

这是整场会话最有价值的产出（L70-L89）——7 个有序步骤，NEVER 覆盖已有内容，每一步只填补缺口：

注意第 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 个设计原则

1. 格式审计而非存在审计：文件"在不在"不重要，"能不能被技能流水线消费"才重要
2. 迁移而非替换：已有内容绝不覆盖，只做增量补全（retrofit）
3. BLOCKING 优先浮现：按"阻塞多少下游技能"定级，修复顺序由影响面决定
4. 从代码中推断答案：brownfield 项目的代码结构本身就是系统索引的现成答案，Agent 读代码推断、人来确认

另外/adopt全程运行在forked context中——避免把整个代码库的大文件读取污染主会话上下文；且它是纯工具型审计，不触发任何 director 门禁（无 CD-*/TD-*/PR-* 等 gate 判定）。

四、上手路径与关键文件速查 📦

快速接入你的存量项目：

1. 克隆仓库：git clone https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios my-game
2. 用你的代码和设计文档替换/合并对应目录，在 CLAUDE.md 中确认引擎配置
3. 打开 Claude Code 会话，输入/adopt
4. 批准计划落盘 → 批准 BLOCKING 缺口修复 → 按 7 步计划逐步推进

一句话总结：/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