SuperAPI AI 工具集

improvement-gate

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:在自动改进流程中验证 executor 产出的变更是否应保留,管理人工审核队列,并生成可审计的 JSON receipt。

主要能力:6 层门禁按 Schema→Compile→Lint→Regression→Review→HumanReview 固定顺序执行。Schema、Compile、Regression、Review 为阻塞层,失败即 reject;Lint 与 HumanReview 为建议层,失败仅告警不阻塞。任一阻塞层失败时立即 reject,后续层不再执行;全部阻塞层通过但触发 HumanReview 时决策为 pending。

使用方式:gate.py 为核心入口,接收 ranking 与 execution artifact 并输出 receipt;review.py 管理人工审核队列,支持 list/complete 子命令,--decision 可选 approve/reject/defer。命令示例:python3 scripts/gate.py --ranking ranking.json --execution execution.json --output receipt.json;python3 scripts/review.py --list --state-root /path/to/state;python3 scripts/review.py --complete REVIEW_ID --decision approve --reason "LGTM"。可用 --skip-layers 跳过无关层,用 --batch 批量验证,用 --strict 将建议层也视为阻塞。

适用场景:orchestrator pipeline 第 5 阶段自动调用、CI/CD 批量验证、独立对任意变更做 6 层检查、需要审计记录时。

限制:不做评分(用 improvement-discriminator)、不修改文件(用 improvement-executor)、不做结构分析(用 improvement-learner)、不生成候选(用 improvement-generator);不能替代单元测试,不能当全量 linter 使用;需要完整 execution artifact,候选未通过 discriminator 评分时不应跳步调用。