
Claude Code Game Studios 项目阶段分析报告基于 /project-stage-detect 的全项目体检与缺口诊断模板【免费下载链接】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项目阶段分析报告Project Stage Analysis Report是 Claude Code Game Studios 为游戏开发项目提供全项目体检的标准化输出文档它由 project-stage-detect 技能 驱动通过扫描设计、代码、架构、生产、测试、原型六类产物判定项目当前所处开发阶段、量化完整性缺口并产出带优先级与角色视角的建议。读者学完本文将掌握报告模板每一节的填写语义与生成流程理解阶段分类的启发式规则并能将报告与/gate-check阶段门禁、/milestone-review里程碑评审衔接成完整的开发治理闭环。一、模板在项目中的定位与生成链路该模板文件位于 .claude/docs/templates/project-stage-report.md是整个工作流中诊断类产出的唯一标准格式。它由/project-stage-detect技能定义见 .claude/skills/project-stage-detect/SKILL.md在第四步Generate Stage Report时使用。在仓库的整套技能体系中该技能适合在以下场景触发接手一个已有项目、首次摸清家底时新成员 onboard 代码库时里程碑前检查还缺什么产物时回答我们现在开发到哪一步了where are we?这一核心问题时。技能本身是只读诊断型技能Read-only diagnostic skill不需要委派专家 Agent使用轻量模型model: haiku即可运行。其完整工作流分为六步扫描关键目录 → 分类项目阶段 → 协作式缺口识别 → 生成阶段报告 → 角色过滤建议 → 写入前征求批准。模板承担的是第四步的输出载体同时报告中的Follow-Up Skills一栏也直接复用其余步骤的结论。值得强调的是该技能与/gate-check的职责分工/project-stage-detect是诊断我们在哪而/gate-check是裁决我们是否准备好前进并给出正式结论两者互补但不可互相替代这一点在 gate-check 技能定义 中有明确区分。二、报告头生成时间、阶段与分析范围模板头部是三组元数据用于标注报告的可追溯性字段取值说明Generated[DATE]报告生成日期用于判断数据时效StageConcept \| Systems Design \| Technical Setup \| Pre-Production \| Production \| Polish \| Release判定出的当前阶段取值来自七阶段流水线Analysis ScopeFull project \| Specific role: programmer/designer/producer分析范围全项目或仅限某个角色视角其中 Stage 的七种取值对应仓库 workflow-catalog.yaml 中定义、并由/gate-check强化的完整开发流水线Concept头脑风暴、游戏概念文档→Systems Design系统分解、编写 GDD→Technical Setup引擎配置、架构决策→Pre-Production原型、垂直切片验证→ProductionEpic/Feature/Task 追踪下的功能开发→Polish性能、试玩、修 Bug→Release发布准备、认证。阶段判定的优先级规则先检查production/stage.txt——若该文件存在直接采用其值这是/gate-check通过门禁后写入的显式覆盖例如echo -n Production production/stage.txt否则按从最成熟阶段向前倒查的启发式自动检测详见本文第五节的判定表。三、Executive Summary执行摘要执行摘要是报告的门面模板要求在一到两段内说清三件事项目整体状态概述项目当前状态、主要缺口与推荐优先级Current Focus当前焦点项目正在积极推进的工作Blocking Issues阻塞问题阻碍进展的关键缺口Estimated Time to Next Stage预计进入下一阶段的时间如适用则填写。填写这段时信息来自后续所有章节的结论浓缩。根据技能的协作协议见 project-stage-detect SKILL.md在正式落笔写报告前Agent 应先向用户展示摘要级发现并请求批准Ive analyzed your project. Heres what I found… May I write the full stage analysis to production/project-stage-report.md?未经批准不得静默写文件——这是整个仓库坚持的Question First → Present Options → User Decides → Show Draft → Get Approval协作原则的一部分。四、Completeness Overview六维完整性盘点这是报告的主体对项目六个维度逐一给出完成度百分比、文件计数、关键缺口清单。每个维度都对应仓库中约定的物理目录见 directory-structure.md。4.1 Design Documentation设计文档Status[X%]完成度Files Founddesign/下的文档数细分design/gdd/的 GDD 章节数、design/narrative/的叙事文档数、design/levels/的关卡设计数Key Gaps列出缺失文档及缺失原因例如缺少战斗系统 GDD导致程序无法按规格实现。技能在扫描该维度时SKILL.md会进一步检查game-concept.md、game-pillars.md、systems-index.md是否存在若systems-index.md存在则统计系统总数 vs 已设计系统数并逐份评估 GDD 的 Overview、Detailed Design、Edge Cases 等章节完整性。4.2 Source Code源码Status[X%]完成度Files Foundsrc/下的源文件数Major Systems Identified以 ✅正常、⚠️有问题或不完整标注主要系统并给出其src/path/Key Gaps缺失系统及其影响。扫描规则是统计源文件数量语言无关、识别主要系统含 5 个以上文件的目录视为一个系统、检查core/、gameplay/、ai/、networking/、ui/等标准子目录、粗估代码行数规模。4.3 Architecture Documentation架构文档Status完成度百分比ADRs Founddocs/architecture/下的架构决策记录ADR数量Coverage逐项用 ✅/⚠️/❌ 标注——已记录、已实现但未记录、既未实现也未决策Key Gaps缺失的 ADR 及需要它的原因。这与 workflow-catalog.yaml 中 Technical Setup 阶段的要求呼应架构文档docs/architecture/architecture.md与至少 3 份 Foundation 层 ADRdocs/architecture/adr-*.mdmin_count: 3是进入 Pre-Production 的必需产物。4.4 Production Management生产管理Status完成度百分比Foundproduction/sprints/的冲刺计划数、production/milestones/的里程碑数、Roadmap 是否存在Key Gaps缺失的生产产物及其影响。仓库的生产目录还承载了/start技能写入的production/review-mode.txtFull/Lean/Solo 三档评审模式与/gate-check写入的production/stage.txt这些文件是阶段与评审治理的状态源。4.5 Testing测试Status覆盖率估算Test Filestests/下测试文件数Coverage by System按系统给出估算覆盖率Key Gaps缺失测试领域及风险。注意模板明确标注该覆盖率是estimated——技能只做粗略启发式估算不生产精确指标。4.6 Prototypes原型Active Prototypesprototypes/下的活动原型数标注 ✅ 有 README、⚠️ 无 README 状态不明Archived已归档原型数完成实验Key Gaps未文档化的原型及原因。五、Stage Classification Rationale阶段分类依据这一节回答为什么判定为当前阶段是报告最有方法论价值的部分。技能在 SKILL.md 中给出了完整启发式判定表从最成熟阶段向前倒查阶段判定指标Concept无游戏概念文档处于头脑风暴期Systems Design概念文档存在systems index 缺失或不完整Technical Setupsystems index 存在引擎未配置Pre-Production引擎已配置src/源文件少于 10 个Productionsrc/有 10 源文件开发活跃Polish仅显式设置由/gate-check的 Production → Polish 门禁写入Release仅显式设置由/gate-check的 Polish → Release 门禁写入模板要求在这一节回答三个子问题Why [Stage]?— 基于已扫描到的指标解释分类原因Indicators for this stage— 列出与当前阶段匹配的证据指标Next stage requirements— 以复选框列出进入下一阶段的必要条件例如从 Pre-Production 进入 Production 需要至少 1 个带 README 的原型、首个冲刺计划、完整的 Art Bible、可玩且经过 3 次以上内部试玩的垂直切片等完整清单见 gate-check SKILL.md。六、Gaps Identified分级缺口与澄清问题模板将缺口按影响分为三级每级都遵循Impact → Question → Suggested Action三段式结构——这是整套仓库协作式缺口识别的核心体现不要只罗列缺失文件而要针对缺口先提出澄清问题。技能给出了大量真实对话范例SKILL.md我看到了战斗代码src/gameplay/combat/但没有design/gdd/combat-system.md。这是先原型后文档还是需要反向文档化→ 对应/reverse-document你有 15 份 ADR 但没有架构总览。是否需要我创建一份以帮助新贡献者production/下没有冲刺计划。你们在其他地方Jira、Trello 等跟踪工作吗我找到了游戏概念但没有 systems index。你是否已将概念分解为独立系统还是应该运行/map-systemsprototypes/下有 3 个项目没有 README。这些是实验还是需要文档化三级缺口的填写语义Critical Gaps阻塞进展— 例如缺失 GDD 导致程序员无法开工、无 ADR 导致架构决策悬空Important Gaps影响质量/速度— 例如测试覆盖不足导致回归风险累积Nice-to-Have Gaps打磨/最佳实践— 例如原型缺少 README、文档格式不统一。七、Recommended Next Steps分优先级行动建议模板把下一步行动分成三个时间窗每条行动标注建议技能与预估工作量S/M/LImmediate Priority立即执行标明/[skill-name]或人工处理给出 S/M/L 工作量估计Short-Term本冲刺/本周近期必须推进的事项Medium-Term下一里程碑中期需求。技能在 Follow-Up Actions 一节 给出了缺口 → 技能的映射表可直接用于填充此节缺口建议行动有概念但无 systems index/map-systems分解为系统缺设计文档/reverse-document design src/[system]缺架构文档/architecture-decision或/reverse-document architecture原型需要文档化/reverse-document concept prototypes/[name]无冲刺计划/sprint-plan临近里程碑/milestone-review八、Role-Specific Recommendations角色视角建议当用户以角色参数调用/project-stage-detect programmer时报告追加角色过滤建议。技能定义了四类视角SKILL.mdProgrammer聚焦架构文档、测试覆盖、缺失 ADR以及代码与文档之间的缝隙Designer聚焦 GDD 完整性、缺失设计章节、原型文档化Producer聚焦冲刺计划、里程碑跟踪、路线图以及跨团队协调文档General无角色全缺口综合视图给出跨领域最高优先级事项。模板中每个角色小节需给出 Focus areas优先领域、Blockers阻塞项、Next tasks下一步任务清单。九、Follow-Up Skills to Run后续技能清单模板在此节列出基于缺口生成的候选技能调用每个条目包含命令、用途说明/reverse-document [type] [path]— 针对需要反向文档化的缺口/architecture-decision— 针对缺失 ADR/sprint-plan— 生产规划缺失时/milestone-review— 临近截止日期时/onboard [role]— 有新贡献者加入时。这些命令的完整语义与参数格式可查阅 .claude/skills/reverse-document/SKILL.md如/reverse-document design src/gameplay/magic-system、.claude/skills/milestone-review/SKILL.md产出 GO / CONDITIONAL GO / NO-GO 结论等技能定义。十、Appendix按目录统计文件数报告结尾以代码块形式给出标准目录的文件计数快照作为全篇数据的机器可读附录。模板约定的统计口径design/ gdd/ [N] files narrative/ [N] files levels/ [N] files src/ core/ [N] files gameplay/ [N] files ai/ [N] files networking/ [N] files ui/ [N] files docs/ architecture/ [N] ADRs production/ sprints/ [N] plans milestones/ [N] definitions tests/ [N] test files prototypes/ [N] directories该目录树与仓库 directory-structure.md 中约定的顶层布局一致src/下含 core/gameplay/ai/networking/ui/toolsproduction/下含 session-state 与 session-logs保证报告计数与工程实际目录一一对应。报告以End of Report标记收尾并注明Generated by/project-stage-detectskill。十一、报告之后的治理闭环与门禁和评审的衔接阶段分析报告本身是诊断不是裁决。一份报告产出后自然的后续是推进阶段转换→ 运行/gate-check [target-phase]获得 PASS / CONCERNS / FAIL 正式结论门禁通过并经用户确认后将新阶段名写入production/stage.txt立即更新状态行里程碑检查→ 运行/milestone-review [milestone-name|current]读取production/milestones/与production/sprints/产出 Go/No-Go 评估持续修正→ 报告中的关键缺口可由 quick-start.md 中的四条入门路径无想法 / 有想法 / 有概念无引擎 / 已有项目指引补齐。由此一份阶段分析报告从体检单升级为贯穿 Concept 到 Release 七阶段的持续治理数据源这正是 Claude Code Game Studios 以 49 个 Agent、72 项工作流技能模拟真实工作室层级协作时用于回答项目到底走到哪一步、还缺什么、下一步干什么的标准答案载体。End of Article参考文件模板 .claude/docs/templates/project-stage-report.md · 技能 .claude/skills/project-stage-detect/SKILL.md · 门禁 .claude/skills/gate-check/SKILL.md · 工作流 .claude/docs/workflow-catalog.yaml · 目录约定 .claude/docs/directory-structure.md【免费下载链接】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),仅供参考