SuperAPI AI 工具集

openspec-verify-change

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

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

主要能力:按三个维度检查。完整性:统计任务复选框完成情况,检查规格需求覆盖;正确性:将需求映射到代码实现,检查场景是否有实现与测试覆盖;一致性:核对设计决策是否被遵循,检查代码模式是否与项目一致。问题分为 CRITICAL、WARNING、SUGGESTION 三级,并给出可操作建议。

使用方式:可选指定变更名,未提供时从对话上下文推断,模糊时必须让用户选择。相关命令:openspec list --json 获取可用变更;openspec status --change "<name>" --json 查看 schema 与工件;openspec instructions apply --change "<name>" --json 获取变更目录与 contextFiles 并读取工件。

适用场景:变更归档前的自检,尤其适合有 tasks、specs、design 完整工件的变更。

限制:仅当 tasks.md 存在时只验证任务完成;tasks 与 specs 存在时跳过设计检查;无 design.md 时跳过设计遵循检查。需注明跳过了哪些检查及原因。不确定时优先降级为 SUGGESTION 而非 CRITICAL。