用途:扫描项目现状,判断所处开发阶段(Concept、Systems Design、Technical Setup、Pre-Production、Production、Polish、Release),统计各类产物的完整度、识别缺口并推荐后续步骤。
主要能力:先运行确定性检查脚本(bash .claude/scripts/artifact-check.sh,需在项目根目录按原样执行),报告每个阶段的产物为 PRESENT/ABSENT/SHORT/PATTERN_MISS/NO_CHECK;再人工分析脚本无法覆盖的内容,如设计文档(design/gdd、design/narrative、design/levels)、代码根目录源文件数量与主要系统、production 下的冲刺/里程碑/路线图、prototypes、docs/architecture 下的 ADR、tests 测试文件与覆盖率粗估。随后依据规则自动判定阶段,并与 project.yaml 的 project.stage 或 production/stage.txt 配置值对比,两者不一致时明确说明。
使用方式:调用 /project-stage-detect,可加角色参数如 programmer、designer,按角色过滤建议;生成报告前先展示摘要、缺口与问题,等待用户批准后才写入 production/project-stage-report.md。
适用场景:接手已有项目、加入陌生代码库、里程碑前检查缺失项、确认项目所处阶段。
限制:需遵循已解析的 workflow 层级(full/standard/minimal)与 automation 模式,层级决定哪些缺失算缺口;代码根目录未解析时相关检查标记 NOT ASSESSED。缺失事实暂未提供。