🤖 Antigravity 實習生調教指南：玩轉 Rules、Workflows 與 Skills

身為 AI 時代的「數位牧羊人」，我們最近都發現 Antigravity Agent 終於跟進了眾所期待的 Skill 功能。但老實說，打開後台看到 Rules、Workflows、Skills 這一坨名詞，是不是讓你瞬間想把視窗關掉，回去繼續用 ChatGPT 瞎聊？😂

別急著崩潰。其實這一切並不難，只要把你手頭上的 AI 想像成一位剛進公司、潛力無窮但有點「呆萌」的全能實習生，思路就全通了。

要讓這位實習生從「只會尬聊」變成「得力助手」，你需要給他三種層次的指引。今天 Aizen 就來幫大家拆解這套調教心法。

目錄

1. Rules：刻進骨子裡的「員工守則」
2. Workflows：貼在牆上的「SOP 清單」
3. Skills：隨身攜帶的「專業工具箱」
4. 分析與洞察：如何選擇最適合的調教方式？
5. 從混亂到優雅：區分「公用」與「專用」
6. 官方沒說清楚的「御三家座位表」
7. 進階玩家的自律：Skill 最小化與專案地圖
8. 分析與洞察：為什麼結構化思維是 AI 時代的必備技能？
9. 參考文檔

1. Rules：刻進骨子裡的「員工守則」

Rules 就像是實習生的「潛意識」或「DNA」。這是最基礎的行為準則，你只需要設定一次，他就會默默遵守，不需要你每次交辦任務時都耳提面命。

1.1 作用：定義風格與基本格式

這部分決定了 AI 的「人設」。他是個嚴謹的法律顧問，還是個會跟你開玩笑的社群小編？

1.2 實戰舉例

在設定 Rules 時，我們可以這樣要求：

• 語言偏好：回覆一律使用「繁體中文（台灣用語）」。
• 排版美學：報告標題必須加粗，段落間要留白。
• 情緒價值：文案結尾給我加個 ✨ 或 🚀，保持積極態度。

編輯碎碎念：這就像是要求實習生「上班不能穿拖鞋」和「見到客戶要微笑」一樣基本。

2. Workflows：貼在牆上的「SOP 清單」

如果說 Rules 是靈魂，那 Workflows 就是他的「肢體動作」。這是專門為了處理重複性、固定步驟的任務而設計的。一個口令、一個動作，絕不偷懶，也不會自作聰明。

2.1 作用：自動化連續動作

將複雜的任務拆解成 1、2、3 步驟。當你觸發特定關鍵字時，AI 就會啟動這套流程。

2.2 實戰舉例

假設你設定了一個 /週報 的 Workflow：

1. 收集資訊：抓取本週所有對話進度。
2. 精煉重點：自動過濾廢話，抓出三個核心進展。
3. 產出草稿：生成一份 300 字的 Markdown 格式報告。

3. Skills：隨身攜帶的「專業工具箱」

這是最進階的部分。Skills 是你丟給實習生的「專業百寶袋」，裡面裝滿了處理特定任務的說明書（知識庫）和專用工具（API）。他平常不會亂動這些東西，但只要聊到相關話題，他會自己「開掛」。

3.1 作用：賦予原本不具備的專業能力

AI 本身可能不懂昨天的股價，也不懂你公司的私人財報。透過 Skills，你給了他「查資料」與「用工具」的能力。

3.2 實戰舉例：選股分析包

• 知識庫：內含《財報判讀手冊》與《產業研究報告》。
• 工具：串接即時股價 API。
• 情境：當你問「台積電現在能買嗎？」，他會自動翻閱手冊、抓取即時股價，最後產出專業分析，而不是在那邊跟你瞎編。

4. 分析與洞察：如何選擇最適合的調教方式？

很多工程師或管理者最常犯的錯，就是「用大砲打小鳥」，或是「叫小鳥去搬磚」。為了幫大家省下白費力氣的時間，我們整理了這份懶人指南：

5. 從混亂到優雅：區分「公用」與「專用」

但現實往往是殘酷的——如果你沒給這些實習生安排清楚的「座位表」，不用一個禮拜，你的專案資料夾就會像剛被隕石撞過一樣，亂到連你自己都想離職。

身為工程師，最怕的不是 Bug，而是那種「明明我寫過，但我現在找不到」的無力感。為了不讓你的 Code 變成數位貧民窟，來聊聊如何優雅地建立 AI 專案秩序。

在動手整理之前，我們先來看看大多數人的慘痛經驗。

5.1 過去的混亂 (The "Copy-Paste & Pray" Method)

管他的，反正能動就好。所有腳本、設定檔全部塞在專案根目錄。當你需要開發 B 專案時，就從 A 專案複製貼上，然後一邊改一邊祈禱不要改錯。這種「複製貼上大法」雖然快，但很快就會讓你陷入版本地獄。

