SuperAPI AI 工具集

openspec-verify-change

编程与开发

查看项目

更新于 10-22 09:57

技能介绍

用途:该技能用于在归档一次变更前,验证代码实现是否与变更工件(specs、tasks、design)匹配,帮助确认实现完整、正确且前后一致。

主要能力:

  • 变更选择:若未提供变更名,可运行 openspec list --json 获取可用变更,通过交互让用户选择,不会猜测或自动选择变更。
  • 状态与工件加载:通过 openspec status 和 openspec instructions apply 获取变更使用的 schema、变更目录及上下文文件,并读取其中的 artifacts。
  • 完整性检查:解析 tasks.md 中的复选框统计完成情况,对未完成任务标记 CRITICAL;从 delta specs 提取需求(### Requirement:),在代码库中搜索相关实现证据,缺失时给出 CRITICAL。
  • 正确性检查:为每条需求查找实现位置并与需求意图比对,偏差标为 WARNING;对场景(#### Scenario:)检查代码处理与测试覆盖,未覆盖标为 WARNING。
  • 一致性检查:若存在 design.md,提取关键决策并核对实现是否遵循,矛盾标为 WARNING;检查新代码在文件命名、目录结构、编码风格上是否符合项目模式,明显偏差标为 SUGGESTION。
  • 报告生成:输出带汇总记分卡的 Markdown 报告,按 CRITICAL/WARNING/SUGGESTION 分组列出问题,每条给出具体建议和文件/行号引用,并给出最终归档评估。

使用方式:以技能形式调用,可选传入变更名;技能按上述步骤执行 openspec 命令并读取工件文件,最终输出验证报告。

适用场景:在 OpenSpec 工作流中准备归档变更之前的实现核对,适用于采用任务清单、规格增量与设计文档管理需求的开发项目。

限制:检查依赖关键词搜索与合理推断,不要求完全确定;不确定时优先降级为 SUGGESTION 而非 WARNING。若仅有 tasks.md,则只验证任务完成情况;若 tasks 与 specs 存在但无 design.md,则跳过设计核对并注明;技能会注明跳过的检查及原因。