Claude Skill 是什麼？讓 AI Agent 變聰明的秘密武器：深入解析 Claude Skill 與跨平台整合攻略

前言

你是否曾經遇過這樣的狀況：想要讓 AI 幫你處理專案中的特定任務，但是要把所有的背景知識、程式碼規範、API 文件全部塞進 Prompt 裡，結果發現 AI 的 Context Window 直接爆掉，或者 AI 開始因為資訊過載而胡言亂語？

這就像是你請了一位米其林大廚，但每次都要站在他旁邊碎碎念：「嘿，現在切洋蔥，然後炒蛋，記得加鹽…」大廚雖然厲害，但你每次都要講一遍，不只累死人，大廚也可能會漏聽。

為了解決這個問題，Claude (Anthropic) 推出了一個強大的概念——Claude Skill (Agent Skill)。這篇文章就是要帶你深入了解這是什麼黑科技，以及如何將它整合到你的專案中，讓每一位 AI Agent 都變成你的資深即戰力。

什麼是 Claude Skill？（生活化譬喻：廚房裡的秘密食譜）

如果要用最簡單的方式解釋 Claude Skill，我們可以把它想像成 「放在高級餐廳廚房架子上的食譜卡 (Recipe Cards)」。

一般的 Prompting (提示工程)：就像是你站在大廚 (AI) 旁邊口頭指導。
Claude Skills (Agent Skills)：這就是你把標準作業流程 (SOP) 寫成了食譜卡。

這些卡片平常收在檔案夾裡（檔案系統），大廚不需要把整本百科全書背下來 （節省 Context Window）。只有當你喊一聲「做個威靈頓牛排」時，大廚才會去架子上抽出那張特定的食譜卡，照著上面的步驟一步步做。

Skill 的核心結構

Skill 的結構其實非常簡單，它就是一個資料夾，裡面通常包含三個部分：

SKILL.md：這就是食譜本體。裡面寫著：「如果你要處理 PDF，第一步先這樣，第二步再那樣…」。
scripts/（選用）：像是廚房裡的專用削皮刀。這是具體的 Python 或 Bash 腳本，讓 AI 直接執行，不用自己瞎掰程式碼。
Metadata (YAML)：貼在食譜背脊上的標籤（名稱、描述），讓 AI 快速掃描就知道這本食譜是用來幹嘛的。

為什麼這能讓 Agent 變聰明？（架構優勢）

這運用了一個叫做 「漸進式揭露 (Progressive Disclosure)」 的心理學/技術概念。

沒用 Skill 前：你把所有專案的規則、程式碼規範、API 文件全部塞給 AI。AI 的腦容量 (Context Window) 瞬間爆炸。
用了 Skill 後：AI 起始狀態只知道「我有這些工具的清單 (Metadata)」。當遇到特定任務時，它才去「讀取」那份特定的 SKILL.md 進入大腦。

這讓你的 AI Agent 就像一個 「懂得查閱手冊的資深工程師」，而不是一個「試圖背下整個圖書館的書呆子」。

深入解析：Skill 的運作邏輯與格式

Claude Skill 的運作邏輯是將資訊分成三個層級，讓 AI 「只在需要的時候，拿需要的東西」：

層級	內容 (Content)	什麼時候載入 (When Loaded)	消耗 Token	生活化比喻
Level 1	Metadata (元數據) YAML 標籤：名稱、描述	永遠載入 (Always) 啟動時放入 System Prompt	極少 (~100 tokens)	餐廳菜單你看菜單就知道有這道菜，但還不用進廚房。
Level 2	Instructions (指令) `SKILL.md` 內的教學	被觸發時 (Triggered) AI 覺得需要時才用 Bash 讀取檔案	中等 (<5k tokens)	食譜卡確定要煮這道菜了，才把這張卡片拿出來看步驟。
Level 3	Resources & Code 脚本 (`.py`) 或參考資料	執行時 (As needed) 執行腳本或查閱特定文件	幾乎不佔只回傳執行結果	專用廚具拿出攪拌機打蛋，你只要結果，不需要把整台機器吞下去。

`SKILL.md` 格式範例

一個標準的 Skill 檔案由 YAML 檔頭和 Markdown 內容組成：

---
name: data-analyzer           # 規範：小寫、數字、連字號
description: Analyze data from CSV files and generate charts. Use when the user asks for insights from spreadsheets. # 規範：清楚描述「做什麼」與「何時用」
---

