SuperAPI AI 工具集

openspec-verify-change

通用与其它

查看项目

更新于 10-16 01:24

技能介绍

用途:在归档前验证实现与变更制品(规格 specs、任务 tasks、设计 design)是否匹配,覆盖完整性、正确性、连贯性三个维度。

主要能力: 完整性:读取任务文件中的 - [ ] 与 - [x] 复选框,统计完成度;对未完成任务标记 CRITICAL;从 delta 规格中提取需求(### Requirement:),检索代码库判断是否已实现。 正确性:为每条需求查找实现证据(文件路径与行范围),检测实现与规格意图的偏差(WARNING);针对场景(#### Scenario:)检查代码条件处理与测试覆盖,未覆盖则报 WARNING。 连贯性:若存在 design,提取关键决策并核对实现是否遵循,冲突报 WARNING;检查新代码与项目命名、目录结构、编码风格的一致性,偏差报 SUGGESTION。

使用方式:可选指定变更名;省略时从对话上下文推断,含义模糊时必须提示用户选择,不得猜测或自动选择。常用命令:openspec list --json(列出变更,仅显示含实现任务的变更,标记未完成任务为 In Progress)、openspec status --change "<name>" --json(查看 schemaName、路径与制品情况)、openspec instructions apply --change "<name>" --json(获取变更目录与 contextFiles 后读取全部制品)。若使用已注册的 store,先运行 openspec store list --json 获取 id,再在读写规格与变更的命令上附加 --store <id>;命令提示中携带该标志时需在后续命令保留,其他命令不接受该标志。未指定 store 时作用于最近的本地 openspec/ 根目录。

输出:Markdown 报告,含汇总记分卡表格(各维度状态)、按 CRITICAL/WARNING/SUGGESTION 分组的问题列表、形如 file.ts:123 的代码引用,以及具体可执行的建议,不使用模糊表述。最终评估分为存在 CRITICAL、仅有 WARNING、全部通过三种结论。

限制与降级:不确定时优先降级为 SUGGESTION 而非 WARNING、WARNING 而非 CRITICAL;仅存在 tasks.md 时只校验任务完成,仅存在 tasks 与 specs 时跳过设计校验,并需注明跳过的检查及原因。其它细节暂未提供。