用途:在 /speckit-tasks 成功生成完整 tasks.md 之后,对 spec.md、plan.md、tasks.md 进行跨产物一致性、重复、歧义与欠规范项检查,帮助在实现前发现问题。局限:必须只读运行,不得修改任何文件;仅报告问题并可提供修复建议。
主要能力:运行前置检查脚本、加载三份产物与 constitution;识别需求与成功标准、用户故事与任务覆盖映射;检测重复需求、模糊措辞(fast、scalable 等)、未解决占位符、缺失可测量结果、任务引用未定义文件;检查是否符合 constitution 的 MUST/SHOULD 原则;发现覆盖缺口、术语漂移、实体引用不一致、任务顺序矛盾与冲突需求。按 CRITICAL、HIGH、MEDIUM、LOW 分级,最多列 50 条发现,其余汇总。
使用方式:从仓库根运行 .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks 解析 FEATURE_DIR 与 AVAILABLE_DOCS,推导 SPEC、PLAN、TASKS 路径;缺少文件时中止并提示运行前置命令。若存在 .specify/extensions.yml,会检查 hooks.before_analyze 与 hooks.after_analyze;解析失败时静默跳过。enabled 显式 false 的钩子被过滤;无 condition 或为空视为可执行,非空 condition 交给 HookExecutor。命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit)。强制钩子需实际执行并等待完成后再继续。
输出:Markdown 分析报告,含发现表(ID、类别、严重级别、位置、摘要、建议)、覆盖摘要表、constitution 对齐问题、未映射任务与指标(需求数、任务数、覆盖率、歧义数、重复数、严重问题数),以及 Next Actions。严重问题存在时建议在 /speckit-implement 前解决。最后询问是否需要对前 N 个问题给出具体修复编辑建议,不会自动应用。
限制:分析范围以 constitution 为不可协商权威,冲突自动为 CRITICAL,需单独显式更新 constitution 而非在分析中弱化或重新解释。不编造缺失章节,缺失即如实报告;重跑在无变更时应产生一致 ID 与计数。