OpenRig adversarial-review模板实战指南:让两个独立审查Agent互相制衡,快速提升代码质量
【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig
OpenRig 是一个多 Agent 编排框架(multi-agent harness),能把 Claude Code 和 Codex 当作同一个系统来运行。本文带你实战内置的adversarial-review 模板:两个互不通气的独立审查 Agent 加一位编排者,交叉制衡地审查代码质量。
为什么需要"对抗式"审查?单个 AI 审查者容易"自说自话"——它认可自己的判断,也认可自己的遗漏。而 OpenRig 的思路很巧妙:让两个独立的审查者各自分析同一段代码,分歧本身就是线索。正如模板的官方描述:"Disagreements surface real issues"(分歧会暴露真实问题)。
adversarial-review 团队:3个Agent的角色分工
打开模板定义文件 rig.yaml,整个团队只有 3 个成员,却分工清晰:
| 成员 | 角色 | 运行时 | 职责 |
|---|---|---|---|
lead | 编排者(orchestrator) | Claude Code | 分派任务、汇总两份审查结论 |
r1 | 独立审查者 | Claude Code | 独立完成第一轮代码审查 |
r2 | 独立审查者 | Codex | 独立完成第二轮代码审查 |
这个结构有两个值得注意的设计:
- 双运行时制衡:r1 跑在 Claude Code 上,r2 跑在 Codex 上。两个模型有各自的知识盲区和判断偏好,由不同"大脑"来审查,独立性比"同一个模型审两遍"强得多。
- 编排者只汇总不站队:
lead通过delegates_to边分别委托 r1 和 r2(见 rig.yaml 的 edges 定义),最后只负责综合两份发现,把分歧点标注出来交给你判断。
两位审查者的"行为合同"由角色指导文件定义。r1 和 r2 都引用同一个 independent-reviewer 角色说明:只做基于证据的独立评估,报告具体、有源码支撑的缺陷;"Clean review need not manufacture findings"(干净的审查不必硬造问题)。而 编排者角色说明 则要求它在波次边界发起一次审查、如实交接或挂起,"不以流程量冒充产品进展"。
如何启动 adversarial-review 团队
一键准备环境
要求 Node.js 22/24 + tmux(macOS 或 Linux)。先克隆仓库:
git clone https://gitcode.com/GitHub_Trending/op/openrig cd openrig npm install -g @openrig/cli rig setup --dry-run # 先查看安装计划再应用导入并启动模板
模板库已内置在 docs/reference/rig-spec.md 的目录表中登记,你可以在仓库的demo/参考布局(demo/rig.yaml 中同样包含 r1/r2 双审查席位的revpod)里学习实际写法。启动后打开共享 TUI 即可总览全队状态:
rig up first-project --cwd . --plan # 先预览启动计划 rig tui --shared派发一次对抗式审查
给编排者一条明确的审查指令即可(发送消息不会自动建队列,由 Agent 自行记录任务并回传 ID):
rig send lead@first-project '对 <指定文件或最近一次改动> 发起对抗式审查:分别请 r1 和 r2 独立分析,汇总两份发现并标出分歧点。' rig queue list --destination lead@first-project --limit 1000在哪里查看两个Agent的审查结论
审查进行中和结束后,有两条查看路径:
- 共享 TUI:
rig tui --shared打开总控视图,每个席位卡片上都显示运行时、模型、上下文占用和状态; - cmux 终端:在拓扑图中点开目标节点的 CMUX 按钮,直接看到该 Agent 的完整对话过程——r1 和 r2 的"各自说辞"一目了然,分歧处高亮比对。
实战要点清单
- ✅独立性是关键:r1/r2 各自独立分析,不要提前把一方的结论透露给另一方;
- ✅分歧优先看:两边结论一致的地方通常可靠,结论冲突的地方往往藏着真实缺陷;
- ✅审查要有边界:角色文件要求"明确的审查任务才进入",空闲队列不会凭空制造审查工作;
- ✅干净就承认干净:独立审查者不硬凑问题,避免噪音淹没真信号。
相关路径与延伸阅读
| 文件 | 说明 |
|---|---|
| rig.yaml | adversarial-review 模板拓扑定义 |
| agent.yaml | 独立审查者 Agent 清单 |
| role.md | 独立审查者的工作合同 |
| demo/rig.yaml | 包含 rev 审查 pod 的完整示例 rig |
| demo/README.md | North Star Demo 拓扑与运行说明 |
| README.md | 项目安装与首跑完整指南 |
从 3 个 Agent 的最小对抗式审查,到 demo 目录里 8 节点的完整生产线,OpenRig 用同一套 YAML 拓扑语言描述一切。如果你想让"AI 审 AI"成为每次合码前的标准动作,adversarial-review 模板就是最短的起点。 🚀
【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考