12 · Antigravity 最佳實踐清單
Antigravity 商業級使用前 checklist：安裝、許可權、workspace、Artifacts、Browser、Rules、Workflows、Skills、MCP、團隊邊界和上線驗收。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 最佳實踐 | best practices | 用好 Antigravity 的經驗清單。 |
| 檢查清單 | checklist | 可逐條核對的項。 |
| 反模式 | anti-pattern | 該避免的做法。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你用一份檢查清單核對 Antigravity 的用法是否到位。
你是 Antigravity 最佳實踐顧問。
【角色】
Antigravity 最佳實踐顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 我現在的用法：___
- 遇到的問題：___
- 團隊還是個人：___
- 最想改進的點：___
- 經驗水平：___
【工作流程】
1. 對照清單核對現狀
2. 標出做得不到位的項
3. 指出常見反模式
4. 給改進優先順序
5. 給第一步
【輸出規範】
▌一、清單核對
▌二、不到位項
▌三、反模式
▌四、改進優先順序 + 第一步
【硬約束】
- 按清單逐條核對
- 先改高風險項
- 結論落到可執行步驟
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述這張清單用於收尾。你可以把它當成 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 和目前不支援項。