Claude Code Skill 系統
Claude Code Skill 系統
定義
Skill 是 Claude Code 的結構化知識文件（SKILL.md），存放於 .claude/skills/{skill-name}/ 目錄下，定義 AI 在特定任務上應遵循的規範、流程和品質標準。Skill 在被觸發時才載入（與 CLAUDE.md 的每次載入不同），透過 frontmatter 的 name 和 description 定義觸發條件。
關鍵數據點（附來源）
- 寫作 Skill 約 560 行，涵蓋 SEO 研究 + 寫作原則 + AI 味清單 + FAQ Schema + 品質評分（來源：寫作流程文章）
- 程式碼審查的 Skill 包含分級 checklist（CRITICAL/HIGH/MEDIUM/LOW）+ 正確/錯誤程式碼對照（來源：Payload CMS 審查文章）
- Skill 可透過 GitHub Gist URL 一句話安裝，Claude Code 自動建資料夾和下載（來源：Skill 教學文章）
- Skill 可包裝 shell 腳本，讓 Claude Code 用自然語言呼叫底層工具（來源：Session 搜尋文章）
- SEO 健檢 Skill 整合三個外部數據源（GSC + Cloudflare + DataforSEO），五步流程各有明確的判斷標準（如 title 30-60 字元、content rate > 10%），示範了「多源數據整合 + 明確合格標準」的 Skill 設計模式（來源：SEO 健檢文章）
- 簡化版 Skill 只做站內 frontmatter 檢查，不依賴外部 API，是非技術用戶的實際起點（來源：SEO 健檢文章）
- 個人化學習 App 把教學設計拆成四個 skill（intake / syllabus / chapter / tutor），每個 skill 對應一個階段、只讀自己需要的檔案，第一版用一個巨大
learningskill 撐兩週就壞——不同階段的語氣／檔案需求互相干擾（來源：個人化學習工具文章） - Skills 之間的協作可以靠共享的脈絡檔案（intake.json、progress.json）達成，不需要把所有規則塞進同一份 SKILL.md（來源：個人化學習工具文章）
前提與局限性
- Skill 的品質完全取決於撰寫者——寫得太嚴格會限制 AI 靈活性，太鬆散則回到「每次都要重新交代」
- 目前 Skill 的生態系尚在早期，公開可用的 Skill 資源有限
- Skill 文件太大時（如超過 1000 行），AI 可能無法完整載入或遺漏部分規則
- 非工程師需要理解 Markdown 和 frontmatter 的基本概念才能修改 Skill
- Skill 需要隨框架版本、工具更新而維護，過時的 Skill 可能產生錯誤指引
衝突標記
- 寫作 Skill 強調「去除 AI 味」和「注入人味」是兩件不同的事，但 Skill 的規則化本質可能讓「注入人味」變成另一種公式
- 「一個 Skill 搞定所有事」vs「拆分多個小 Skill 各司其職」——Payload CMS 文章傾向後者（五個指令），寫作文章傾向前者（一份 560 行的 Skill）。個人化學習工具文章提供了「拆分」這一邊的踩坑實證：巨大 skill 兩週就因階段間 prompt 互相干擾而壞掉。判斷準則可能是：工作流是否需要在不同階段切換截然不同的語氣 / 檔案讀寫對象——是的話用拆分，不是的話用整合
關聯概念
- [[CLAUDE.md 與記憶機制]]
- [[Claude Code 三層架構]]
- [[AI 輔助寫作流程]]
- [[非工程師的 AI 工具採用]]
- [[品質評分機制]]
- [[脈絡檔案貫穿設計]]——多個 Skill 之所以能無縫協作的底層機制
- [[教學設計模組化]]——Skill 系統在教學設計領域的具體應用