03 · Editor 与 Agent Manager 怎么分工
理解 Antigravity 的两种核心界面：Editor 适合同步局部协作，Agent Manager 适合异步任务编排与 artifacts 验收。
Antigravity 有两个核心界面，不是为了好看，而是为了把两种工作方式分开：你在代码现场和 agent 同步协作，还是你把一个任务交给 agent 并在 Agent Manager 里看计划、状态和 artifacts。
一句话判断：你知道要改哪一段，就用 Editor；你只知道目标和验收标准，需要 agent 自己计划、执行、验证，就用 Agent Manager。
1. 两种界面，两种角色
| 界面 | 你在做什么 | agent 在做什么 |
|---|---|---|
| Editor | 和 agent 同步协作，局部修改 | 补全、解释、改小块代码 |
| Agent Manager | 定义目标、审计划、看 artifacts | 计划、执行、验证、交付证据 |
官方 Editor 文档说，Editor 是基于 VS Code codebase 的 AI-powered IDE；官方 Agent Manager 文档说，它提供更高层的视角，让你跨多个 workspace 同时监督几十个 agent，并主要通过 agent 与代码库交互。两句话合在一起，就是这套产品的分工。
Editor 的角色更像 pair programming。Agent Manager 的角色更像任务调度和成果审查。
2. 分工图
flowchart TD
Task["任务"] --> KnowFile{"知道要改哪个文件/函数?"}
KnowFile -->|是| Editor["用 Editor"]
KnowFile -->|否| NeedProof{"需要 browser/test/artifact 验收?"}
NeedProof -->|是| Manager["用 Agent Manager"]
NeedProof -->|否| Scope{"范围很小?"}
Scope -->|是| Editor
Scope -->|否| Manager
Editor --> Diff["局部 diff review"]
Manager --> Artifacts["Plan / screenshot / walkthrough"]3. Editor 的甜区
Editor 适合你能直接看懂上下文的任务。官方文档也强调，在这里你仍然可以打开文件、编辑文件、使用 Tab（智能补全）、Command（行内自然语言指令）、Agent side panel（编辑器侧栏 agent）、Review Changes（改动审查）和 source control（版本控制）。
- 改一个函数。
- 解释一段报错。
- 让它重写一小段代码。
- 从 Problems 面板修一个类型错误。
- 把 terminal 输出转成排障建议。
- 看 staged / unstaged diff。
- 处理一个 workspace 内的局部修复。
这类任务不要过度流程化。你已经站在代码旁边，就让 agent 做局部辅助。
4. Agent Manager 的甜区
Agent Manager 适合有目标但路径不确定的任务：
- 修一个 UI bug 并截图验证。
- 复现 issue、写测试、修复、跑测试。
- 把文档目录重组并生成 walkthrough。
- 让多个 workspace 分别做不同调研或修复。
- 后台跑依赖升级、测试补齐、排障。
这类任务如果放在 Editor side panel 里，容易变成长聊天；放在 Agent Manager 里，它可以形成 conversation、task、artifact 和 review 状态。
官方 Workspaces 文档还说明，在 Agent Manager 中可以同时打开多个 workspace，并通过左侧边栏在 workspace 和 conversation 之间切换。这说明 Agent Manager 不是“更大的聊天窗口”，而是多任务管理面。
5. 任务写法差异
Editor prompt 可以短：
解释这个函数为什么会重复请求，并给一个最小修复。Agent Manager prompt 要完整：
修复设置页保存按钮无响应的问题。
要求：
1. 先输出 implementation plan，等我确认。
2. 修改范围限制在 settings 页面和相关测试。
3. 修复后启动本地服务并用浏览器验证保存流程。
4. 交付 diff、screenshot 和 walkthrough。
5. 不要修改无关样式和配置。6. 快捷切换和实际动作
官方 Getting Started 和 Agent Manager 文档给出的切换方式：
- Editor 到 Agent Manager：顶部按钮或
Cmd + E（Mac）/Ctrl + E（Windows）。 - Agent Manager 到 Editor：workspace 下拉菜单里的 Focus Editor，或 Open Editor。
- Agent Manager 内：通过 workspace 和 conversation 切换不同任务。
实战里可以这样判断：
我要看文件、diff、终端 -> Editor
我要看 agent 是否还在跑 -> Agent Manager
我要评论 implementation plan -> Agent Manager / Artifact
我要手动改一行代码 -> Editor
我要并行处理多个 workspace -> Agent Manager7. 常见误用
| 误用 | 后果 | 改法 |
|---|---|---|
| 在 Editor 里要求完成复杂多步任务 | chat 变长，验收散乱 | 切到 Agent Manager + Planning |
| 在 Manager 里问一个小语法问题 | 流程过重 | 直接用 Editor 或 inline command |
| 多 agent 改同一片代码 | diff 冲突 | 按模块拆 workspace 或任务 |
| 没写验收标准 | agent 只交“已完成” | 要求 screenshot、test、walkthrough |
8. 实战建议
新手可以用这个规则：
- 5 分钟内能看完 diff：Editor。
- 需要 browser 或 test 证明：Agent Manager。
- 需要先审 plan：Agent Manager。
- 只问概念或解释：Editor side panel。
- 要并行多个任务：Agent Manager。
深读：为什么不要把所有任务都丢进 Agent Manager
Agent Manager 的价值在于任务编排、状态观察和 artifacts 审查。如果只是问一个函数含义、改一行命名、修一个局部类型错误，它会变成过重流程。Antigravity 保留 Editor，不是历史包袱，而是为了让局部开发仍然直接。
反过来，复杂任务一直塞在 Editor side panel 里，也会让上下文、计划和验收散落在聊天里。判断入口时，看任务是否需要 plan、parallel workspace、browser evidence 或 artifact comments。
本章自检
你应该能回答：
- Editor 和 Agent Manager 分别服务哪类任务？
- 什么时候应该从 Editor 切到 Agent Manager？
- 为什么多 agent 不能无边界地同时改同一片代码？
- Agent Manager 里的 artifact 和 conversation 如何帮助验收？
通过标准：你能为一个真实任务选择入口，并写清它在哪个界面启动、在哪里审查、在哪里回到代码。
官方来源
- Google Antigravity Editor：官方 Editor 文档，说明 VS Code 基础、Tab、Command、Agent side panel 和 source control。
- Google Antigravity Agent Manager：官方 Agent Manager 文档，说明跨 workspace、监督多个 agent、切换 Editor。
- Google Antigravity Workspaces：官方 Workspaces 文档，说明多 workspace 和 conversation 管理。
- Getting Started with Google Antigravity：Google Codelab，说明 Editor、Agent Manager、
Cmd + E（Mac）/Ctrl + E（Windows）、Focus Editor 和 Open Editor。