---
title: "Rules、Workflows 與 Skills"
description: "Antigravity 自定義體系：Rules、Workflows、Skills 的分工、global/workspace 落點、Skill 結構和漸進載入原則。"
verifiedAt: "2026-05-05"
---

Antigravity 的自定義能力分三層：Rules 是長期行為約束，Workflows 是按需觸發的儲存 prompt，Skills 是帶後設資料、說明、指令碼和參考資料的能力包。三者不要混用。

> [!NOTE]
> **一句話分工**：Rules 像系統說明，Workflows 像 slash command，Skills 像可按需載入的專業工具包。

## 1. Rules

Codelab 把 Rules 描述為引導 agent 行為的 guidelines。它適合放長期穩定、每次都應該遵守的約定。

適合寫進 Rules：

- 程式碼風格
- 測試要求
- 檔案結構約定
- 命名約定
- 禁止觸碰的目錄
- 提交前檢查

不適合寫進 Rules：

- 單次任務需求
- 臨時實驗目標
- 過長背景材料
- 需要讀取模板或指令碼的流程

## 2. Workflows

Workflows 是儲存 prompt，可以用 `/` 觸發。它適合“不是每次都需要，但經常重複”的動作。

示例：

```text
generate-unit-tests:
- 为当前修改涉及的文件生成单元测试
- 测试文件使用同名 test_ 前缀
- 先列测试场景，等确认后再写代码
```

Workflows 的價值不是少打幾個字，而是把高頻動作變成一致入口。

## 3. Skills

Codelab 展示 Antigravity Skills 使用漸進披露：只有請求匹配 skill description 時，agent 才載入完整說明。典型目錄：

```text
my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/
```

`SKILL.md` 需要有 frontmatter 後設資料，最關鍵的是 `name` 和 `description`。description 決定 agent 什麼時候載入這個 skill。

## 4. Global 與 workspace scope

Codelab 展示了這些落點：

| 型別 | 路徑 | 適合放什麼 |
| --- | --- | --- |
| Global rule | `~/.gemini/GEMINI.md` | 個人全域性習慣 |
| Global workflow | `~/.gemini/antigravity/global_workflows/<name>.md` | 跨專案高頻動作 |
| Workspace rules | `<workspace-root>/.agents/rules/` | 專案約定 |
| Workspace workflows | `<workspace-root>/.agents/workflows/` | 專案專屬流程 |
| Global skills | `~/.gemini/antigravity/skills/<skill-folder>/` | 跨專案能力包 |
| Workspace skills | `<workspace-root>/.agents/skills/<skill-folder>/` | 專案專屬能力包 |

> [!IMPORTANT]
> 團隊專案優先使用 workspace scope。個人 global 配置無法進入版本控制，也無法保證團隊一致。

## 5. 選擇規則

```mermaid
flowchart TD
    Need["你想沉澱一條經驗"] --> Always{"每次都要生效?"}
    Always -->|是| Rule["寫 Rule"]
    Always -->|否| Trigger{"需要手動觸發?"}
    Trigger -->|是| Workflow["寫 Workflow"]
    Trigger -->|否| Package{"需要指令碼/模板/參考資料?"}
    Package -->|是| Skill["寫 Skill"]
    Package -->|否| Prompt["保留為普通 prompt"]

    style Rule fill:#dcfce7,stroke:#22c55e
    style Workflow fill:#dbeafe,stroke:#3b82f6
    style Skill fill:#fef3c7,stroke:#f59e0b
```

## 6. Skill 最小模板

```markdown
---
name: code-review
description: Reviews code changes for bugs, style issues, and project conventions. Use before accepting implementation diffs.
---

# Code Review

When reviewing code, check correctness, edge cases, project conventions, tests, and risk boundaries.
```

Skill 不要寫成百科。它應該是“做某類任務時該怎麼做”，而不是“關於某主題的一切”。

## 官方來源

- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- [Agent Skills - Google Antigravity Documentation](https://antigravity.google/docs/skills)

## 接下來去哪

<Cards>
  <Card title="MCP、許可權與安全" description="自定義能力越多，越需要明確工具和許可權邊界。" href="/zh-Hant/docs/antigravity/official/05-mcp-permissions-security" />
  <Card title="Rules / Workflows / Skills 深講" description="從原理層理解三者怎麼進入長期工作流。" href="/zh-Hant/docs/antigravity/understanding" />
</Cards>
