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

Skills

Skills 是可重複使用的知識包：一份說明「這類任務該怎麼做」的指引，加上需要的腳本與範本。和 Rules 不同，Skills 只在任務需要時才被載入，所以你可以放很多技能，卻不會塞爆代理的上下文。

資料夾結構

一個 skill 是一個資料夾，只有 SKILL.md 是必要的：

my-skill/
├── SKILL.md       # 必要：指引與中繼資料
├── scripts/       # 選用：可執行的腳本
├── examples/      # 選用：參考範例
└── resources/     # 選用：範本、schema、資料檔

SKILL.md 格式

檔案開頭是 YAML front matter：

---
name: code-review
description: 審查程式碼變更，檢查 bug、風格問題與最佳實務。在使用者要求審查 PR 或 diff 時使用。
---

# 程式碼審查

1. 先用 `git diff` 看變更範圍。
2. 依序檢查：正確性、錯誤處理、測試是否涵蓋、命名與風格。
3. 依嚴重度分組回報，並附上檔案與行號。

欄位	必要	說明
`name`	否	唯一識別名（小寫、用連字號）；省略時採用資料夾名稱
`description`	是	這個 skill 做什麼、何時使用

description 是代理判斷「現在要不要用這個 skill」的依據，所以要用第三人稱，並包含代理容易聯想到的關鍵字。

放在哪裡

範圍	位置
工作區（所有入口）	`.agents/skills/<資料夾>/`
全域（2.0 與 IDE）	`~/.gemini/config/skills/<資料夾>/`
全域（CLI）	`~/.gemini/antigravity-cli/skills/<資料夾>/`
外掛提供的	`~/.gemini/antigravity-cli/plugins/<外掛名>/skills/`

代理怎麼使用

代理採「漸進揭露」：先只看到所有 skill 的名稱與說明（發現），判斷相關時才讀完整內容（啟用），再照指示做（執行）。你也可以用 /<skill 名稱> 明確叫用，例如 /code-review。CLI 中用 /skills 管理。

從 Gemini CLI 過來？

工作區的 skills 必須從舊的 .gemini/skills/ 搬到 .agents/skills/，代理才會辨識。見從 Gemini CLI 遷移。