Editor 工作流
Antigravity Editor View 的日常工作流：補全、Tab、inline command、terminal command、agent side panel、Problems 和上下文引用。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Editor workflow | 編輯器工作流 | 在編輯器面裡的開發節奏。 |
| 人機協作 | collab | 人寫 + agent 輔助。 |
| 銜接 | bridge | 和 Agent Manager 銜接。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你搞清 Antigravity 編輯器工作流這一組怎麼讀、怎麼用。
你是 Antigravity 編輯器工作流導航顧問。
【角色】
Antigravity 編輯器工作流導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 我在編輯器裡的主要任務：___
- 傾向手寫還是輔助：___
- 專案型別：___
- 和 agent 怎麼配合：___
- 經驗水平：___
【工作流程】
1. 說明編輯器工作流定位
2. 給該組閱讀順序
3. 對應到我的任務
4. 說明和 Agent Manager 銜接
5. 給第一步
【輸出規範】
▌一、定位
▌二、閱讀順序
▌三、對應任務
▌四、銜接 + 第一步
【硬約束】
- 按任務選工作方式
- 改動統一走 review
- 貼合我的專案
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法Editor View 保留了 VS Code 類 IDE 的肌肉記憶：檔案樹、編輯器、終端、Problems、擴充套件、補全和命令。Antigravity 的差異是：這些傳統入口可以和 agent side panel、inline command、terminal command、Artifacts 和 Manager Surface 串起來。
這一頁解決什麼問題：你在 Editor 裡應該把 Antigravity 當成“區域性協作工具”，而不是把所有任務都扔進 Agent Manager。
1. Editor 適合的任務
| 任務 | 推薦入口 | 原因 |
|---|---|---|
| 改一個函式 | inline command 或 side panel | 上下文足夠小 |
| 解釋報錯 | hover 的 Explain and fix 或 Problems | 錯誤位置明確 |
| 生成一段命令 | terminal command | 直接貼近 shell |
| 讓 agent 看目前檔案 | side panel + 檔案引用 | 避免開啟過大 workspace |
| 小範圍重構 | Editor + diff review | 人能快速讀完 diff |
2. Tab 補全
Codelab 展示了幾個 Editor 補全能力：
- 普通程式碼補全：寫程式碼時按 Tab 接受建議。
- Tab to import：提示補缺失依賴或 import。
- Tab to jump：跳到下一個合理編輯點。
這些能力更像“區域性加速”，不適合替代完整任務規劃。你可以把它當成普通 IDE 智慧補全，而不是每次都啟動 agent。
3. Inline command
官方 Codelab 展示可以在 editor 或 terminal 中用自然語言觸發 command。常見模式：
選中一段程式碼 → Cmd + I（Mac）/ Ctrl + I（Windows）→ 讓 Antigravity 重寫、解釋或生成替代實現適合：
- 改寫函式
- 補註釋
- 解釋一段複雜邏輯
- 生成一個測試樣例
- 把 terminal 輸出轉成排障步驟
不適合：
- 改整個目錄
- 設計完整架構
- 運算元據庫
- 修改部署設定
4. Agent side panel
Editor 中的 side panel 適合“目前檔案 + 少量上下文”的協作。你可以用 @ 引用檔案、目錄或其他上下文，也可以用 / 觸發 workflow。
flowchart LR
File["目前檔案"] --> Panel["Agent side panel"]
Problem["Problems / terminal output"] --> Panel
Mention["@file / @folder"] --> Panel
Workflow["/workflow"] --> Panel
Panel --> Diff["區域性 diff"]
Diff --> Review["人工 review"]如果你發現自己在 side panel 裡描述了 10 個步驟、多個頁面、多個驗證動作，這個任務應該切到 Planning 或 Agent Manager。
5. Problems 與 terminal output
Antigravity 可以從 Problems 面板把錯誤交給 agent，也可以把 terminal 輸出發給 agent。正確用法是：
- 先保留原始錯誤，不要手動刪掉關鍵記錄。
- 讓 agent 解釋“錯誤發生在哪一層”。
- 要求它給最小修複方案。
- 修完後重新跑同一命令驗收。
示例 prompt：
解釋這段 terminal output。請先判斷是依賴、設定、型別還是執行時問題。
只給最小修複方案，不要修改無關檔案。6. Editor 與 Manager 的切換
Codelab 展示可以在 Editor 和 Agent Manager 間切換。實務上可以這樣分：
| 目前狀態 | 留在 Editor | 切到 Agent Manager |
|---|---|---|
| 你知道要改哪一段 | ✅ | |
| 任務需要瀏覽器驗收 | ✅ | |
| 任務要跑測試和生成 walkthrough | ✅ | |
| 只是解釋一個錯誤 | ✅ | |
| 需要同時開多個 workspace | ✅ |
官方來源
交付標準
Editor 工作流完成後，應該留下可 review 的區域性 diff，而不是隻得到一段解釋。最小標準是：你能說清用了哪個入口、agent 讀取了哪些上下文、改動影響哪些檔案、復跑了哪個命令或手動檢查。只要任務開始涉及多檔案、多步驟瀏覽器驗證或持續觀察，就把它升級到 Agent Manager。