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，再逐步提高自治程度。