Project Stage Analysis
【免费下载链接】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
Date: [date]Stage: [Concept/Systems Design/Technical Setup/Pre-Production/Production/Polish/Release]Stage Confidence: [PASS — clearly detected / CONCERNS — ambiguous signals / FAIL — critical gaps block progress]
Completeness Overview
- Design: [X%] ([N] docs, [gaps])
- Code: [X%] ([N] files, [systems])
- Architecture: [X%] ([N] ADRs, [gaps])
- Production: [X%] ([status])
- Tests: [X%] ([coverage estimate])
Gaps Identified
- [Gap description + clarifying question]
- [Gap description + clarifying question]
Recommended Next Steps
[Priority-ordered list based on stage and role]
完整模板还包含更丰富的章节:Executive Summary(执行摘要,含 Current Focus / Blocking Issues / Estimated Time to Next Stage)、Completeness Overview(设计/代码/架构/生产/测试/原型六个维度的完整度)、Stage Classification Rationale(阶段判定依据与进入下一阶段的必要条件清单)、Gaps Identified(按 Critical / Important / Nice-to-Have 三级分层,每项含 Impact、Question、Suggested Action 三要素)、Recommended Next Steps(按 Immediate / Short-Term / Medium-Term 排期,每项附建议技能与工作量估计 S/M/L)、Role-Specific Recommendations、Follow-Up Skills to Run,以及按目录统计文件数的 Appendix。这样一份报告既回答了"我们在哪",也回答了"缺什么、为什么缺、谁来补"。 ### 第五步:角色过滤推荐(可选) 当用户传入角色参数(如 `/project-stage-detect programmer`)时,推荐会被聚焦到该角色的视野: - **Programmer(程序员)**:聚焦架构文档、测试覆盖率、缺失 ADR、代码与文档的差异(code-to-docs gaps); - **Designer(设计师)**:聚焦 GDD 完整性、缺失的设计章节、原型文档化; - **Producer(制作人)**:聚焦冲刺计划、里程碑跟踪、路线图、跨团队协作文档; - **General(默认,无角色)**:跨领域全量缺口视图,输出最高优先级事项。 ### 第六步:写文件前征求批准 技能遵循协作协议,生成报告前必须先向用户展示摘要并请求许可,原文给出的对话模板为:I've analyzed your project. Here's what I found:
[Show summary]
Gaps identified:
- [Gap 1 + question]
- [Gap 2 + question]
Recommended next steps:
- [Priority 1]
- [Priority 2]
- [Priority 3]
May I write the full stage analysis to production/project-stage-report.md?
**在用户批准之前,不得创建文件。** 这与 CCGS 全局协作原则(详见 [COLLABORATIVE-DESIGN-PRINCIPLE.md](https://link.gitcode.com/i/898795ceca6bbe1e4e443914c0284774) 的 File Writing Protocol:"Never write files without explicit approval")完全对齐。 ## 置信度模型:HIGH / MEDIUM / LOW 的判定依据 技能的行为规范被完整记录在测试规格 [CCGS Skill Testing Framework/skills/utility/project-stage-detect.md](https://link.gitcode.com/i/3071a26eb96d966abeb482994814071f) 中。该文件将技能的置信度行为形式化为三个级别,并配套 5 个测试用例: - **HIGH**:直接读取到 `production/stage.txt`,且制品交叉验证一致; - **MEDIUM**:无 `stage.txt`,完全由制品推断; - **LOW**:`stage.txt` 与制品信号冲突(矛盾)。 五个测试用例分别覆盖: | 用例 | 场景 | 期望行为 | |------|------|----------| | Case 1 | `stage.txt` 存在且制品一致 | 直接读取阶段,报告 HIGH 置信度,交叉验证结果标注为 consistent | | Case 2 | 无 `stage.txt`,但有 GDD、epics、源码、冲刺计划 | 由制品推断 Production,置信度 MEDIUM,并建议运行 `/gate-check` 正式化阶段 | | Case 3 | 无 `stage.txt`,`design/` 与 `src/` 均为空 | 推断 Concept,置信度 MEDIUM,建议下一步运行 `/start` | | Case 4 | `stage.txt` 写 Production 但 `src/` 无源码、无冲刺 | 如实报告 Production(尊重 stage.txt),但置信度降为 LOW,显式标记矛盾并建议人工核查 | | Case 5 | 任意状态 | 全程不触发任何 director 关卡、不调用写工具、输出纯建议性质 | 测试规格还明确了技能在"不做什么"上的硬性边界: - 只读 `stage.txt`,**绝不写入**(写入是 `/gate-check` 的职责); - 当 `stage.txt` 与制品冲突时,**不静默覆盖 stage.txt 的值**,而是降置信度并提示用户人工核实; - 结束时**必须给出与当前阶段匹配的下一步建议**; - 每次输出**必须报告置信度级别**; - 全程**不产生任何 gate ID、不触发 director 代理**("No director agents are spawned at any point")。 ## 后续行动建议:把检测结果转化为执行 报告生成后,技能根据识别出的缺口给出对应的后续技能建议。原文档列出的映射关系如下: - 概念存在但没有系统索引?→ `/map-systems` 将概念拆解为系统 - 缺少设计文档?→ `/reverse-document design src/[system]` 反向文档化 - 缺少架构文档?→ `/architecture-decision` 或 `/reverse-document architecture` - 原型需要文档化?→ `/reverse-document concept prototypes/[name]` - 没有冲刺计划?→ `/sprint-plan` - 里程碑临近?→ `/milestone-review` 测试规格进一步补充了跨阶段的手递手路径:Case 1 检测出 Production 后建议 `/sprint-plan` 或 `/dev-story`;Case 3 检测出 Concept 后建议 `/start` 引导式上手;Case 2 / Case 4 检测到阶段不一致或未正式化时建议运行 `/gate-check` 完成阶段迁移裁决。这套"检测 → 建议 → 关卡确认"的闭环,正是 CCGS 七阶段管线(README 中描述的 Onboarding、Game Design、Architecture、Stories & Sprints、Reviews & Analysis、QA & Testing、Release 等完整技能族)的入口导航机制。 ## 使用方式与可验证性 **调用方式**(在 Claude Code 会话中直接输入斜杠命令): ```bash # 全项目综合分析 /project-stage-detect # 程序员视角分析 /project-stage-detect programmer # 设计师视角分析 /project-stage-detect designer【免费下载链接】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),仅供参考