Antigravity Swarm 是怎么运作的——以及 Codex 能做什么

并行工作能"看得见",靠的不是多开几个 agent,而是一块所有人都得在上面说话的板。Codex 能搬走这套方法,搬不走这块板。

分享
Antigravity Swarm 是怎么运作的——以及 Codex 能做什么

Antigravity 的 /swarm 把多 Agent 工作变成一支看得见的团队:协调者把活拆开,worker 各自执行分到的任务,所有人都把任务和结果贴到一块共享板上,再由一个验证者检查改动。这自然引出下一个问题:Codex 的子代理能不能也这么干?

工作方法可以搬,产品接口和协同机制不一样。Codex 已经有并行子代理、自定义角色和 agent 线程;在 Codex 应用里,worktree 能把不同对话的工作目录隔开。但 Codex 没有 Swarm 那样的实时共享板,让每个成员都往同一条动态里贴东西。要在 Codex 里重建可靠的协作,靠的是任务边界、汇报格式、文件归属和验证责任——不是简单地多加几个 agent。

原文配图:华华把三条并行工作路径引向同一处校验

一览

  • Swarm 让并行工作可观察:协调者拆任务,worker 在一块共享板上汇报,验证者检查结果。
  • Codex 已经支持子代理、专门角色和 agent 线程;worktree 能在不同 Codex 对话之间隔离文件改动。
  • 两个产品的接口不一样:Codex 没有 Swarm 那种面向每个成员的实时板,所以主代理仍要汇总结果、指派验证。
  • 一个务实的 Codex 起点是并行的只读调查。只有当工作能切成互不重叠的片段时,才并行写入。

适合谁读:用 Codex 或 Antigravity 写代码的工程师;设计多 Agent 工作流、代码评审与验证步骤的技术负责人。

华华一句话 当任务彼此独立、交接可以被检查时,多 Agent 才有用;agent 的数量本身不保证质量。(华华是本站的猫,也是这套文章的插画主角。)

Swarm 是围绕显式交接构建的

按 Antigravity Swarm 官方文档,用户先描述目标以及怎么验证它。协调者随后把活拆成互不重叠的区域,并为每个 worker 写一份公开的 brief:它拥有什么、它不许碰什么、什么算完成。worker 用自己的对话和上下文干活,然后把进展、问题和结果贴到全队可见的板上。

除了 worker,协调者通常还会加一个验证者去检查 diff、跑测试,并把问题送回给对应的人修。文档给出的典型比例是每两到四个 worker 配一个验证者。协调者负责派活、判断和汇报,不自己做技术实现。它还会加一个 monitor,只在全队安静下来时才说话。空闲成员可以在板上等,而不必继续消耗 token。额度用完的 worker 会暂停,不会在额度恢复后自动重试。

这个设计把四件事放进同一条协作路径:委派、可见的交接、独立检查、停滞恢复。Swarm 的指南建议把它用于能拆到不同文件、不同包或不同调查线的宽任务;耦合很紧的难题更适合迭代式的推理与修正过程,而长周期的多阶段项目另有一套 Teamwork 工作流。

Codex 已经有什么——以及差别在哪

Codex 的子代理文档说明:主代理可以把独立工作委派给有自己上下文的子代理,再收集并汇总结果。你可以明确要求「每个问题一个 agent」,指定 Codex 等所有结果都回来,也可以定义自定义 agent(比如 explorer 或 reviewer),给它们角色说明、模型和推理档位。子代理的活动在应用、CLI 和 IDE 扩展里都看得见;CLI 里用 /subagents 在多个 agent 线程之间切换。

至于多个完整 Codex 对话并行,worktree 给每个对话一份同一个 Git 项目的独立检出,降低互相覆盖文件的概率。那是对话与工作目录之间的隔离,不等于 Swarm 那样由所有 worker 往同一个协调者的共享板上贴东西。子代理仍然使用 Codex 会话的环境和权限;在角色提示词里写「不要编辑文件」并不会造出一个只读沙箱。在客户端与账号支持的情况下,你也能给子代理单独选模型和推理档位——那是在配置角色,不会自动产生一个跨模型的验证者。

维度 Antigravity Swarm Codex 的做法
委派与角色 协调者给命名 worker 派活,brief 公开 主代理从提示词里起子代理;自定义 agent 可复用角色说明
沟通 全队在一块共享板上用提及交流 主代理派活、追问、汇总;每个子代理有自己的线程,没有等价的共享板
工作区 默认共享,可给各自的工作副本 子代理用会话环境;不同 Codex 对话可用 worktree 获得独立检出
验证 专职验证者检查 diff 并跑测试 指派 reviewer 子代理,或让主代理验证;在任务里写明验收标准
可观察性 Swarm 面板或 CLI 板显示帖子、成员状态与关系 查看子代理线程、状态与返回的摘要;呈现方式因客户端而异

