> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# Antigravity Swarm 是怎么运作的——以及 Codex 能做什么
- URL: https://www.hubwiz.com/blog/antigravity-swarm-vs-codex-subagents/
- Published: 2026-11-22T17:05:37.000Z
- Updated: 2026-11-22T17:06:51.000Z
- Description: 并行工作能"看得见"，靠的不是多开几个 agent，而是一块所有人都得在上面说话的板。Codex 能搬走这套方法，搬不走这块板。
- Author: admin
- Tags: AI 编程, 多 Agent, 子代理, Antigravity, Codex

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

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

![原文配图：华华把三条并行工作路径引向同一处校验](https://www.hubwiz.com/blog/content/images/2026/11/img_64e36111d980aa2ba308dac70c8a61b2-800.jpg)

## 一览

- 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 可以中途换模型并保留自己的对话；额度耗尽后成员保持暂停，**额度刷新也不会自己重启**。写实现方案时，这四条比「有块板」更影响设计（[官方文档](https://antigravity.google/docs/swarm?ref=hubwiz.com)）。

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

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

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

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

**五、同一块板的另一档：`/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 文档](https://antigravity.google/docs/teamwork?ref=hubwiz.com)）

**原版提示词（可直接粘贴）**

```
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/](https://www.bloss0m.com/en/blog/156-antigravity-swarm-codex-parallel-agents/?ref=hubwiz.com)
- 原文引用的一手材料：Google Antigravity 官方 Swarm（/swarm）文档、OpenAI Codex Subagents 文档、OpenAI Codex Worktrees 文档
- 原文配图：Bloss0m 站内插画（猫「华华」与三条并行路径汇入一处校验），封面同源，已按 800px 宽转存本站

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

> **这是「Agent / MCP」专题的一部分。**完整地图见：[Agent / MCP / 自动化完全指南](https://www.hubwiz.com/blog/agent-stack/)