SuperAPI AI 工具集

openspec-audit-change

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:对单个 OpenSpec 变更的工件做对抗式审计,在编码前发现跨工件漂移,并避免在检查未确认时声称审计通过。

主要能力:先选定变更(未指定时运行 openspec list --json 让用户选择,不猜测);用 openspec status --change "<name>" --json 与 openspec instructions apply --change "<name>" --json 收集工件路径及 .openspec.yaml,CLI 不可用时回退到 openspec/changes/<name>/ 文件系统发现;定位仓库根约定文档(AGENTS.md、CLAUDE.md、CONTRIBUTING.md)。执行 apply-ready 最低检查,构建跨变更所有权映射,再启动独立审计子代理,按 A–H 类别(实体传播、枚举词汇、语义矛盾、代码库与约定依据、命名空间与跨变更所有权、模板残留、扩展一致性、安全 lint)返回 JSON 发现。支持最多 3 轮自动修复与重审,但须用户明确确认,且不自动应用需判断的发现。最终写入 openspec/changes/<name>/audit.md 并在对话中展示。

使用方式:按技能步骤依次执行上述命令;审计子代理需隔离,仅传入变更名、绝对工件路径、所有权映射、约定文档路径、检查清单与返回 schema,禁止传入作者意图。

适用场景:OpenSpec 变更在实现前的工件一致性审查。

限制:子代理失败、超时或返回格式错误时按 CRITICAL 处理并停止;apply-ready 最低检查不通过即 CRITICAL 并提前终止;输出为建议性,不阻断 /openspec-apply-change 或 /openspec-archive-change;不得编造产品特定规则,须从项目文件加载。