SuperAPI AI 工具集

openspec-verify-change

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:在归档变更前,验证实现是否与变更工件(specs、tasks、design)匹配,判断实现是否完整、正确且前后一致。

主要能力:按三个维度检查。完整性:统计 tasks 中复选框完成情况,并检查 delta specs 中每个 Requirement 是否在代码库中有实现迹象。正确性:将需求映射到实现证据(文件路径与行范围),检查每个 Scenario 是否被代码或测试覆盖。一致性:核对实现是否遵循 design 中的关键决策,并检查新代码与项目命名、目录结构、编码风格是否一致。

使用方式:可选指定变更名;未提供时先运行 openspec list --json 获取可用变更,并用 AskUserQuestion 让用户选择,不得猜测或自动选择。随后运行 openspec status --change "<name>" --json 了解 schemaName、路径与工件情况;若 actionContext.mode 为 workspace-planning,则说明不支持完整工作区实现验证并停止。再运行 openspec instructions apply --change "<name>" --json 获取 contextFiles 并读取全部可用工件。最后按完整性、正确性、一致性生成报告,含汇总记分卡、按优先级分组的问题列表(CRITICAL/WARNING/SUGGESTION)及带文件行号的具体建议。

适用场景:变更归档前的实现校验,尤其适合已有 tasks、specs、design 工件的 spec-driven 工作流。

限制:仅当 tasks.md 存在时只验证任务完成度;tasks 与 specs 存在时跳过设计检查;无 design.md 时跳过设计遵循检查并注明。不确定时优先降级为 SUGGESTION 而非 WARNING 或 CRITICAL。不支持工作区规划模式下的完整实现验证,也不应推断仓库本地实现归属或编辑关联仓库。输出为 markdown,含汇总表格与分组问题列表,代码引用格式为 file.ts:123。