SuperAPI AI 工具集

review-fix-signoff-loop

智能体与模型

查看项目

更新于 10-15 16:43

技能介绍

用途:适用于高风险实现工作流,普通的“实现、测试、审查一次”流程不够用,需要持续修复与复审,直到独立签核智能体一致确认规格已端到端接通。可与 writing-agent-relay-workflows(SDK 语法)和 relay-80-100-workflow(确定性验证门)配合使用。

主要能力与流程:

  1. 预检:在智能体启动前运行确定性预检,确认仓库根目录、所需规格、声明的写入范围、PR 评论所需凭据,以及提交/推送/创建 PR 是否在范围内。跨仓库或包发布工作需先写范围矩阵。探测后续步骤使用的 CLI,例如 Codex 需运行 codex exec --ephemeral --json --sandbox read-only -m <supported-model> 验证,失败则提前报错。预检证据写入 .workflow-artifacts/<workflow>/iteration-N/preflight.md。
  2. 实现:使用 Codex worker 做代码变更,按后端、前端、桌面、测试、文档或基础设施划分互不重叠的所有权区域,每个 worker 写持久摘要。
  3. 对账:加入确定性实现对账门,检查必需文件、预期 API/UI/运行时表面、迁移、生成产物和未跟踪文件(git status --short -- <paths>)。多提供方变更需按范围矩阵分类。包发布流程需对账生产者与消费者状态(npm view <pkg> version、清单、锁文件、npm ls <pkg>)。CI 失败需映射到精确本地命令,使用 failOnError: false 并将输出路由给修复负责人。
  4. 可修复验证:对类型检查、定向测试、集成/E2E 测试和回归检查采用捕获→修复→重跑。红色验证输出是修复输入,不是立即失败。仅真正外部阻塞才写 BLOCKED_NO_COMMIT.md。
  5. 全新上下文签核审查:每轮迭代启动新工作流运行、新智能体名称或新上下文;Claude 与 Codex 独立审查同一验证后仓库状态;审查者须阅读规格、diff、验证日志、产物和实际文件。仅双签核才可退出,且最终确定性验收为绿。
  6. 最终报告:写 SIGNOFF.md,含迭代次数、验证证据、双方理由、剩余风险、产物路径和最终范围矩阵,并发布到 PR(PR 号优先取环境变量,其次 gh pr view)。

判定契约:使用严格文本契约,VERDICT 为 COMPREHENSIVELY_SATISFIED | FINDINGS | BLOCKED,并附 why_passed、end_to_end_wiring_verified、deterministic_evidence、scope_matrix_verified、remaining_risks 或 finding_id、severity、file、issue、fix_required、test_required、evidence 等字段。

范围矩阵:跨仓库、包、提供方或 CI 门的工作,在首次修复前创建机器可读与人类可读矩阵,每轮更新,列含 repo、branch、PR、package/provider/surface、expected change、producer version、consumer version、files expected、gates required、status、evidence、owner。

用法要点:外层循环每轮启动新 Agent Relay 工作流运行,清除恢复状态,双签核后写并发布报告。Codex 修复步骤建议使用 preset: 'worker'、retries: 2,并以 file_exists 验证其持久报告,不依赖交互式 PTY 空闲检测或 /exit。PR 签核评论示例:gh pr comment "$PR_NUMBER" --body-file .workflow-artifacts/my-workflow/pr-comment.md。

常见错误:每轮复用同一审查者上下文;允许审查者无理由写 NO_ISSUES_FOUND;把绿色测试当作签核;首个红色验证门直接硬失败;双方未就同一最终状态达成一致就发 PR 评论;忘记统计迭代次数。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;实际可用性取决于 Agent Relay、Codex、Claude 等环境与凭据配置。