Antigravity Rules & Workflows 實戰：讓 AI 自動遵循開發規範

Build intelligent dev environments with official mechanisms - set once, work forever

Dec 14, 2025

*最後更新：2025年12月14日*

問題

在使用 Antigravity IDE 開發時，常見的重複工作:

第一天：

開發者：建立一個 React 元件

AI：好的，使用 class component

開發者：不對，我們只用 function component

AI：了解，已修正

第二天（新對話）：

開發者：建立另一個 React 元件

AI：好的，使用 class component

開發者：（又要重新解釋...）我們只用 function component

第三天（重新開啟專案）：

開發者：建立登入元件

AI：要用什麼框架？

開發者：（第三次...）React，function component，TypeScript

每次開新對話、重啟 IDE，都要重新告訴 AI：

- 使用的程式碼風格

- 命名慣例

- 測試要求

- 文件格式

這些規則應該是專案的一部分，而不是每次都要口頭說明。

解決方案

Antigravity 官方提供兩種機制，讓 AI 自動遵循你的開發規範：

1. Rules（規則）

- 類似「系統指令」

- 永遠生效，不需要每次提醒

- 定義 AI 的行為準則

2. Workflows（工作流程）

- 類似「快捷指令」

- 按需觸發，執行複雜任務

- 標準化重複性工作

用 agy-starter 體驗 Rules & Workflows

與其從理論開始，不如直接動手試試。我們準備了一個完整的範例專案 `agy-starter`，讓你邊做邊學。

Repo: https://github.com/AgentWorkshop/agy-starter

步驟 1：Clone 專案並開啟

git clone https://github.com/AgentWorkshop/agy-starter.git

cd agy-starter

在 Antigravity IDE 中開啟此資料夾（File → Open Folder → 選擇 `agy-starter/`）

💡 什麼是 Rules？

打開專案後，Antigravity 會自動讀取 `.antigravity/rules.md` 檔案。**Rules 是 AI 的行為準則**，就像憲法一樣永遠生效：

**永遠生效**：不需要每次對話都重複說明
**自動套用**：開啟專案時 AI 自動載入
**團隊共享**：commit 到 git 後，所有成員都遵循同樣規範

範例： 打開 `.antigravity/rules.md`，你會看到文章撰寫的完整規範。試著讓 AI 建立新文章，它會自動遵循這些規則。

步驟 2：探索專案結構

查看專案檔案結構：

*圖片說明：agy-starter 專案結構 - 在 Antigravity IDE 中的實際檔案樹*

💡 檔案位置說明

Antigravity 專案有兩個官方目錄：

`.antigravity/rules.md` - 專案規範

AI 的行為準則
自動載入，永遠生效

`.agent/workflows/` - 工作流程

可重複使用的任務範本
用 `/指令` 觸發

Tips： 也可以在全域設定（`~/.gemini/GEMINI.md`），適用所有專案的個人偏好。

步驟 3：體驗第一個 Workflow

在 Antigravity 對話中輸入：`/`

你會看到可用的 workflows 列表：

*圖片說明：觸發 Workflow - 輸入 / 後的介面*

選擇 `/create`，讓 AI 建立一篇新文章。

💡 什麼是 Workflows？

Workflows 是可重複使用的任務範本，就像腳本一樣：

**標準化流程**：確保每次執行步驟一致
**節省時間**：不用每次都詳細描述步驟
**團隊協作**：所有人用同樣方式完成任務

agy-starter 包含的 workflows：

`/create` - 建立新文章（含模板、圖片目錄）
`/update` - 更新文章中的程式碼範例
`/proof` - 校對文章（檢查格式、連結、語氣）

打開 `.agent/workflows/create-article.md` 看看 workflow 的結構：包含步驟說明、範例、和預期結果。

步驟 4：自訂你的 Rules

現在你理解 Rules 的運作方式，試著編輯 `.antigravity/rules.md` 來匹配你的專案需求。

💡 撰寫好的 Rules

❌ 不好的範例（太抽象）：

- 寫出好的程式碼

- 遵循 Best Practice

✅ 好的範例（具體明確）：

- 使用 Function Component，不要用 Class Component

- Props 必須定義 TypeScript interface

- 每個元件都要有對應的 .test.tsx 檔案

編輯步驟：

1. 開啟 `.antigravity/rules.md`

2. 根據你的專案技術棧修改規範

3. 儲存後重新載入 Antigravity（或開新對話）

4. 測試 AI 是否遵循新規則

步驟 5：建立你的第一個 Workflow

試著在 `.agent/workflows/` 建立一個新的 workflow 檔案。

💡 Workflow 結構

基本格式：

---

description: 簡短描述這個 workflow 做什麼

---

## 步驟

### 1. 第一個步驟

- 具體操作說明

- 預期結果

### 2. 第二個步驟

- 具體操作說明

- 預期結果

範例：建立測試檔案

---

description: 為現有程式碼產生單元測試

---

## 步驟

### 1. 分析目標檔案

- 讀取指定的程式碼檔案

- 識別所有 exported functions

### 2. 產生測試案例

- 為每個 function 建立至少 3 個測試

- 使用清楚的測試名稱

### 3. 執行測試

- 自動執行 npm test

- 確認所有測試通過

儲存為 `.agent/workflows/generate-tests.md`，然後用 `/generate` 觸發它。

深入理解

Global vs Workspace Rules

你可能會疑惑：什麼時候用全域 Rules，什麼時候用專案 Rules？

全域設定（`~/.gemini/GEMINI.md`）：

- 個人程式碼風格（適用所有專案）

- 慣用的命名方式

- 文件撰寫習慣

專案設定（`.antigravity/rules.md`）：

- 專案特定技術棧

- 團隊共享規範

- 客戶特殊要求

優先順序： Workspace Rules > Global Rules（專案設定優先）

常見問題

Q: Rules 和 Workflows 有什麼不同？

A: Rules 是「被動規則」，Workflows 是「主動任務」

Q: 重新開啟專案時，Rules 還會生效嗎？

A: 是的！Rules 和 Workflows 儲存在專案檔案中，每次開啟專案 AI 都會自動載入。

Q: 團隊成員沒有 Antigravity 怎麼辦？

A: 這些檔案是純文字 Markdown，可以當作專案的 CONTRIBUTING.md 閱讀。

總結

實施 Rules & Workflows 後

✅ 不再重複 - 設定一次，AI 永遠記得

✅ 即時 onboarding - 新成員立刻獲得相同的 AI 行為

✅ 品質一致 - 所有程式碼遵循相同標準

✅ 複雜任務變成一鍵操作

✅ 專案規範被文件化且可執行

Discussion about this post

Ready for more?