12 · Antigravity 最佳实践清单
Antigravity 商业级使用前 checklist：安装、权限、workspace、Artifacts、Browser、Rules、Workflows、Skills、MCP、团队边界和上线验收。
这张清单用于收尾。你可以把它当成 Antigravity 进入真实项目之前的上线门槛：不是会打开应用就算会用，而是安装、权限、验收、回退、沉淀、额度、团队边界都跑通。
商业级标准：agent 能工作只是第一层；你能控制它、验收它、回退它、复用它，才算可上线。
使用方式：先用测试 workspace 跑通，再进入真实项目；先单人试点，再团队推广；先只读和局部任务，再开放复杂任务。
1. 本机准备
| 检查项 | 状态 |
|---|---|
| 从官方 download 页面安装 | ☐ |
| 登录账号与使用条款已确认 | ☐ |
| command line tool 可用 | ☐ |
| 已用测试 workspace 跑通过第一天流程 | ☐ |
| 知道如何提交产品反馈 | ☐ |
补充检查：
- macOS、Windows 或 Linux 平台要求已核对。
- Chrome 已安装，Antigravity 能检测到；检测不到时知道在哪里配置 Chrome binary path。
- 了解 Agent Manager 和 Editor 的切换方式。
- 了解 separate browser profile 默认没有日常登录态。
- 知道删除 conversation 不等于撤销文件改动。
2. 默认权限
| 检查项 | 推荐 |
|---|---|
| Terminal execution | Request Review |
| Artifact review | Asks for Review |
| JavaScript execution | Request Review 或 Disabled |
| Terminal sandbox | 开启 |
| File access | Workspace only |
| Non-workspace file access | 默认关闭 |
| Browser URL allowlist | 只加必要域名 |
真实项目建议直接开启 Strict Mode。官方文档说明它会强制 Terminal Auto Execution、Browser JavaScript Execution、Artifact Review 回到 Request Review，并关闭 workspace 外文件访问。
3. Workspace 边界
flowchart TD
Workspace["Workspace"] --> Include["项目源码 / 测试 / 文档"]
Workspace --> Exclude["凭据 / 私人文件 / 云盘根 / 生产数据"]
Include --> OK["可读写"]
Exclude --> Block["禁止默认访问"]检查：
- workspace 不指向家目录。
.env和凭据文件不进入 agent 默认读取范围。- 大任务拆分到明确目录。
- 多 agent 不同时改同一批文件。
推荐 workspace rule：
# 项目默认边界
1. 先读项目规则，再动手。
2. 跨文件修改先输出 Implementation Plan。
3. 禁止读取凭据、`.env`、生产数据和 workspace 外文件。
4. UI 改动必须提供 mobile / desktop 验收证据。
5. 不自动 git push、部署、数据库迁移或改远端配置。4. Artifacts 验收
每个复杂任务必须至少有：
| Artifact | 要求 |
|---|---|
| Task List | 步骤清楚，范围可控 |
| Implementation Plan | 有技术路线、验证和风险 |
| Diff | 文件范围合理 |
| Screenshot | UI 改动必有 |
| Browser Recording 或 Walkthrough | 交互任务必有 |
| Remaining Risks | 说明未覆盖内容 |
验收顺序：
Task List -> Implementation Plan -> Proceed -> Diff -> Test -> Screenshot / Recording -> Walkthrough -> 人工接受不要跳过 diff，也不要用 walkthrough 替代测试。Walkthrough 是索引，不是事实本身。
5. Browser 验收
UI 或网页任务检查：
- desktop 截图。
- mobile 截图。
- console 无 error。
- 关键用户路径跑通。
- 失败路径有提示。
- URL 在 allowlist 内。
- 没有登录真实敏感后台自动提交。
断点最低标准：
| 宽度 | 目的 |
|---|---|
| 390px | 主流手机窄屏，检查导航、按钮、长文本 |
| 768px | 平板和窄桌面过渡，检查布局列数 |
| 1024px | 桌面边界，检查侧栏和内容宽度 |
| 1440px | 标准桌面，检查首屏和最大宽度 |
如果页面有侧边栏、表格、代码块、长链接、卡片网格，必须额外检查横向溢出。
6. Rules / Workflows / Skills
成熟度检查：
| 层 | 最小状态 |
|---|---|
| Rules | 项目默认边界和验收要求已写 |
| Workflows | 至少有 UI 验收或测试生成流程 |
| Skills | 高频专业任务有可复用 skill |
| Scope | 团队项目用 workspace scope |
| Review | rules/skills 进入代码审查 |
沉淀顺序：
手写 prompt -> 复用 2-3 次 -> 做 workflow -> 加脚本/模板/参考资料 -> 升级 skill -> 抽出 always-on rule不要把一次性经验直接做成 Skill。Skill 要有明确触发条件和维护价值。
7. MCP
MCP 上线前：
- 列出所有 server。
- 列出 tool 和副作用。
- 写操作默认 Ask。
- 外部提交类 tool 默认 Deny 或人工执行。
- 凭据来源不写进普通文档。
- 每个 workspace 单独启用。
必要字段检查：
| 字段 | 用途 |
|---|---|
disabled | 暂时禁用整个 server |
disabledTools | 禁用指定 tool，不提供给模型 |
headers | 远程 server 的认证 header |
authProviderType | Google ADC 等认证 provider |
oauth | 手动 OAuth client 信息 |
只需要读资源时，不要顺手放开写 tool。能创建、删除、发布、付款、迁移、评论、推送的 tool 都按高风险处理。
8. 模型、额度和成本
上线前确认：
| 检查项 | 推荐 |
|---|---|
| 当前 reasoning model | 按任务复杂度选择 |
| 模型切换 | 知道运行中切换不会立刻改变当前 turn |
| Baseline quota | 长任务前查看 settings |
| AI Credit Overages | 默认 Never |
| BYOK / 自带 endpoint | 不作为当前方案 |
| 团队组织层级 | 不写成已 GA 能力 |
额度不足时，不要反复重试大任务。降级为只读分析、拆阶段、换更小任务或等待 quota 刷新。
9. 禁止默认自动化
默认禁止 agent 自动执行：
- 删除数据。
- 修改生产数据库。
- 部署生产。
git push。- 发布公开内容。
- 修改 DNS、支付、广告、权限。
- 登录后台提交表单。
- 读取 workspace 外凭据。
10. 任务模板
商业任务 prompt 可用这个骨架：
目标：
边界：
1. 修改范围：
2. 禁止事项：
3. 权限策略：
4. 验收方式：
5. 交付 artifacts：
6. 未覆盖风险：
请先输出 implementation plan，等我确认后再执行。更完整的 UI 任务模板：
目标：
修复或完善指定页面的具体问题。
边界：
- 只允许修改指定页面、组件和必要测试。
- 不改部署、认证、全局主题、凭据和无关文件。
- Browser 只允许访问 localhost。
- Terminal 命令先请求确认。
验收：
- 跑质量检查和构建。
- 390、768、1024、1440 四档无横向溢出。
- desktop / mobile 截图。
- 关键交互 walkthrough 或 recording。
- console 无 error。
- 列出剩余风险。
请先输出 implementation plan，等我确认后再执行。11. 上线判断
满足下面 5 条，才算 Antigravity 可以进入真实项目：
- 你能预测它会申请哪些权限。
- 你能看懂 plan 和 diff。
- UI 任务有截图或录屏。
- 失败时能回退。
- 团队知道哪些动作永远人工执行。
更商业化一点，至少补到 8 条：
- 已有 workspace rules。
- 已有 UI 验收 workflow。
- 已有 MCP tool 清单。
- 已有 Browser URL 策略。
- 已有 artifact 脱敏规则。
- 已有发布红线。
- 已有失败回退 SOP。
- 已有定期复盘机制。
12. 最终复盘表
每次把 Antigravity 用到真实项目后，做一次复盘：
| 问题 | 记录 |
|---|---|
| 哪个任务最适合 Antigravity | |
| 哪个权限请求不合理 | |
| 哪个 artifact 真正帮助验收 | |
| 哪个 prompt 应该沉淀成 workflow | |
| 哪个规则应该写入 workspace | |
| 哪个 MCP tool 应该禁用 | |
| 哪个断点或 UI 状态漏测 | |
| 下次默认流程怎么改 |
这张表是把一次 agent 使用变成团队资产的关键。没有复盘，下一次还会靠人记忆。
官方来源
- Google Antigravity Getting Started - 官方安装、平台要求、更新和基础导航。
- Google Antigravity Agent Modes / Settings - 官方说明 Planning、Fast、Artifact Review、Terminal Auto Execution 和文件访问设置。
- Google Antigravity Strict Mode - 官方说明 strict mode 对权限和文件访问的强制收紧。
- Google Antigravity Browser - 官方说明 separate browser profile、browser tools 和 Chrome path。
- Google Antigravity Artifacts - 官方说明 artifacts 和 feedback。
- Google Antigravity MCP Integration - 官方说明 MCP resources、tools、认证和禁用字段。
- Google Antigravity Models - 官方说明 reasoning model、sticky selection 和 additional models。
- Google Antigravity Plans - 官方说明 quota、AI credits、overage 和当前不支持项。