Skill 建置與使用

10. Skill 建置與使用

Skill 是給 Claude 的「操作手冊」——告訴它「什麼時候」該用這份手冊、「怎麼做」這個任務。 您剛剛建這個 Obsidian vault 時，我用過好幾個 skill（pdf、xlsx 等）。

---

10.1 Skill 是什麼

對比	改變 Claude 的什麼	例
Skill	怎麼想 / 怎麼做（方法論）	「會議記錄整理」skill 規範格式
Slash Command	一鍵呼叫某功能	/engineering:debug
MCP Server	能做什麼（連外部系統）	Slack MCP 讓 Claude 收發訊息
內建工具	Claude 自帶能力	Read / Write / Bash

核心邏輯：Skill 改變思維方式，MCP 改變能力範圍。

---

10.2 在哪裡用

✅ 三大平台都支援：

平台	放位置
Cowork（您用的）	內建 + 可自製，全域
Claude Code	.claude/skills/ 專案內，或 ~/.claude/skills/ 全域
Claude API	上傳自訂 skill，用 skill_id 指定

---

10.3 Anthropic 官方內建 Skills

您現在 Cowork 已經有的：

Skill	副檔名	功能
anthropic-skills:docx	.docx	建立 / 編輯 Word 文件
anthropic-skills:pptx	.pptx	建立簡報
anthropic-skills:xlsx	.xlsx	建立試算表、分析資料
anthropic-skills:pdf	.pdf	產 PDF、填表單、提取文字
anthropic-skills:skill-creator	—	建立 / 改進新 skill
productivity:task-management	自訂	管理任務清單

💡 您剛才寫這個指南時，我背景就在用 anthropic-skills 系列的 markdown 處理能力。

---

10.4 SKILL.md 規範（核心！）

每個 Skill 都是個資料夾，內含 SKILL.md（必要）+ 其他輔助檔。

最簡範例

---
name: meeting-notes-organizer
description: |
  當使用者要整理會議記錄、摘要會議重點、產生待辦清單、
  或追蹤行動項目時使用。
 
  使用場景：
  - 從語音逐字稿/筆記提取重點
  - 產生決議事項清單
  - 分配責任人和截止日期
 
  觸發詞：「整理會議記錄」、「會議摘要」、「會議行動項目」、
  「總結會議」、「會議記錄」
---
 
# 📋 會議記錄整理 Skill
 
## 您的工作流程
（這裡寫 Claude 該怎麼做）

必要欄位

欄位	必填	說明
name	選	短名稱
description	必	Claude 判斷何時觸發的關鍵
disable-model-invocation	選	true = 只能明確呼叫，不自動觸發
allowed-tools	選	限制此 skill 可用工具

---

10.5 Description 寫法（決定一切！）

❌ 不好

description: 整理會議記錄

→ Claude 不確定何時該用，可能漏觸發。

✅ 好

description: |
  當使用者需要整理會議記錄、摘要會議重點、產生待辦清單、
  追蹤行動項目時使用。包括：
  - 從語音逐字稿、筆記、文字檔提取重點
  - 產生決議事項清單
  - 指派責任人與截止日期
 
  觸發詞：「整理會議記錄」、「會議摘要」、「會議行動項目」、
  「整理會議重點」、「會議紀錄總結」

寫法訣竅

1. 列舉具體場景（「當…時」）
2. 舉 3-5 個觸發詞（同義詞要列全）
3. 說明輸出結果（讓 Claude 知道目的）

---

10.6 典型資料夾結構

.claude/skills/
└── meeting-notes-organizer/
    ├── SKILL.md              ← 必要：定義 + 主指令
    ├── TEMPLATES.md          ← 範本
    ├── BEST_PRACTICES.md     ← 最佳實踐
    ├── EXAMPLE_OUTPUT.md     ← 預期輸出範例
    └── reference/            ← (可選) 參考資料
        └── industry-terms.md

規則：

• 資料夾名稱用 kebab-case
• SKILL.md 是唯一必須檔
• 其他 .md 在 SKILL.md 中用相對路徑引用，Claude 會自動載入

---

10.7 手把手：建一個「PAM 退回原因檢查」Skill

步驟 1：建資料夾

mkdir -p ~/.claude/skills/pam-return-reason-check
cd ~/.claude/skills/pam-return-reason-check

步驟 2：寫 SKILL.md

---
name: pam-return-reason-check
description: |
  當 PAM 系統的審核主管要退回考核案件時，協助檢查退回原因
  是否清楚、可執行、符合規範。
 
  使用場景：
  - 主管寫好退回原因後請 AI review
  - 大量退回前批次檢查文字
  - 培訓新進主管的退回語氣
 
  觸發詞：「檢查退回原因」、「review 退回理由」、
  「退回說明檢查」、「PAM 退回語氣」
---
 
# 🔄 PAM 退回原因檢查 Skill
 
## 任務
 
依下列規則檢查退回原因文字：
 
### 必要要素（缺一即不通過）
 
