SuperAPI AI 工具集

openspec-verify-change

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

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

主要能力:检查任务完成与规格覆盖(完整性)、需求实现与场景覆盖(正确性)、设计遵循与代码模式一致性(一致性);按 CRITICAL、WARNING、SUGGESTION 分级给出可操作建议,并输出含汇总记分卡的 Markdown 报告。

使用方式:可选指定变更名,未指定时从对话上下文推断、仅一个活跃变更时自动选中,含糊时运行 openspec list --json 让用户选择。用 openspec status --change "<name>" --json 查看所用 schema 与工件,再用 openspec instructions apply --change "<name>" --json 获取变更目录与 contextFiles 并读取工件。若使用注册存储,先运行 openspec store list --json 获取 id,并给读写 specs/changes 的命令加 --store <id>(对同一工作流持续生效);其余命令不接受该标志。

适用场景:OpenSpec 变更归档前的验证;仅有 tasks.md 时只验任务完成,有 tasks+specs 时验完整性与正确性,工件齐全时验三个维度。

限制:正确性检查依赖关键词搜索与合理推断,不强求完全确定;不确定时优先降级为 SUGGESTION。设计遵循检查仅在存在 design.md 时进行,否则跳过并说明原因。报告中每条问题需给出具体建议与文件/行引用(如 file.ts:123),避免“考虑审查”类模糊建议。