用途:自动诊断当前项目处于哪种配置状态,并推荐下一步应执行的命令序列,帮助用户完成项目接入(onboarding)。全程只读,不修改任何文件,也不向用户提问,检测完全基于真实文件的存在与否。
主要能力:按严格优先级执行 5 项检查(另有非阻塞的检查 4 与仅全局配置模式下的检查 7)。检查 1 读取 .claude/CLAUDE.md(也接受项目根目录的 CLAUDE.md),缺失则判定为 Case 1 全新项目,推荐 /project-setup、/memory-update、/project-audit、/project-fix。检查 2 检测 Engram MCP 是否可达(调用 mem_context),不可达则为 Case 2,推荐先确保 Engram MCP 运行并配置,再执行 /project-audit、/project-fix、/memory-init、/project-audit。检查 3 统计 ai-context/ 中内容超过 10 行的文件数(预期 stack.md、architecture.md、conventions.md、known-issues.md、changelog-ai.md),少于 3 个则为 Case 3,推荐 /memory-update、/project-audit、/project-fix。检查 4 非阻塞:若 .claude/skills/ 存在且有子目录,记录本地技能警告并继续。检查 5 在 Engram 中搜索 sdd/ 相关变更,若某变更缺少 tasks 或 verify-report 工件则为 Case 5,推荐 /sdd-status,并按情况使用 /sdd-apply、/sdd-verify、/sdd-archive,最后 /project-audit。全部通过则为 Case 6 完全配置,按变更复杂度推荐 /sdd-propose、/sdd-apply 或先 /sdd-explore。检查 7 仅在项目根存在 install.sh 与 skills/ 时追加提示,建议重跑 install.sh 检查安装漂移,不改变情形判定。
使用方式:通过触发词调用,输出结构化诊断,包含检测结果、警告与推荐命令序列,并附 Notes 指向 ai-context/scenarios.md 中对应情形的失败模式与恢复步骤。
限制:不提问、不做文件系统更改、不输出原始目录列表或堆栈;优先级严格,一旦在某检查判定情形,不再分配更低优先级情形(检查 4 的本地技能标记例外,始终作为警告呈现)。若 ai-context/onboarding.md、scenarios.md、quick-reference.md 的 Last verified 超过 90 天,会追加过期警告。