# Data Analyzer Skill

## Instructions
1.  首先，檢查使用者提供的 CSV 檔案路徑。
2.  使用 `scripts/analyze.py` 腳本來讀取資料。
3.  如果分析成功，請用繁體中文總結數據趨勢。

## Examples
User: "分析這個銷售報表"
Assistant: (執行 python scripts/analyze.py sales.csv)

如何打造「跨模型」的通用架構？

許多人的痛點是：「我不想要被 Claude 綁死！其他的 AI (如 Gemini, Cursor, VS Code Copilot) 怎麼辦？」

Claude Code 之所以能自動掃描，是因為它的 runtime 寫死了一段邏輯去遍歷 .claude/skills。其他的 Agent 就像是走進圖書館但沒有檢索系統的讀者。

要解決這個問題，我們可以建立一個 「技能總目錄 (Master Index)」。

解法一：建立 `SKILLS_INDEX.md`

在專案根目錄建立一個 SKILLS_INDEX.md 或 AGENTS_README.md，內容結構如下：

# AI Agent Skills Index
(注意：此專案包含模組化的 Agent Skills。當你遇到以下任務時，請讀取對應的 SKILL.md 檔案以獲取操作規範。)

## Available Skills

| 技能名稱 (Skill Name) | 資料夾路徑 (Path) | 功能描述與觸發時機 (Description & When to use) |
| :--- | :--- | :--- |
| PDF Processing | `skills/pdf-processing/SKILL.md` | 當使用者要求「讀取 PDF」、「提取表格」或「合併文件」時使用。 |
| Code Review | `skills/code-review/SKILL.md` | 當使用者要求「Review Code」、「檢查 PR」或「優化程式碼」時使用。 |

## How to use
1. 先閱讀上方的列表。
2. 根據使用者的 Prompt，判斷哪個 Skill 最相關。
3. 主動讀取 (Read) 該路徑下的 `SKILL.md` 內容進入 Context。

這就像是餐廳門口的「菜單」。Gemini 或 Cursor 只要一進專案讀到這個檔案，它就知道「喔！原來我有這些招式可以用」。

解法二：針對 Cursor 的特化解法 (`.cursorrules`)

如果你是用 Cursor，它有一個強大的特性叫做 .cursorrules。你可以把上述的索引邏輯直接寫進去，讓 Cursor 自動掛載 Skill。

You are an advanced AI coding assistant. This project utilizes a standardized "Agent Skills" architecture located in the `skills/` directory.

Before executing complex tasks, verify if a relevant skill exists:

[Skill List]
- name: pdf-processing
  path: skills/pdf-processing/SKILL.md
  description: Extract text and tables from PDF files.

Instruction:
If the user's request matches a skill's description, you MUST read the content of the corresponding `SKILL.md` file before proceeding.

解法三：自動化生成腳本

為了避免人工維護目錄的麻煩，你可以寫一個簡單的 update_skills_index.py 腳本，自動掃描所有 SKILL.md 的 YAML 檔頭，並生成 SKILLS_INDEX.md。

如何快速建立 Skill？

不想手寫 YAML 和 Markdown 怎麼辦？你可以用 「AI Skill」來生成「AI Skill」！

Anthropic 官方提供了一個 skill-creator Skill，它其實是一個 「訪問式 Wizard」。

安裝：把 skill-creator 資料夾放入你的 skills 目錄。
召喚：對 AI 說「嘿，我想建立一個新的 Skill，請用 skill-creator 幫我。」
互動：它會開始問你：「你想做什麼工具？」、「需要寫 Python 腳本嗎？」。
生成：對話結束後，它會自動幫你吐出標準格式的 SKILL.md 和資料夾結構。

這就像是你不用親自畫藍圖，而是叫一個「藍圖產生器機器人」幫你畫藍圖。

結論

Claude Skills (Agent Skills) 不僅僅是 Claude 的專屬功能，它更是一套開放的 Agent 協作標準。透過標準化的檔案結構與清楚的索引機制，我們可以讓這個強大的架構跨越模型限制，應用在任何 AI 開發環境中。

有了這套「數位員工操作手冊」，你的 Agent 就不再是只會胡言亂語的新手，而是隨時能查閱 SOP、精準執行任務的資深專家。現在就開始建立你的 Skill Standard Library 吧！