資料整理日期：2026-09-21
本頁的「AI skill」指 Agent Skill：給 AI agent 使用的可重用工作能力包。
一句話定義 #
AI skill 是一個可重用、可版本控制的指令與資源包，將某個專門任務的知識、工作流程、檢查清單和可選的程式工具，交給 AI agent 按需要載入並執行。
它不是一個新的 AI model，也不只是一次性的 prompt；它比較像是 AI agent 的「SOP + 專業工具包」。
Skill 通常包含什麼？ #
最核心的檔案是 SKILL.md：
- YAML frontmatter：至少包含
name和description - 主要指令：何時使用、輸入要求、工作步驟、輸出格式、完成前檢查
Skill 亦可以附帶：
scripts/：可執行的 helper scriptsreferences/：詳細文件、API notes、規格assets/：模板、圖片、範例、固定資源
AI agent 如何使用 skill？ #
- Discovery：啟動時只讀取每個 skill 的名稱和描述，保持 context 輕量。
- Activation：當使用者任務符合描述，agent 才載入完整
SKILL.md。 - Execution：agent 按指令執行，並在需要時讀取 references、使用 scripts 或 assets。
這種 progressive disclosure 讓 agent 可以安裝很多 skills，但只在相關時消耗完整 context。
為什麼有用？ #
| 好處 | 說明 |
|---|---|
| 一致性 | 把多步驟 SOP 固定下來，減少每次重新解釋的差異 |
| 專業化 | 補充公司、團隊或個人的 domain knowledge |
| 可重用 | 同一份 skill 可在多次任務、不同專案或相容的 agent 使用 |
| 可維護 | 可像程式碼一樣 version、review、測試和更新 |
| 可審核 | 清楚記錄 agent 應該怎樣做、輸出什麼、完成前檢查什麼 |
| 節省 context | 只在需要時載入完整工作流程 |
與其他 AI 元件的分別 #
| 元件 | 主要作用 |
|---|---|
| Model | 產生推理和文字的基礎 AI |
| Skill | 告訴 agent 某類任務應該怎樣做的可重用 SOP |
| MCP / tool | 連接外部資料、服務或操作能力 |
| Agent | 將 model、skills、tools 和 context 組合起來完成任務 |
| Prompt | 一次性的要求；skill 則是可以保存、重用和按需觸發的工作流程 |
Skill 可以呼叫或搭配 tools、MCP 和 scripts；它提供「怎樣做」的流程，tool 提供「能夠做什麼」的能力。
你的例子 #
- Taste：前端設計 taste、design system mapping、image-to-code、redesign 等流程。
- humanize：找出 AI writing patterns，重寫成自然語氣，再做 final anti-AI audit。
- superpowers：brainstorming、systematic debugging、TDD、writing plans、code review 和 verification 等軟體開發流程。
最小 Skill 範例 #
---
name: meeting-summary
description: Turn meeting notes into a concise decision log and action list.
---
# Meeting summary
1. Extract decisions, owners, deadlines, and unresolved questions.
2. Preserve uncertainty instead of inventing missing facts.
3. Return a decision table followed by action items.
4. Check that every action has an owner or is marked unassigned.
實際 skill 可以再加入 scripts、references 和 assets。
建立一個好 skill 的檢查清單 #
- 定義清楚的任務範圍和觸發描述
- 將重複流程寫成明確、可執行的步驟
- 指定輸入、輸出格式和完成前驗證
- 把長文件和程式碼放到 references/scripts，不要把
SKILL.md寫成巨型百科全書 - 對 scripts、網路存取、檔案修改和 secrets 設定最小權限
- 用真實案例測試 skill 是否會正確觸發和完成
- 為重大修改更新版本並保留來源
限制與注意事項 #
Skill 是指令和資源，不是安全保證，也不會自動令 model 變得更聰明。仍然需要檢查輸出、程式碼、外部操作和權限。包含 shell commands、網路請求或檔案寫入的 skill，尤其要先 review 其行為再啟用。
參考來源 #
| 來源 | 重點 |
|---|---|
| Agent Skills overview | 開放格式、SKILL.md 結構、progressive disclosure、跨產品重用 |
| OpenAI API Skills | versioned bundle、SKILL.md manifest、上傳與使用規則 |
| OpenAI Codex Build Skills | Codex 的 skill 目錄、建立方式及 name/description 要求 |
| Claude Code Skills | skill 的建立、載入位置、觸發和 supporting files |