SuperAPI AI 工具集

openspec-verify-change

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:在 OpenSpec 变更实现完成后、归档之前,验证实现是否与变更产物(任务、规格、设计)一致,并给出可操作、带文件引用的改进建议。

主要能力:

  1. 完整性检查:解析各 contextFiles.tasks 文件中的 - [ ]/- [x],未完成任务标记为 CRITICAL;对 delta 规格中的每条需求在代码库中搜索实现证据,疑似未实现的需求标记为 CRITICAL。
  2. 正确性检查:对每条需求搜索实现证据并判断是否符合意图,偏离记为 WARNING;对每个场景检查代码与测试覆盖,未覆盖记为 WARNING。
  3. 一致性检查:若存在 design.md,提取关键决策并核对实现是否遵循,矛盾记为 WARNING;无 design.md 则跳过并说明。同时对照项目命名、结构、风格约定,显著偏离记为 SUGGESTION。

使用方式:先选择变更,未指定时运行 openspec list --json,展示含实现任务的变更,将任务未完成的标记为“(In Progress)”交由用户选择,不猜测。随后检查 schema:openspec status --change "<name>" --json。加载产物:openspec instructions apply --change "<name>" --json 返回 contextFiles(产物 ID 到路径的映射),读取所有可用内容。最后生成报告:完整性/正确性/一致性评分卡,问题按 CRITICAL/WARNING/SUGGESTION 分组,每条附具体建议与 file.ts:123 式引用,并给出最终结论(存在 X 个严重问题,归档前需修复/无严重问题,有 Y 个警告待考虑,可归档/全部检查通过,可归档)。

适用场景:OpenSpec 工作流中实现完成后的归档前质量把关。

限制:完整性与正确性依赖关键词搜索与合理推断,并非确定性结论;不确定时优先降级为 SUGGESTION 而非 WARNING、WARNING 而非 CRITICAL。每条问题必须给出具体可操作建议。优雅降级:仅有 tasks.md 时只验证任务完成;有任务与规格时跳过设计一致性;产物齐全时验证全部三个维度,并始终说明跳过了哪些检查及原因。完成条件为三个维度均已评估(或已说明跳过原因),每条问题都有严重级别、文件引用与可操作建议,且最终结论明确变更是否可归档。