跳至主要内容

Gemini Skills 建立與規範指南

在蛋蛋村的技術演進中，Skill (技能) 是 AI 助手的靈魂。本篇將根據官方規範，詳細拆解 Gemini Skills 的標準結構與建立流程，讓你能夠精準地為 AI 注入特定領域的知識。

1. 快速開始：使用 skill-creator​

建立新技能最推薦的方式是使用內建的 skill-creator 技能。你只需向 Gemini CLI 下達指令即可。

範例指令：

"create a new skill called 'code-reviewer'"

Gemini CLI 將會自動執行以下步驟：

  1. 為你的技能產生一個新目錄 (例如 code-reviewer/)。
  2. 建立包含必要 YAML 元數據 (name 與 description) 的 SKILL.md 檔案。
  3. 建立標準資源目錄：scripts/、references/ 與 assets/。

2. 手動建立技能​

如果你偏好手動建立：

  1. 建立目錄：為你的技能建立一個目錄 (例如 my-new-skill/)。
  2. 建立 SKILL.md：在該目錄根目錄下建立此檔案。

3. 技能結構規範​

一個技能目錄的核心是位於根目錄的 SKILL.md 檔案。

3.1 目錄結構建議​

雖然只有 SKILL.md 是必要元件，但建議遵循以下結構來組織資源：

my-skill/
├── SKILL.md       (必要) 指令與元數據
├── scripts/       (選用) 可執行腳本
├── references/    (選用) 靜態文件或參考資料
└── assets/        (選用) 範本或其他資源

3.2 SKILL.md 檔案格式​

SKILL.md 使用 YAML frontmatter 定義元數據，並以 Markdown 撰寫指令。

標準範本：

---
name: code-reviewer
description: 使用此技能進行程式碼審查。支援本地變更與遠端 Pull Requests。
---

# Code Reviewer (技能名稱)

此技能引導代理執行徹底的程式碼審查。

## 運作流程 (Workflow)

### 1. 確定審查目標
- **遠端 PR**：如果使用者提供 PR 編號或網址...
- **本地變更**：如果變更在本地...
  • name：技能的唯一識別碼，必須與目錄名稱一致。
  • description：描述技能的功能以及 Gemini 何時應該使用它。
  • 本文 (Body)：包含引導代理行為的詳細指令。

4. 撰寫要點 (技術史官的建議)​

4.1 職責邊界清晰​

不要試圖讓一個 Skill 處理所有事情。例如 egg-village-news-reporter 就專注於新聞，而 egg-village-finance-analyst 則專注於金融數據。

4.2 結構化運作流程​

在指令中使用清晰的標題（如 ## Workflow）定義步驟，這能極大地提高 AI 執行的準確性。

4.3 資源利用​

善用 references/ 目錄存放領域知識，或在 scripts/ 中放置自動化腳本，讓技能不只是「對話」，更能「執行」。