03 · Editor 與 Agent Manager 怎麼分工 · AI 程式設計教程中文版

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 Manager

7. 常見誤用

誤用	後果	改法
在 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。

03 · Editor 與 Agent Manager 怎麼分工