用途:在任务生成完成后、进入实现之前,对 spec.md、plan.md、tasks.md 做非破坏性的跨文档一致性与质量分析,提前发现不一致、重复、歧义与欠规范项。
主要能力:检测重复需求、模糊形容词与未解决占位符、缺少可衡量结果的欠规范项、与项目宪法(/memory/constitution.md)MUST 原则的冲突、需求与任务之间的覆盖缺口、术语漂移与实体/需求冲突;按 CRITICAL、HIGH、MEDIUM、LOW 分级,输出含 ID、类别、严重度、位置、摘要与建议的 Markdown 报告,并给出覆盖率统计、未映射任务与后续动作建议。
使用方式:仅在 tasks 命令成功产出完整 tasks.md 后运行。执行时先从仓库根运行 {SCRIPT} 解析 FEATURE_DIR 与 AVAILABLE_DOCS,推导 SPEC、PLAN、TASKS 路径;任一必需文件缺失则报错并提示先运行前置命令。随后按渐进披露加载最小必要上下文,构建需求清单、用户故事清单、任务覆盖映射与宪法规则集,再执行检测。若项目根存在 .specify/extensions.yml,会检查 hooks.before_analyze 与 hooks.after_analyze;enabled 为 false 的跳过,无 condition 的视为可执行,带非空 condition 的留给 HookExecutor 处理。
适用场景:Spec Kit 风格的需求—计划—任务工作流中,实现前的质量门禁与评审准备。
限制:严格只读,不修改文件;宪法冲突一律视为 CRITICAL,需调整 spec、plan 或 tasks,而非弱化原则;发现项上限 50 条,超出部分汇总;不臆造缺失章节;修复建议需用户明确同意后才可手动执行。具体脚本名、命令标识与安装方式暂未提供。