用途:在归档变更前,验证实现是否与变更工件(specs、tasks、design)匹配,确认实现完整、正确且前后一致。
主要能力:从完整性、正确性、一致性三个维度检查。完整性核对 tasks.md 复选框完成情况与规格需求覆盖;正确性将需求映射到代码实现并检查场景覆盖;一致性核对是否遵循 design.md 的决策及项目代码模式。问题按 CRITICAL、WARNING、SUGGESTION 分级,每条附具体可执行建议。
使用方式:可选指定变更名,未提供时从对话上下文推断,模糊则必须让用户选择。相关命令:npx openspec list --json 列出可用变更;npx openspec status --change "<name>" --json 查看 schema 与工件;npx openspec instructions apply --change "<name>" --json 获取变更目录与上下文文件。随后读取工件、初始化报告结构并逐项验证,最后输出含汇总记分卡与分级问题列表的 Markdown 报告。
适用场景:变更归档前的实现核对,尤其适合采用 spec-driven 工作流的项目。
限制:不猜测或自动选择变更,必须由用户选择;正确性检查依赖关键词搜索与合理推断,不要求完全确定;不确定时优先降级为 SUGGESTION 而非 WARNING/CRITICAL;工件不全时优雅降级(仅有 tasks.md 只查任务完成,tasks+specs 跳过设计检查),并说明跳过了哪些检查及原因。其他细节暂未提供。