Skip to content

建立 2026-09-19 更新 2026-09-19

Google Antigravity：Rules、Workflow 與 Skills

Google Antigravity 是 Google 於 2025 年底推出的 agentic IDE，由 Gemini 模型驅動，Agent 可以同時操作編輯器、終端機與瀏覽器完成端到端任務。它是本站五個工具中，唯一同時擁有三層自訂機制的一個：Rules（規則，較接近 Cursor 的做法）、Workflow（工作流程，多步驟的自動化腳本，正在被淘汰）、Skills（技能包，跟 Claude／Codex 同一套開放標準）。三者的差異可以先看〈核心概念：三個常見名詞〉。

檔案放哪裡

Rules（一直生效或依條件生效）

  • 工作區層級：.agents/rules/ 資料夾下的 .md 檔（Antigravity 2.0 起的預設路徑；舊版 .agent/rules/ 仍相容）。
  • 也會讀取專案根目錄的 AGENTS.md（跨工具通用）與 GEMINI.md（Antigravity／Gemini 專屬）。
  • 全域：~/.gemini/GEMINI.md（個人跨專案的偏好設定）、~/.gemini/antigravity-cli/rules/（CLI 專用的全域規則）。
  • 外掛提供的規則：~/.gemini/antigravity-cli/plugins/<plugin_name>/rules/，安裝外掛後自動套用。
  • 單一規則檔上限 12,000 字元，寫太長需要拆成多份。

Workflow（多步驟工作流程，即將淘汰）

  • 工作區層級：.agents/workflows/ 資料夾下的 .md 檔（舊版 .agent/workflows/ 仍相容）；全域：~/.gemini/config/workflows/。
  • 一份 Workflow 就是排好順序的步驟清單，用來一次跑完「部署服務」「逐一回覆 PR 留言」這類多階段任務，單檔上限同樣是 12,000 字元。
  • 用 /workflow-名稱 手動觸發，Workflow 之間還能互相呼叫（例如某個步驟寫「執行 /workflow-2」）。
  • 官方已宣布淘汰時程：2026 年 11 月 1 日起，Workflow 資料夾將不再被索引、也無法用 slash command 執行，功能會被整併進 Skills。新專案建議直接寫 Skill；既有 Workflow 可用 /migrate-workflows 指令自動轉換。

Skills（需要時才載入）

  • 工作區層級：.agents/skills/<skill-name>/SKILL.md（預設路徑，舊版 .agent/skills/ 仍相容）。
  • 全域（IDE）：~/.gemini/config/skills/<skill-name>/SKILL.md；全域（CLI）：~/.gemini/antigravity-cli/skills/<skill-name>/SKILL.md。
  • 外掛提供的技能：~/.gemini/antigravity-cli/plugins/<plugin_name>/skills/。

撰寫格式

Rules 沒有強制的 frontmatter，靠四種模式決定何時套用：

模式 說明
Manual 只能在對話裡用 @規則名 手動叫出來
Always on 每次對話都自動套用
Model decision Agent 讀自然語言描述，自行判斷是否相關
Glob 編輯到符合路徑樣式（如 src/**/*.ts）的檔案時自動套用

Workflow 是標題＋簡短說明＋一連串編號步驟的 Markdown 檔，沒有資料夾結構：

---
description: 部署目前分支到 staging 環境並通知團隊
---

# Deploy to Staging

1. 執行 `npm run build`，確認沒有錯誤。
2. 執行 `npm run deploy:staging`。
3. 部署完成後，在 Slack #deploy 頻道貼出版本號與變更摘要。

Skills 則跟 Claude／Codex 相同，YAML frontmatter 中 description 為必填、name 選填（預設用資料夾名稱）：

---
name: code-review
description: 審查程式碼是否有 bug、風格問題，適合處理 pull request 時使用
---

# Code Review Skill

1. 檢查是否有未處理的例外。
2. 確認命名符合專案慣例。
3. 用條列式列出建議，並標明嚴重程度。

實際應用

.agents/
├── rules/
│   ├── style.md          # Always on：團隊共同的程式風格
│   └── frontend.md        # Glob：只在 src/components/**/*.tsx 生效
├── workflows/
│   └── deploy-staging.md  # /deploy-staging 手動觸發，即將被 Skill 取代
└── skills/
    └── code-review/
        ├── SKILL.md        # 必要：frontmatter + 指示
        ├── scripts/         # 選用：可執行腳本
        ├── examples/        # 選用：參考範例
        └── resources/       # 選用：範本、schema 等靜態資料

對話開始時，Agent 會先看到所有技能的名稱與 description 清單；覺得相關才會讀取完整的 SKILL.md。也可以直接在提示中打 /技能名 手動指定，Antigravity CLI 會自動把技能轉成對應的 slash command。

官方文件

推薦影音

Google Antigravity 介紹

簡述：官方頻道發布的產品介紹影片，說明 Antigravity 這個 agentic IDE 的核心概念與整體操作方式，適合完全沒接觸過的讀者先建立整體印象。

建立你的第一個 Agent Skill

簡述：實際示範如何在 Antigravity 中建立、組織與設定一個 SKILL.md，涵蓋資料夾結構與觸發方式，適合看完介紹後想動手做的讀者。

相關資料