一個例子帶你看懂，火爆全網的 Skills 到底是啥。
整理版優先睇
速讀
5 個重點
高亮
Skills 係 AI Agent 嘅可重用操作手冊，按需加載令佢更聰明
整理版摘要
呢篇文章嘅作者十二係專注分享 AI 編程內容嘅創作者，佢用 Antigravity 嘅 smart-commit 技能做例子，解釋 Skills 到底係乜嘢。傳統上，AI 只係根據即時 prompt 執行任務，但 Skills 係一套預先寫好嘅操作手冊，包含判斷邏輯、SOP 流程同腳本，令 AI 可以自動完成複雜工作流程，例如按照 Conventional Commits 規範生成 commit message 並執行 lint 檢查。
文章指出 Skills 嘅核心係「按需加載」：AI 唔會一次過讀曬所有手冊，而係根據任務描述決定係咪需要調用特定技能。呢個設計避免 Context Window 被無關資訊佔用，令 AI 既聰明又高效。作者強調，Skills 唔係簡單嘅 prompt 模板，而係可以沉澱經驗、固化流程嘅能力包，令開發者從「寫程式」升級到「定義生產力」。最後佢鼓勵讀者將常用工作流寫成 Skills，打造屬於自己嘅 AI 軍團。
- Skills 係 AI Agent 嘅操作手冊，包含判斷邏輯、SOP 同腳本，唔係普通 prompt 模板。
- 按需加載機制：Agent 只會根據描述決定係咪載入技能，避免 Context Window 爆滿。
- 創建 Skills 只需一個文件夾加一個 SKILL.md 文件，YAML 頭部嘅 description 係關鍵，決定觸發時機。
- 進階可以加入 scripts、examples 等資源，令 AI 可以執行自訂腳本，擴展能力。
- 喺 AI 編程時代，「定義生產力」比「寫程式」更重要，Skills 係沉澱最佳實踐嘅容器。
值得記低
smart-commit 技能模板
Antigravity Skills 的 SKILL.md 範例，包含 YAML 頭部與步驟說明，可按需修改成自己嘅工作流。
整理重點
一個例子：Smart Commit 技能
作者十二用一個具體例子說明 Skills 嘅威力。佢有個項目對 Git 提交記錄要求好嚴，必須符合 Conventional Commits 規範，提交前仲要行 Lint 檢查。以前佢要自己行 command，再叫 AI 生成 commit message，錯咗又要鬧佢重寫。
呢個例子清楚顯示 Skills 點樣將多步驟工作流變成一句指令，大幅提升效率。
整理重點
Skills 本質：操作手冊 vs 即時指令
作者用生動比喻解釋 Skills：如果 Antigravity 嘅 Agent 係實習生，Prompt 就係隨口吼嘅指令，而 Skills 就係一本 操作手冊。關鍵係 Skills 做到 按需加載：Agent 唔會一次過記曬所有手冊（因為咁樣會佔用太多 Context Window），而係先睇手冊目錄（即係 Skill 嘅 description），只有覺得「呢個任務似乎要用到第 5 章」嘅時候，先至將詳細內容調入大腦。
簡單嚟講，Skills 係一套包含 判斷邏輯、SOP 流程甚至腳本代碼 嘅完整能力包，唔係單次 prompt 可以比擬。
整理重點
手把手創建你的第一個 Skills
- 1 決定存放位置：Workspace skills 放喺 <code>.agent/skills/<skill-folder>/</code>，適合項目特定流程；Global skills 放喺 <code>~/.gemini/antigravity/skills/<skill-folder>/</code>，適合通用工具。
- 2 創建文件夾同 SKILL.md：例如 <code>.agent/skills/smart-commit/SKILL.md</code>。
- 3 寫好 YAML 頭部：<code>name</code> 同 <code>description</code> 係必需，description 要用第三人稱清楚講明技能用途同觸發條件。
- 4 喺 SKILL.md 主體寫步驟：用 markdown 寫清楚 SOP，例如檢查狀態、編寫消息、執行命令。
- 5 可以加入 scripts、examples 等子文件夾，擴展技能能力。
---
name: smart-commit
description: 當用戶想要提交代碼 (git commit) 時使用此技能。它會自動遵循 Conventional Commits 規範。
---
# Smart Commit 技能指南
當用戶要求提交代碼時，請嚴格遵循以下步驟：
## 1. 檢查狀態
首先運行 `git status` 查看變更。
## 2. 編寫消息
根據變更內容，生成符合 Conventional Commits 的消息。
格式要求：
<type>(<scope>): <subject>
- feat: 新功能
- fix: 修補 bug
- docs: 文檔改變
- style: 代碼格式改變
## 3. 執行
生成命令供用戶確認，或者直接執行 git commit。YAML 頭部嘅 description 極其重要，佢係 Agent 嘅目錄，決定幾時觸發技能。如果寫得差，SOP 寫得再好都冇用。
重啟 Agent 對話後，試嚇叫佢調用你嘅 Skills，你會發現佢更加「懂你」了。
整理重點
進階玩法同總結：升級到 AI 軍團指揮官
除咗 SKILL.md，你可以喺技能文件夾加入 scripts/、examples/、resources/ 等子目錄，提供輔助腳本、參考實現同模板。例如喺 smart-commit 放一個 check_code.py，然後喺 SKILL.md 話：「步驟 2：請運行 scripts/check_code.py 進行代碼檢查。」咁樣 AI 就變成一個識用工具嘅工程師。
- scripts：放 Python、Shell 等腳本，俾 AI 執行具體操作。
- examples：放範例輸出或用法，幫 AI 更好理解預期結果。
- resources：放模板或其他資產，例如 commit message 模板。
立即打開 Antigravity，創建你嘅第一個 Skills 啦！
<workspace-root>/.agent/skills/<skill-folder>/~/.gemini/antigravity/skills/<skill-folder>/.agent/skills/
└─── my-skill/
└─── SKILL.md---
name: smart-commit
description: 當用戶想要提交代碼 (git commit) 時使用此技能。它會自動遵循 Conventional Commits 規範。
---
# Smart Commit 技能指南
當用戶要求提交代碼時，請嚴格遵循以下步驟：
## 1. 檢查狀態
首先運行 `git status` 查看變更。
## 2. 編寫消息
根據變更內容，生成符合 Conventional Commits 的消息。
格式要求：<type>(<scope>): <subject>
- feat: 新功能
- fix: 修補 bug
- docs: 文檔改變
- style: 代碼格式改變
## 3. 執行
生成命令供用戶確認，或者直接執行 git commit。.agent/skills/my-skill/
├─── SKILL.md # 主要說明（必填）
├─── scripts/ # 輔助腳本（可選）
├─── examples/ # 參考實現（可選）
└─── resources/ # 模板和其它資產（可選）步驟 2：在生成消息前，請先運行當前目錄下的 python scripts/check_code.py 進行代碼檢查。
<workspace-root>/.agent/skills/<skill-folder>/~/.gemini/antigravity/skills/<skill-folder>/.agent/skills/
└─── my-skill/
└─── SKILL.md---
name: smart-commit
description: 當用戶想要提交代碼 (git commit) 時使用此技能。它會自動遵循 Conventional Commits 規範。
---
# Smart Commit 技能指南
當用戶要求提交代碼時，請嚴格遵循以下步驟：
## 1. 檢查狀態
首先運行 `git status` 查看變更。
## 2. 編寫消息
根據變更內容，生成符合 Conventional Commits 的消息。
格式要求：<type>(<scope>): <subject>
- feat: 新功能
- fix: 修補 bug
- docs: 文檔改變
- style: 代碼格式改變
## 3. 執行
生成命令供用戶確認，或者直接執行 git commit。.agent/skills/my-skill/
├─── SKILL.md # 主要說明（必填）
├─── scripts/ # 輔助腳本（可選）
├─── examples/ # 參考實現（可選）
└─── resources/ # 模板和其它資產（可選）步驟 2：在生成消息前，請先運行當前目錄下的 python scripts/check_code.py 進行代碼檢查。