用途:在归档变更前,验证实现是否与变更工件(specs、tasks、design)匹配,确认实现完整、正确且一致。
主要能力:从三个维度检查——完整性(任务完成度与规格覆盖)、正确性(需求实现映射与场景覆盖)、一致性(设计遵循与代码模式一致)。问题按 CRITICAL、WARNING、SUGGESTION 分级,并给出可操作建议。
使用方式:可选指定变更名;若省略则从对话上下文推断,模糊时必须提示选择。先运行 openspec list --json 获取可用变更,用 AskUserQuestion 让用户选择,不猜测或自动选择。再用 openspec status --change "<name>" --json 了解 schema 与工件,用 openspec instructions apply --change "<name>" --json 获取变更目录与上下文文件并读取工件。随后按完整性、正确性、一致性逐项验证,生成含摘要记分卡与分级问题列表的报告。
适用场景:变更归档前的实现核对,尤其适合 spec-driven 工作流。
限制:若仅有 tasks.md 则只验证任务完成度;有 tasks 与 specs 时跳过设计检查;工件齐全才验证全部三维度,并需注明跳过的检查及原因。不确定时优先降级为 SUGGESTION 而非 WARNING/CRITICAL。