这张对照描述的是两个产品文档里写的工作流。手动协调 Codex 的各个 agent,并不能提供 Swarm 的全套状态追踪;Swarm 的验证者也不能保证找出每一个缺陷。

在 Codex 里套用 Swarm 的模式

Codex 自己的建议是从读多写少的活开始:代码摸底、测试三分(triage)、日志分析、摘要归纳,只要它们能切成独立的问题就是好候选。并行写入要小心得多,因为共享文件和相互依赖的步骤会冲突。这是一段可以直接套用的提示词:

用子代理并行调查这个 bug,先不要改动任何文件。分工:1. explorer:追相关代码路径和可能的根因,给出文件路径与行号。2. tests:检查现有测试怎么覆盖这个行为,指出缺哪些用例。3. reviewer:独立质疑前两个 agent 的推理,找出反证或未经验证的假设。每个 agent 汇报结论、证据和未决问题。等所有结果回来后,再汇总成一份根因判断和最小验证计划。不要把假设当成确认的事实。

这样一来,几个 agent 同时在查不同的角度。主代理当协调者,合并发现并做决定。根因有证据支撑之后才开始实现。 如果改动能切到互不重叠的文件,给每个区域一个唯一负责人,再让另一个 agent 评审整合后的结果。对多处独立的改动来说,把 Codex 对话分散在不同 worktree 里,比让多个写手改同一份检出更容易收拾。

为了让汇报容易检查,每份 brief 都带上回报格式:拥有的范围、改动的文件、验证命令与结果、未决问题。然后要求主代理等所有工作结束,并把每份汇报与实际 diff、测试输出逐一对账。这是一条由提示词建立的约定,不是产品层面的额外保证。

验证者要做的,不只是再叫一个 agent

一个只看见实现者摘要的评审者,可能继承同一个错误假设。对重要改动,验证者应当去看真实的 diff、相关上下文和测试输出,并且手里要有足够多的原始需求,才能独立判断结果。必要时你可以给它换一个模型或换一个评审重点,但换模型不会让结果自动正确。

权限同样要小心。Codex 子代理继承父会话的沙箱与审批设置。把「不要编辑文件」写进评审者的指令,只是一个行为请求,并不会把工具权限变成只读。想通过沙箱强制只读,得先改父会话的权限设置;官方的权限指南解释了这种继承关系。

子代理各自要做自己的模型与工具工作,所以通常比单 agent 更费 token。如果一个任务只有一个明确答案、必须严格按顺序推进,或者需要多个 agent 改同一份状态,那么多出来的 agent 只增加交接成本。Codex 的文档同样建议从读多写少的并行工作起步。

华华的工程备注 一个独立评审者需要拿到证据本身;一个只读的评审者需要相应的权限设置。角色名字和提示词,替代不了这两样中的任何一样。

哪些活该放进一支小团队?

问三个问题:这项工作能拆成互相独立的子问题吗?每个结果能对着文件、测试或引用的证据检查吗?整合的成本,比按顺序做所需的时间和注意力更低吗?如果答案大体上是「能」,就从两三个读多写少的子代理起步;否则,一个主代理通常更直接。

Codex 今天就能采用 Swarm 最有价值的几条工程原则:归属清晰、重叠有限、汇报有格式、等结果、独立验证。它的协作重心仍然是一个主代理加若干 agent 线程,而不是 Antigravity Swarm 那块板的复刻。

我们的整理:对账、清单,和同一块板的两档

一、原文没写、但官方文档写了的四条。 这篇总结很准,但不是全部。官方 Swarm 文档里还有:@monitor 只在全员静默而活没干完时出声;CLI 里用 /swarm board 看板、Alt+S 重新打开;删掉一个 worker 会删掉它的工作副本,所以协调者会让它先把改动落地;worker 可以中途换模型并保留自己的对话;额度耗尽后成员保持暂停,额度刷新也不会自己重启。写实现方案时,这四条比「有块板」更影响设计(官方文档)。

二、「黑板」这个词不算错。 学术上的黑板架构有三样东西:一块共享数据结构、若干独立的知识源、一个决定下一步谁动笔的控制器。/swarm 的板对应第一样,worker 是知识源,协调者就是控制器——映射得相当整齐。差别在于:官方文档只说 shared message board,不用「黑板」这个词;而板上的消息是按提及唤醒的,不是所有 worker 都持续读板。

