Antigravity 從原理到實戰
按中文開發者學習順序講清 Antigravity：定位、安裝、Agent Manager、Artifacts、Browser、Rules、Skills、MCP、許可權、安全和真實專案實踐。
這一組不是官方功能清單，而是 Antigravity 的學習路徑。它按“從第一次開啟，到能放進真實專案”的順序講：先理解它是什麼，再學安全執行、任務編排、Artifacts 驗收、瀏覽器驗證、規則沉澱、許可權治理，最後進入團隊邊界和最佳實踐。
這一組解決什麼問題：讓你把 Antigravity 從“看起來很強的新 IDE”理解成“需要被管理的 agent 工作臺”。讀完以後，你應該能自己設計一套安全、可複用、可驗收的 Antigravity 使用方式。
學習路線
flowchart LR
A["定位"] --> B["第一次安全執行"]
B --> C["Editor vs Agent Manager"]
C --> D["Agent 任務迴圈"]
D --> E["Artifacts 驗收"]
E --> F["Browser Subagent"]
F --> G["Rules / Workflows / Skills"]
G --> H["MCP / 許可權 / Sandbox"]
H --> I["真實專案 walkthrough"]
I --> J["工具對比"]
J --> K["團隊邊界"]
K --> L["最佳實踐清單"]01 · Antigravity 是什麼
把它從 AI IDE 重新理解成 agent-first 開發平臺。
02 · 第一次安全執行
安裝後不要立刻放權，先跑只讀、單檔案、瀏覽器驗收三步。
03 · Editor 與 Agent Manager
理解什麼時候親手編輯，什麼時候像工程經理一樣派發 agent。
04 · Agent 任務迴圈
拆開計劃、執行、觀察、驗證、反饋和回退。
05 · Artifacts 驗收
用 task list、implementation plan、diff、screenshot、walkthrough 建立信任。
06 · Browser Subagent
讓瀏覽器驗證成為 UI 任務的預設交付標準。
07 · Rules / Workflows / Skills
把高頻約定沉澱成 Rule、Workflow、Skill 三層。
08 · MCP、許可權與 Sandbox
把 Allow/Deny/Ask 寫成資源字串，配 Strict Mode 與 sandbox。
09 · 真實專案 walkthrough
把前 8 篇合成一條完整前端任務流程。
10 · 工具對比
按入口、證據、治理選 Antigravity / Gemini CLI / Codex / Claude Code。
11 · 團隊安全邊界
賬號、workspace、許可權、MCP、Browser、Artifact、釋出六大邊界。
12 · 最佳實踐清單
商業級上線前的 12 節 checklist + 覆盤表。
讀這組文章前的預設設定
第一次使用 Antigravity，建議採用保守配置：
| 設定 | 推薦值 | 原因 |
|---|---|---|
| Terminal execution | Request Review | 先看清 agent 會跑什麼命令 |
| Artifact review | Asks for Review | 讓計劃、實現和 walkthrough 都進入人工驗收 |
| JavaScript execution | Request Review 或 Disabled | 降低瀏覽器 prompt injection 風險 |
| File access | Workspace only | 不讓 agent 自動讀寫工作區外的金鑰和私人檔案 |
| Browser URL allowlist | 只加任務需要的域名 | 瀏覽器能力越強，越要收窄訪問邊界 |
不建議的學習方式
| 反模式 | 問題 | 正確做法 |
|---|---|---|
| 一上來選最大自治模式 | 很難判斷 agent 是否誤刪、誤跑、誤訪問 | 從 Request Review 開始逐步放權 |
| 只看模型名字 | 忽略了 Manager、Artifacts、Browser、許可權這些真正差異 | 先學工作流和治理 |
| 把所有約定寫進一條 prompt | 不可複用、不可審計、下次還要重講 | 拆成 Rules、Workflows、Skills |
| 不看 walkthrough 只看最終程式碼 | 失去 Antigravity 的驗收優勢 | 要求截圖、錄屏、diff 和測試說明 |
學完後的檢查點
讀完這一組後，至少要能完成三件事：第一，判斷一個任務應該放在 Editor、Agent Manager 還是 Browser Subagent；第二，能用 Artifacts 判斷 agent 做了什麼、為什麼這麼做、如何驗證；第三，能把高頻約定沉澱成 Rules、Workflows 或 Skills。只會讓 agent 寫程式碼還不夠，Antigravity 的核心價值在於把計劃、執行、觀察和驗收放在同一個工作臺裡。
如果你還不能解釋許可權、sandbox、URL allowlist 和 walkthrough 的作用，先不要把它接入生產儲存庫。先用一個 demo repo 跑通只讀解釋、小範圍修改、瀏覽器驗收和人工 review，再逐步提高自治程度。