---
title: "Antigravity 從原理到實戰"
description: "按中文開發者學習順序講清 Antigravity：定位、安裝、Agent Manager、Artifacts、Browser、Rules、Skills、MCP、許可權、安全和真實專案實踐。"
verifiedAt: "2026-05-05"
---

這一組不是官方功能清單，而是 Antigravity 的學習路徑。它按“從第一次開啟，到能放進真實專案”的順序講：先理解它是什麼，再學安全執行、任務編排、Artifacts 驗收、瀏覽器驗證、規則沉澱、許可權治理，最後進入團隊邊界和最佳實踐。

> [!NOTE]
> **這一組解決什麼問題**：讓你把 Antigravity 從“看起來很強的新 IDE”理解成“需要被管理的 agent 工作臺”。讀完以後，你應該能自己設計一套安全、可複用、可驗收的 Antigravity 使用方式。

## 學習路線

```mermaid
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["最佳實踐清單"]
```

<Cards>
  <Card title="01 · Antigravity 是什麼" description="把它從 AI IDE 重新理解成 agent-first 開發平臺。" href="/zh-Hant/docs/antigravity/understanding/01-what-is-antigravity" />
  <Card title="02 · 第一次安全執行" description="安裝後不要立刻放權，先跑只讀、單檔案、瀏覽器驗收三步。" href="/zh-Hant/docs/antigravity/understanding/02-install-first-safe-run" />
  <Card title="03 · Editor 與 Agent Manager" description="理解什麼時候親手編輯，什麼時候像工程經理一樣派發 agent。" href="/zh-Hant/docs/antigravity/understanding/03-editor-vs-agent-manager" />
  <Card title="04 · Agent 任務迴圈" description="拆開計劃、執行、觀察、驗證、反饋和回退。" href="/zh-Hant/docs/antigravity/understanding/04-agent-loop" />
  <Card title="05 · Artifacts 驗收" description="用 task list、implementation plan、diff、screenshot、walkthrough 建立信任。" href="/zh-Hant/docs/antigravity/understanding/05-artifacts-review-workflow" />
  <Card title="06 · Browser Subagent" description="讓瀏覽器驗證成為 UI 任務的預設交付標準。" href="/zh-Hant/docs/antigravity/understanding/06-browser-subagent-ui-testing" />
  <Card title="07 · Rules / Workflows / Skills" description="把高頻約定沉澱成 Rule、Workflow、Skill 三層。" href="/zh-Hant/docs/antigravity/understanding/07-rules-workflows-skills" />
  <Card title="08 · MCP、許可權與 Sandbox" description="把 Allow/Deny/Ask 寫成資源字串，配 Strict Mode 與 sandbox。" href="/zh-Hant/docs/antigravity/understanding/08-mcp-permissions-sandbox" />
  <Card title="09 · 真實專案 walkthrough" description="把前 8 篇合成一條完整前端任務流程。" href="/zh-Hant/docs/antigravity/understanding/09-real-project-walkthrough" />
  <Card title="10 · 工具對比" description="按入口、證據、治理選 Antigravity / Gemini CLI / Codex / Claude Code。" href="/zh-Hant/docs/antigravity/understanding/10-antigravity-vs-gemini-cli-codex-claude-code" />
  <Card title="11 · 團隊安全邊界" description="賬號、workspace、許可權、MCP、Browser、Artifact、釋出六大邊界。" href="/zh-Hant/docs/antigravity/understanding/11-team-security-boundaries" />
  <Card title="12 · 最佳實踐清單" description="商業級上線前的 12 節 checklist + 覆盤表。" href="/zh-Hant/docs/antigravity/understanding/12-best-practices-checklist" />
</Cards>

## 讀這組文章前的預設設定

第一次使用 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，再逐步提高自治程度。

## 接下來去哪

<Cards>
  <Card title="從定位開始" description="第一次系統學習從 Antigravity 是什麼開始。" href="/zh-Hant/docs/antigravity/understanding/01-what-is-antigravity" />
  <Card title="查官方功能" description="如果你只想查某個設定項，直接去官方教程中文版。" href="/zh-Hant/docs/antigravity/official" />
</Cards>
