SuperAPI AI 工具集

verify-changes

测试与质量

查看项目

更新于 10-16 02:32

技能介绍

用途:verify-changes 用于从仓库自身的命令入口运行确定性检查,适用于用户要求验证分支、运行仓库检查,或证明构建与测试通过。它只执行检查并采集证据,不修复代码。

主要能力:读取 references/command-discovery.md,优先使用仓库命名脚本和只读 CI 配置,记录检测到的构建系统与命令来源到 commandSurface。基准解析顺序为 origin/HEAD、代码托管元数据、main,并包含当前工作区的暂存与未暂存改动。支持原生受影响包范围;没有时从仓库命令中识别安全的包或文件检查,必要时使用全仓库检查,并在缺少原生范围时记录 workspacesScoped.supported: false。

使用方式:支持手动模式与 pipeline 模式(mode:pipeline)。手动模式遵循用户指定的检查集;显式要求全部检查时运行所有必需门禁,否则选择受影响的检查与适用门禁。pipeline 模式使用调用方范围与验收契约,返回 references/checks-schema.json 的结构化结果和一个结论。调用方提供快照时,仅通过 shared/scripts/review_evidence.py 执行其声明的检查,例如:python3 "$SHARED_DIR/scripts/review_evidence.py" select-checks --snapshot "$TARGET_SNAPSHOT" --from-snapshot "$PRIOR_SNAPSHOT" --checks "$RUN_DIR/prior-checks.json" --fresh tests。选择器返回 run、reuse、transfer 决策;transfer 需显式 transfer-check 评估当前运行时、依赖、外部状态与基准交互证据。fresh: true 的检查始终执行且不可转移。

限制:只有实际捕获的命令结果才算证据,不得声称未运行的检查已运行。不得修改测试、源码、锁文件或 CI 配置以获取通过。不得 stash、reset 或 clean 工作树。默认每项检查超时 15 分钟,除非调用方另设上限。结论为 PASS、FAIL 或 SKIP;部分检查集不能证明整个仓库通过。长输出保留在证据目录,报告只保留决定性尾部。