Editor Surface 與工作分層
基於官方 Editor 文件理解 Antigravity Editor 的 VS Code 基礎、AI 入口、擴充套件能力和適用任務邊界。
Antigravity 的 Editor 是主要入口，也是最像傳統 IDE 的介面。Google 官方 Editor 文件說明，它基於 VS Code codebase，同時加入 Tab、Command、Agent side panel、Review Changes 和 Source Control 等 AI-enabled features。
這意味著學習 Editor 時不要走兩個極端：不要把它當成普通 VS Code，也不要把所有任務都扔給 Agent Manager。Editor 最適合“程式碼現場明確、上下文可控、diff 可以快速審查”的任務。
閱讀目標：讀完本章，你應該能判斷哪些任務留在 Editor 裡處理，哪些任務應該上升到 Agent Manager 或 Planning 模式。
1. Editor 是熟悉的 IDE，不是普通 IDE
官方文件強調，Antigravity Editor 保留了熟悉的編輯器體驗：開啟檔案、在檔案間切換、直接編輯、使用擴充套件、接入 source control。
差異在於這些傳統入口都能接到 AI 工作流：
| Editor 能力 | 官方含義 | 實操價值 |
|---|---|---|
| Tab | 在當前檔案附近給程式碼建議和導航 | 區域性加速，不打斷編碼流 |
| Command | 在編輯器或終端裡輸入自然語言指令 | 小範圍生成、改寫、解釋 |
| Agent side panel | 在右側面板直接和 agent 協作 | 當前 workspace 內的任務協作 |
| Review Changes | 檢視本 conversation 裡產生的改動 | 把 AI 輸出拉回 diff 審查 |
| Open VSX extensions | 繼續安裝語法、source control 等擴充套件 | 保留傳統 IDE 生態 |
2. Editor 與 Agent Manager 的邊界
先用任務範圍判斷入口，不要按個人習慣亂切。
flowchart TD
Task["新任務"] --> Known{"是否知道主要檔案或錯誤位置"}
Known -->|知道| Editor["留在 Editor"]
Known -->|不知道| Manager["進入 Agent Manager / Planning"]
Editor --> Small{"是否區域性、可快速讀完 diff"}
Small -->|是| TabCommand["Tab / Command / Side Panel"]
Small -->|否| Manager
Manager --> Artifacts["要求 plan、artifacts、walkthrough"]
TabCommand --> Review["Review Changes + Source Control"]簡單說：
- 你知道要改哪一小塊，留在 Editor。
- 你需要跨檔案規劃、瀏覽器驗證、長任務追蹤，切到 Agent Manager。
- 你讓 AI 寫了程式碼，就必須回到 Review Changes 或 Source Control。
3. 什麼時候留在 Editor
Editor 適合這些任務：
| 任務 | 推薦入口 | 原因 |
|---|---|---|
| 補一個函式體 | Tab 或 Command | 上下文區域性，結果可快速審查 |
| 修一個明確報錯 | Command 或 Agent side panel | 錯誤位置清楚 |
| 解釋當前檔案邏輯 | Agent side panel | 不需要跨 workspace 編排 |
| 生成 terminal 命令 | Terminal Command | 靠近 shell，但仍需審查 |
| 審查 AI 改動 | Review Changes | diff 是驗收入口 |
不適合只留在 Editor 的任務：
- 需要同時讀多個目錄。
- 需要先產出 implementation plan。
- 需要瀏覽器截圖、錄屏或 walkthrough。
- 會執行高副作用 terminal 命令。
- 涉及部署、賬號後臺、資料庫或生產環境。
Editor 不是低風險區域。只要 agent 開始寫檔案或生成 terminal 命令，就要把它當成真實工程改動審查。
4. 擴充套件生態的正確位置
官方 Editor 文件提到可以繼續從 Open VSX marketplace 下載擴充套件，用於語法高亮、source control integrations 或其他補充能力。
擴充套件可以增強開發體驗，但不要把擴充套件當成 agent 安全邊界。真正的邊界仍然在：
- workspace 範圍。
- terminal command review。
- file access policy。
- Browser URL allowlist。
- Git diff 和 source control。
深讀：為什麼 Editor 任務也要寫驗收條件
很多人會把 Editor 裡的 AI 入口當成“區域性輔助”，於是放鬆審查。但官方 Editor 文件把 Tab、Command、Agent side panel、Review Changes 和 Source Control 放在同一個工作面裡，說明區域性生成最終仍然會落到程式碼改動。
所以即使是一個小改動，也建議在 prompt 裡寫明“只改這個檔案”“完成後給 diff”“不要執行部署命令”。這樣可以把 Editor 的便利性和工程審查習慣接起來。
5. 第一天的 Editor 使用順序
第一次用 Editor，不要直接把複雜需求交給 agent。按這個順序熟悉：
- 開啟測試 workspace。
- 手動瀏覽檔案樹，確認專案結構。
- 用 Tab 接受一個區域性建議。
- 用 Command 生成或解釋一小段程式碼。
- 用 Agent side panel 做只讀解釋。
- 讓 agent 做一個單檔案小改。
- 開啟 Review Changes 審查 diff。
- 回到 Source Control 決定是否保留。
本章自檢
完成本章後，用這 3 個問題檢查自己是否真正理解：
- Editor 和 Agent Manager 的任務邊界是什麼？
- 為什麼 Editor 裡的 AI 改動也必須看 Review Changes 或 Source Control？
- Open VSX 擴充套件能增強什麼，不能替代什麼？
透過標準：你能把一個小任務安排在 Editor 內完成，並清楚說明用 Tab、Command、side panel 還是 Review Changes。
官方來源
- Google Antigravity Editor —— 官方說明 Editor 基於 VS Code codebase，並整合 Tab、Command、Agent side panel、Review Changes、Source Control 和 Open VSX 擴充套件。