用途:在 /speckit-tasks 成功生成完整 tasks.md 之后,对 spec.md、plan.md、tasks.md 三个核心产物做非破坏性的跨产物一致性与质量分析,在实现前发现不一致、重复、歧义与未充分说明的问题。
主要能力:检测需求重复、模糊措辞(如 fast、scalable、secure 等缺少可度量标准)、未解决占位符、说明不足、与项目宪法(.specify/memory/constitution.md)的冲突、覆盖缺口(需求无对应任务、任务无对应需求)、术语漂移、数据实体缺失、任务顺序矛盾与需求冲突。按 CRITICAL、HIGH、MEDIUM、LOW 分级,输出 Markdown 分析报告,含发现表格、覆盖汇总表、宪法对齐问题、未映射任务与指标(需求总数、任务总数、覆盖率、歧义数、重复数、严重问题数),并给出后续操作建议。
使用方式:从仓库根目录运行 .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;YAML 无法解析时静默跳过;enabled 为 false 的钩子被过滤;无 condition 或为空视为可执行,非空 condition 交由 HookExecutor 处理;命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit)。
限制:必须在 tasks.md 完整生成后运行;宪法冲突自动视为 CRITICAL,需调整 spec、plan 或 tasks,而非弱化或忽略原则;原则本身变更须在 /speckit-analyze 之外单独显式更新宪法;发现总数上限 50 条,超出部分汇总;不得臆造缺失章节,缺失应如实报告;无问题时输出成功报告与覆盖统计。具体安装方式与收费信息暂未提供。