1. **明確指出問題**：「分數錯誤」太模糊；「事假超過 14 天但未列入天花板計算」清楚
2. **提供改進方向**：「請重新評估」太空；「請依 GradingService.CalcCeiling 重算」具體
3. **語氣專業**：避免人身字眼（「您怎麼會這樣寫」）、避免威脅性語言
 
### 加分要素
 
4. 引用規格文件章節
5. 給出案例或範例分數
6. 提供與部屬溝通的話術建議
 
## 輸出格式
 
```markdown
## 檢查結果：✅ 通過 / ⚠️ 需調整
 
### 評分（1-5 顆星）：⭐⭐⭐⭐
 
### 三點建議
1. ...
2. ...
3. ...
 
### 改寫版（如需）
[改寫後的版本]

參考資料

詳見 超額說明歷程 第 3 節。

### 步驟 3：測試觸發

在 Cowork / Claude Code：

請幫我檢查這段退回原因： 「分數有問題，請重新評估」

→ Claude 應該自動呼叫此 skill 並回報「太模糊」。

---

## 10.8 Skill 觸發機制

| 機制 | 行為 |
|------|-----|
| **自動觸發** | Claude 看到符合 description 的訊息就呼叫 |
| **手動觸發** | `/pam-return-reason-check` 明確呼叫 |
| **MANDATORY TRIGGERS** | description 中的「觸發詞」是 Claude 強制觸發的線索 |

如果想**只**讓使用者明確呼叫（如敏感操作）：

```yaml
disable-model-invocation: true

→ Claude 不會自動套用，只能 /skill-name 才用。

---

10.9 Skill vs Plugin

Plugin（包裝盒）
├── Skills（多個 skill）
├── MCP Connectors（外部連接）
├── Slash Commands（快捷）
└── Sub-agents（子代理）

何時用 Plugin：

• 有多個 skill 想一起發佈（例：「PAM 開發套件」含 5 個 skill）
• 包含 MCP server
• 給整個團隊用

簡單做法：先寫 skill，需要分享才包成 plugin。

---

10.10 用 skill-creator 快速建立

在 Cowork

請用 skill-creator 幫我建立一個「主管教育訓練投影片產生器」skill

skill-creator 會問：

• Skill 名稱
• 觸發場景（3-5 個）
• 預期輸出格式
• 觸發詞

最後產出可直接放到 .claude/skills/ 的完整資料夾。

4 個模式

1. Create：從零產初版
2. Eval：測試觸發是否正確
3. Improve：對失敗的觸發詞調整 description
4. Benchmark：對比新舊版觸發準確度

---

10.11 進階：在 Skill 中呼叫 Sub-agent

可以！但要在 SKILL.md 明寫：

## 流程
 
1. 初步檢查（本 skill 執行）
2. 深度分析（呼叫 sub-agent）

/engineering:legal-review

3. 整合報告（本 skill 彙整）

何時用 sub-agent：

• 需特定領域專家（法務、安全）
• 流程超出本 skill 職責
• 要二次驗證

詳見 12-Agent 建置與使用。

---

10.12 發佈與分享

給同事用

# 1. 確認資料夾完整
ls .claude/skills/your-skill/
 
# 2. 打包
zip -r your-skill.zip .claude/skills/your-skill/
 
# 3. 同事解壓到 .claude/skills/ 即可

發佈到 Anthropic Marketplace

1. 確保品質（description 清晰、有範例、5+ 觸發詞）
2. push 到 GitHub
3. 提 PR 至 anthropics/skills
4. 審核通過後上線

---

10.13 排錯 FAQ

Q	解
Skill 沒被自動觸發	description 加觸發詞、列舉場景；用 skill-creator Improve
檔案路徑錯亂	SKILL.md 引用同目錄檔案用相對路徑 TEMPLATES.md，不要 ./
Skill 需 API key	不要寫死，改用環境變數或 MCP server
Skill 名衝突	改 name 欄位，避免跟既有 skill 撞名
怎麼測試？	1. 啟動 Cowork / Claude Code → 2. 對話用觸發詞 → 3. 看是否顯示 [Using skill: xxx]

---

10.14 PAM 場景的 Skill 點子

1. PAM 退回原因檢查（上面範例）
2. PAM 規格速查：「給我 GradingService 的 CalcGrade 規則」→ skill 直接從 PAM 文件回答
3. PAM SOP 撰寫器：給情境，產 SOP 範本
4. PAM 等第模擬器：輸入分數 / 出勤 / 獎懲，算最終等第
5. PAM 主管教練：模擬退回對話，幫主管練習溝通
6. PAM 客訴回覆：員工抗議考核 → 產合規回覆草稿

---

10.15 官方資源

• Skills 文件
• Skill authoring best practices
• Anthropic 官方 Skills GitHub
• Complete Guide to Building Skills

---

下一章 → 11-MCP 建置與使用 上一章 ← 09-Claude Code 建置與使用 回到 Claude 學習指南目錄