三、Codex 侧可以直接落地的清单。

要办的事 具体动作 做不到会怎样
划边界 每份 brief 写清「拥有什么 / 不许碰什么 / 什么算完成」 两个 agent 改同一文件,合并时靠人猜
定汇报格式 范围、改动文件、验证命令与结果、未决问题 主代理只能读摘要,等于听汇报
只读评审 改父会话权限,而不是在提示词里请求 评审 agent 顺手改了代码,评审失效
隔离写入 一处独立改动一个 worktree 同一检出多写手,冲突吞掉改动
攒结果 明确要求等全部结果再汇总 主代理拿着半份结论就开工
独立验证 验证者看 diff 与测试输出,必要时换模型 只审实现者的摘要,复制同一个错误假设

四、三个最容易踩的坑。 ① 角色提示词 ≠ 只读沙箱;② 换模型 ≠ 独立验证;③ 并行写同一份状态 = 合并炸弹。第一条官方明说了继承关系,第三条是这类系统的经典失效面——只拆角色、不拆文件,多出来的 agent 只会把冲突推迟到合并那一刻。想先弄清「什么情况下压根不该拆」,可以接着看多 Agent 值不值得拆:三种模式,和一次真实的翻车和子代理、fork 与上下文折叠。

五、同一块板的另一档:/swarm 只做片段,/teamwork 才做项目。 原文只在最后提了一句「长周期的多阶段项目另有 Teamwork 工作流」,但两者的分工值得单独摆出来。官方 Teamwork 文档的口径是:跨越多天、要重构几十个文件、或者面对开放式的数学与系统难题时用它,理由是「单个 agent 会话靠不住」。它把协作拆成三层角色加四道验证闸:

层 角色 干什么
编排 Sentinel 接过你批准的提示词,记录需求、分发任务、定期播报进展,收尾前派出 Success Auditor
编排 Project Orchestrator 把批准的目标拆成里程碑,协调并行轨道,每个里程碑之间交给一个全新的继任者,防止上下文退化
执行 Explorers / Workers 前者只读摸底、追调用链;后者带终端与文件工具,在互不重叠的轨道里实现与写单测
验证 Critic / Challenger / Auditor 独立代码评审;造对抗用例压边界与最坏输入;核对测试证据是真跑过而不是 mock 或 skip
验证 Success Auditor Sentinel 派出的最后一道,端到端跑一遍,确认能用才交付

还有一个容易被忽略的设计:Teamwork 把项目分成两段,第一段是范围访谈(先问清楚要做什么),第二段才写代码;每个项目在隔离的项目目录里跑。对照 /swarm:它面向「能按文件/包/调查线切开」的一次性任务,板是临时的,验证者按 2–4 个 worker 配一个;Teamwork 面向「要跑几天、要跨里程碑交接」的项目,验证是四道闸,且专门用「换人」来对抗上下文膨胀。两者共用同一套「板上公开+独立验证」的原型,只是把板的生命周期从一个任务拉长到一个项目。(官方 Teamwork 文档)

原版提示词(可直接粘贴)

Use subagents to investigate this bug in parallel. Do not modify any files yet.
Assignments:
1. explorer: trace the relevant code paths and likely root causes, with file paths and line numbers.
2. tests: inspect how current tests cover this behavior and identify missing cases.
3. reviewer: independently challenge the first two agents' reasoning and identify contrary evidence or unverified assumptions.
Each agent should report its conclusion, evidence, and open questions. Wait for all results, then synthesize a root-cause assessment and a minimal verification plan. Do not present a hypothesis as a confirmed fact.

Sources

  • 原文:Bloss0m《How Antigravity Swarm Works—and What Codex Can Do》(AI Engineering,2026-11-19,7 分钟阅读)https://www.bloss0m.com/en/blog/156-antigravity-swarm-codex-parallel-agents/
  • 原文引用的一手材料:Google Antigravity 官方 Swarm(/swarm)文档、OpenAI Codex Subagents 文档、OpenAI Codex Worktrees 文档
  • 原文配图:Bloss0m 站内插画(猫「华华」与三条并行路径汇入一处校验),封面同源,已按 800px 宽转存本站

本文由 Software 2.0 编译整理,转载请注明出处;「我们的整理」部分为本站补充,未对两个产品的多 Agent 行为做本地实测。

这是「Agent / MCP」专题的一部分。完整地图见:Agent / MCP / 自动化完全指南