Gemini CLI 建立 Skill 小記
今天來寫使用 gemini cli 建立 skill 小記
OS: macOS 26.3
Gemini CLI : 0.29.5
Agent skill 目前已經是標準做法, 目前各個 AI 工具也都支援 :)
主要是看到 Google 的 Youtube 影片 - Google Cloud Live: Unlocking Gemini CLI with Skills, Hooks & Plan Mode
起心動念來寫這篇小記 (同一時間 Gemini 也出了 3.1 ~~~ )
首先建立 gemini cli 建立 skill 也是有官方文件可以看
但是也許實作會是很快的方式
先請 nanobanana 產生一個架構概覽
簡單來說可以使用兩種方式建立
手動建立
使用 skill-creator 建立
直接啟用, 使用對談的方式來建立
與 gemini cli 對談達成目的後, 請 skill-creator 建立
主要方便的方式是使用 skill-creator 來建立
啟動 gemini 後, 可以直接要求
> 可否幫我建立 skill ?
可以使用對談的方式來建立
建立的 Skill 會有兩種儲存方式
使用者層級 - 套用到全域環境 ( ~/.gemini/skills )
專案層級 - 只針對該專案使用 ( ./.gemini/skills )
我個人喜歡放在專案層級使用然後找個地方 (GitLab / Github) 集中存放
Skill 的設定內容解釋可以直接問 gemini
每個 Skill 最核心的檔案就是 SKILL.md，它定義了這個 Skill 是什麼、什麼時候該被觸發，以及觸發後我（Gemini CLI）應該怎麼做。
SKILL.md 主要分為兩個部分：
1. Frontmatter (YAML 檔頭設定)
這部分放在檔案的最上方，是給 Gemini CLI 判斷何時要啟動這個 Skill 的關鍵資訊。它必須包含兩個欄位：
* `name`: Skill 的名稱。通常是簡短、以動詞開頭、由小寫字母和連字號組成的詞（例如：pdf-editor、analyze-logs）。
* `description`: Skill 的描述。這非常重要！這是判斷是否要使用這個 Skill 的唯一依據。描述應該要明確指出這 Skill 的功能，以及在什麼情況下應該被使用。必須寫在同一行。
* 好的範例：description: Data ingestion, cleaning, and transformation for tabular data. Use when Gemini CLI needs to work with CSV/TSV files to analyze large datasets...
2. Body (Markdown 內容指令)
在 YAML 檔頭之後，就是主要的 Markdown 內容。這部分是只有在 Skill 被觸發後，Gemini CLI 才會讀取的「專家指南」或「SOP 操作手冊」。
* 指令與步驟 (Instructions)：詳細告訴我該怎麼一步一步完成任務。例如：「先讀取哪個檔案」、「檢查什麼欄位」、「如果遇到錯誤該怎麼處理」。
* 參考資源 (References/Assets/Scripts)：如果有附帶其他的腳本、參考文件或圖片，這邊要告訴我在哪裡找，以及什麼時候該去讀取它們。
---
簡單的 `SKILL.md` 範例結構：
---
name: my-awesome-skill
description: 用於自動化格式化 Python 程式碼，當使用者要求整理 Python 專案時觸發。
---
# Python Code Formatter Skill
## 核心原則
- 永遠使用 `black` 和 `isort` 進行格式化。
- 在格式化之前，先檢查是否有語法錯誤。
## 執行步驟
1. 找出專案內所有的 `.py` 檔案。
2. 執行 `isort` 整理 import 順序。
3. 執行 `black` 統一程式碼風格。
可以使用 gemini 指令列出目前的 skills
% gemini skills list
Loading extension: bigquery-data-analytics
Loading extension: chrome-devtools-mcp
Loading extension: gcloud
Loading extension: nanobanana
Loading extension: observability
Discovered Agent Skills:
chrome-devtools [Enabled]
Description: Uses Chrome DevTools via MCP for efficient debugging, troubleshooting and browser automation. Use when debugging web pages, automating browser interactions, analyzing performance, or inspecting network requests.
Location: /Users/max/.gemini/extensions/chrome-devtools-mcp/skills/chrome-devtools/SKILL.md
price-comparator [Enabled]
Description: 比較 momo、PChome 24h、酷澎 (Coupang) 等電商平台的商品價格，專注於找出每單位（每 ml、每克、每片）的最低價。當使用者要求比價、尋找最便宜選項或分析跨平台優惠時使用。
Location: /Users/max/Downloads/local_lab/temp/.gemini/skills/price-comparator/SKILL.md
我有建立一個 skill 是去 momo / pchome 24h / Coupang 進行比價
範例操作如下
> 請幫我比較 零卡可樂在三個平台目前的價格
他會偵測到相關關鍵字然後詢問你要不要使用技能 : p
輸出結果參考
又前進一步
~ enjoy it
References
沒有留言:
張貼留言