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 和當前不支援項。