Rules、Workflows 與 Skills
Antigravity 自定義體系：Rules、Workflows、Skills 的分工、global/workspace 落點、Skill 結構和漸進載入原則。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Rules/workflows/skills | 定製三件套 | 讓 agent 貼合專案的機制。 |
| 分層 | layers | 約定 / 流程 / 能力分開管。 |
| 複用 | reuse | 沉澱後跨任務複用。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你搞清 Antigravity 這套定製機制怎麼讀、放什麼到哪。
你是 Antigravity 定製機制導航顧問。
【角色】
Antigravity 定製機制導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 想統一的約定：___
- 想固化的流程：___
- 想沉澱的能力：___
- 個人還是團隊：___
- 經驗水平：___
【工作流程】
1. 分清三者職責
2. 給閱讀順序
3. 把我的需求歸位
4. 標出常見誤放
5. 給第一步
【輸出規範】
▌一、三者職責
▌二、閱讀順序
▌三、需求歸位
▌四、誤放 + 第一步
【硬約束】
- 放對機制不混用
- 高頻才固化
- 團隊設定版本管理
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法Antigravity 的自定義能力分三層：Rules 是長期行為約束，Workflows 是按需觸發的儲存 prompt，Skills 是帶後設資料、說明、指令碼和參考資料的能力包。三者不要混用。
一句話分工：Rules 像系統說明，Workflows 像 slash command，Skills 像可按需載入的專業工具包。
1. Rules
Codelab 把 Rules 描述為引導 agent 行為的 guidelines。它適合放長期穩定、每次都應該遵守的約定。
適合寫進 Rules：
- 程式碼風格
- 測試要求
- 檔案結構約定
- 命名約定
- 禁止觸碰的目錄
- 提交前檢查
不適合寫進 Rules：
- 單次任務需求
- 臨時實驗目標
- 過長背景材料
- 需要讀取模板或指令碼的流程
2. Workflows
Workflows 是儲存 prompt，可以用 / 觸發。它適合“不是每次都需要，但經常重複”的動作。
示例：
generate-unit-tests:
- 為目前修改涉及的檔案生成單元測試
- 測試檔案使用同名 test_ 字首
- 先列測試場景，等確認後再寫程式碼Workflows 的價值不是少打幾個字，而是把高頻動作變成一致入口。
3. Skills
Codelab 展示 Antigravity Skills 使用漸進披露：只有請求匹配 skill description 時，agent 才載入完整說明。典型目錄：
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>/ | 專案專屬能力包 |
團隊專案優先使用 workspace scope。個人 global 設定無法進入版本控制，也無法保證團隊一致。
5. 選擇規則
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:#f59e0b6. Skill 最小模板
---
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 不要寫成百科。它應該是“做某類任務時該怎麼做”，而不是“關於某主題的一切”。