SuperAPI AI 工具集

review-fix-signoff-loop

智能体与模型

查看项目

更新于 10-15 20:11

技能介绍

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

主要能力与流程:先做确定性预检(确认仓库根、必需规格、写入范围、PR 评论凭据、是否包含提交/推送/PR 创建),跨仓库或包发布工作先写范围矩阵;探测后续步骤使用的 CLI,例如 Codex 需运行 codex exec --ephemeral --json --sandbox read-only -m <supported-model> 验证,预检证据写入 .workflow-artifacts/<workflow>/iteration-N/preflight.md。实现阶段用 Codex worker 按不重叠的所有权区域拆分后端、前端、桌面、测试、文档或基础设施,各自写持久摘要。验证前增加确定性 reconcile 门,检查必需文件、API/UI/运行时表面、迁移、生成产物与未跟踪文件(git status --short -- <paths>),多提供方变更按范围矩阵逐项分类。验证采用 capture -> fix -> rerun,红输出交给修复智能体,failOnError: false。签核评审每轮使用全新上下文(新工作流运行、新智能体名),Claude 与 Codex 独立评审同一验证后仓库状态,只有双签核且最终确定性验收为绿才退出;否则运行 Codex 修复并开启新一轮。最终写 SIGNOFF.md 并发布到 PR。

判定契约:VERDICT: COMPREHENSIVELY_SATISFIED | FINDINGS | BLOCKED,通过时需 why_passed、end_to_end_wiring_verified、deterministic_evidence、remaining_risks,跨仓库/提供方/包工作还需 scope_matrix_verified;FINDINGS 需 finding_id、severity、file、issue、fix_required、test_required、evidence。

限制:真正外部阻塞时写 BLOCKED_NO_COMMIT.md,不提交、不推送、不发成功评论;避免复用评审上下文、无理由通过、把绿测试当签核、首个红门即硬失败、双签核前发 PR 评论、忘记统计迭代次数。具体模型名、凭据与平台细节以实际环境为准。