用途:通过分析项目的文件结构、配置文件、文档和测试覆盖,判断软件项目处于 new、early、mid 还是 mature 阶段,并据此路由到合适的入职或初始化工作流。适用于接手陌生仓库、将新项目接入 agent-studio、决定采用 bootstrap/enhance/optimize 哪类流程,或在会话开始时评估项目健康状况。
主要能力:脚本检查源目录、测试目录、CI/CD 配置、package.json/pyproject.toml、README、lint 配置、文档目录、CHANGELOG、依赖锁定等指标并加权评分;按分数映射阶段(0–2 new、3–5 early、6–7 mid、8–9 mature);输出包含 stage、confidence、indicators、recommendations 的 JSON;按阶段推荐后续技能(new 用 project-onboarding,其余用 gap-detection,mid 再加 proactive-audit);生成检测报告到 .claude/context/reports/backend/project-stage-report-YYYY-MM-DD.md。
使用方式:调用 Skill({ skill: 'project-stage-detection' }); 执行检测命令 node .claude/skills/project-stage-detection/scripts/main.cjs --dir <project_root>,可用 --json 获取结构化输出。检测前可读取 .claude/context/memory/learnings.md 中 7 天内的缓存结果,完成后追加记录。
限制与注意:不要硬编码阶段阈值,必须由指标计算;无测试的项目不得报告为 mature;只扫描项目根目录,不扫描 .claude/ 子目录;缺失文件需用 existsSync 优雅处理而非阻塞。输入输出契约见 schemas/input.schema.json 与 schemas/output.schema.json。