5.2 現在的優雅：二分法決策

要終結混亂，你只需要在建立任何工具前，問自己一個關鍵問題：「這個工具，別的專案也用得到嗎？」

根據這個問題，我們可以把資源分成兩大類：

• Global (全域工具)：像是你隨身攜帶的瑞士刀。舉凡通用的 Git 提交規範、常用的資料轉換腳本，都應該放進全域工具箱 (~/.gemini/)。
• Workspace (專案限定)：這是專案的特製零件。例如針對特定 API 的呼叫邏輯、某個專案專屬的開發規範，就乖乖待在專案自己的工具間 (<workspace>/.agent/)，不要去污染別人的地盤。

決策流程圖

A[新工具/規則] --> B{別的專案用得到嗎?}
B -- 是 (通用) --> C[存放至 Global: ~/.gemini/]
B -- 否 (專屬) --> D[存放至 Workspace: .agent/]
C --> E[所有專案均可呼叫]
D --> F[僅限當前專案使用]

6. 官方沒說清楚的「御三家座位表」

Antigravity 的官方文件有時候寫得像繞口令，為了節省大家的時間，我直接幫各位整理好了這份「資源配置懶人包」。照著這個路徑放，AI 實習生保證能精準找到他的座位。

6.1 Rules (規則)

• Global: ~/.gemini/GEMINI.md (你的全域大原則，例如：永遠使用繁體中文回覆)。
• Workspace: <workspace>/.agent/rules/ (專案特定規範，例如：此專案必須符合 ESlint 規範)。

6.2 Workflows (流程)

• Global: ~/.gemini/antigravity/global_workflows/
• Workspace: <workspace>/.agent/workflows/

6.3 Skills (技能)

• Global: ~/.gemini/antigravity/skills/
• Workspace: <workspace>/.agent/skills/

💡 分析與洞察：
這種「層級式」的配置結構，本質上是借鏡了作業系統的環境變數概念。優點在於「高內聚、低耦合」：當你更新全域 Skill 時，所有專案都能同步升級；而當你調整專案細節時，又不會影響到其他實驗中的專案。

7. 進階玩家的自律：Skill 最小化與專案地圖

當你開始習慣這套架構後，工具會長得很快。這時候，你需要兩招「防腐劑」來維持系統的健康。

7.1 Skill 最小化原則 (The LEGO Principle)

不要試圖寫一個「萬能 Skill」。一個好的 Skill 應該像一塊樂高積木：只做一件事，並把它做到最好。

• 結構清晰：每個 Skill 資料夾內應包含 SKILL.md (說明書) 與 scripts/ (實際執行的程式碼)。
• 易於替換：如果這個功能壞了，你可以直接拔掉它而不影響整個 Workflow。

<skill-name>/
├── [SKILL.md](http://skill.md/)           # 必須：含 YAML frontmatter
├── scripts/           # 可選：可執行程式碼
├── examples/          # 可選：範例實現
└── resources/         # 可選：模板與資源

7.2 建立你的專案地圖 (MAP.md)

當你的御三家多到你開始忘記誰是誰時，這就是危險訊號。進階玩家會寫一個簡單的小腳本，自動掃描所有 Global / Workspace 的 Rules/Workflows/Skills 目錄，並生成一份 MAP.md 索引檔案。

這份地圖就像是專案的導覽手冊，不管是為了幾個月後失憶的自己，還是為了要接手你爛攤子的同事，這都是最慈悲的舉動。

8. 分析與洞察：為什麼結構化思維是 AI 時代的必備技能？

在過去，我們寫程式是為了給編譯器看；現在，我們建立架構是為了給 AI 看。

當 AI 代理人（Agent）介入開發流程時，「資訊密度」與「檢索效率」決定了 AI 的智商。如果你的專案結構一團混亂，AI 就會像在垃圾堆裡找鑰匙，最後給你一個似是而非的答案。

優雅的秩序，不僅是為了美觀，更是為了讓 AI 能在最短的時間內，獲取最精確的上下文（Context）。

總結與建議

先定義好遊戲規則，AI 實習生才能幫你上分，而不是幫你挖坑。記住，優雅不是一種裝飾，而是從建立秩序的那一刻就開始了。

在調教 AI 時，請務必遵循 「由內而外」 的原則。

先寫好 Rules 確保他不會亂說話；再建立 Workflows 幫你處理雜事；最後才開發 Skills 讓他處理專業難題。如果你一上來就給他一堆 Skills 卻沒設定 Rules，你就會得到一個「很有本事但講話超沒禮貌」的怪才實習生。

別再把你的全能實習生當成拋棄式的聊天機器人了。花點時間把這三層結構理清楚，你會發現，他可能比你還懂你自己。

9. 參考文檔

[1] Agent Skills https://antigravity.google/docs/skills

[2] Rules & Workflows https://antigravity.google/docs/rules-workflows