Claude Code Skills 教學：讓 AI 記住你的 SOP
文 / Coolkid發布：2026-07-22閱讀約 6 分鐘
短答給趕時間的人：Skill 是 Claude Code 的知識外掛，一個資料夾裡放一份 SKILL.md，也就是你的做事方法說明書，AI 碰到對得上的任務會自動翻出來照做。跟 CLAUDE.md 的差別在載入方式：CLAUDE.md 每場都讀，放通用規則;skill 按需載入，放特定情境的完整 SOP，所以 skill 可以寫很長，卻不佔平常的腦容量。第一個 skill 20 分鐘能寫好，而且可以叫 AI 幫你寫。
我發現自己每次要 AI 寫社群貼文，都要重新交代一次語氣規則。
別用啟發體、數字要具體、結尾別雞湯。每次講，每次漏。後來我把整套規則寫成一個 skill。
現在只要說「寫篇貼文」，Claude Code 自己會把規則翻出來套。
這篇講 skill 是什麼、跟 CLAUDE.md 怎麼分工、第一個 skill 怎麼寫。
Skill 是什麼？跟 CLAUDE.md 差在哪？
兩個都是「把你的要求變成 AI 的預設行為」。差在載入方式。
CLAUDE.md 是常駐，每次開場都整份讀進腦裡，適合放每場都需要的通用規則，像語言、專案背景、禁區。
skill 是按需，平常只記得「有這個技能，是幹嘛用的」，那是一行描述。
碰到對得上的任務，才把整份內容翻出來。
| 面向 | CLAUDE.md | Skill |
|---|---|---|
| 載入時機 | 每場開工全文讀 | 對到任務才展開 |
| 適合放 | 每場都要的通用規則 | 特定情境的完整 SOP |
| 長度 | 要精簡 (常駐佔腦容量) | 可以很長 (平常只佔一行) |
| 範例 | 回覆用繁中 / 別動 legacy 資料夾 | 寫貼文的完整語氣手冊 / 部署流程 SOP |
| 生效範圍 | 所在專案資料夾 | 個人層級或專案層級都可 |
判斷口訣其實很簡單。
這條規則「每場都用得到」就進 CLAUDE.md;「特定任務才用得到、但一用就要整套」就寫成 skill。
我的實例：「回覆用繁中」在 CLAUDE.md。
「寫 SEO 文章的完整規範」是幾千字的檢查清單，做成一個 skill。寫文章時才需要，平常帶著純浪費。
20 分鐘，第一個 skill 怎麼寫？
一個 skill 最小只需要兩樣：一個資料夾，加裡面一份 SKILL.md。
放在個人層級的 skills 資料夾(所有專案通用)，或專案的 .claude/skills/(跟著專案走)。
SKILL.md 的骨架大概長這樣：
---
name: social-post
description: 幫我寫社群貼文時使用。包含語氣規則、格式、禁區。
---
# 社群貼文 SOP
## 語氣
- 直接、口語，像跟朋友講話
- 每篇至少一個具體數字
- 不用「勢必」「賦能」這類書面詞
## 格式
- 第一行就是重點，不鋪陳
- 全文 500 字內，分 3-4 段
## 禁區
- 不寫「這給我們的啟示是」式雞湯結尾
- 不保證任何成效最關鍵的一行是開頭的 description。
AI 靠這一行判斷「現在這個任務，要不要翻這本手冊」。
寫法是講清楚「什麼時候用」加「涵蓋什麼」，像上面那樣具體。
如果寫得太模糊會怎樣？
像「關於寫作的技能」這種，AI 永遠對不上，skill 就變成裝飾品。
還有一個偷吃步。整個 skill 可以叫 Claude Code 幫你寫。
「我每次要你做 X 都要交代這些規則(貼上你常講的話)，幫我整理成一個 skill，放到 skills 資料夾」。
寫完之後怎麼確認有沒有生效？
開新對話、丟一個相關任務，看它有沒有自動照規矩來。
沒有就回頭把 description 寫得更明確。
3 個常見寫壞法(我都犯過)
- 寫成教科書。skill 裡塞滿背景知識跟理論，但 AI 要的是「可執行的步驟跟判斷標準」。改法：每條規則都寫成「做什麼、不做什麼」，能給範例就給對照(❌ 這樣寫 / ✅ 那樣寫)。
- description 太模糊。「內容創作技能」對不上任何具體任務。改法：把觸發情境寫進去，像「幫我寫社群貼文、想標題、改文案時使用」。你會怎麼跟它說話，就把那些關鍵詞寫進 description。
- 一個 skill 包山包海。寫作、部署、回報全塞一包，結果每個情境都載入一堆不相關的規則。改法：一個 skill 管一件事，寧可拆三個小的。
檢驗標準：新對話不提任何規則，只說「寫篇貼文」。它自動守你的規矩，skill 才算寫成了。
Skill 是 Claude Code 的知識外掛：資料夾加一份 SKILL.md，把特定情境的完整 SOP 寫成說明書，AI 對到任務自動翻出來照做。跟 CLAUDE.md 的分工：每場都要的通用規則放 CLAUDE.md(常駐、要精簡)，特定任務的整套方法寫 skill(按需載入、可以很長)。第一個 skill 20 分鐘：一個資料夾加一份 SKILL.md，frontmatter 的 description 最關鍵，要寫清楚什麼時候用，也可以直接叫 AI 幫你生成。3 個寫壞法：寫成教科書(要可執行步驟)、description 模糊(永遠不會觸發)、包山包海(一個 skill 管一件事)。檢驗方式：新對話不提規則，它自動照做才算成。
名詞解釋
- skill（技能包）
- Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- context（上下文視窗）
- AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- 提示詞（prompt）
- 你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- 命令列（CLI, Command Line Interface）
- 用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
如果內容對你有用就太好了
隨喜斗內
相關文章
常見問題FAQ
Claude Code 的 skill 是什麼？
AI 的知識外掛：一個資料夾放一份 SKILL.md，把你某類任務的做事方法(語氣規則、流程步驟、檢查清單)寫成說明書。AI 平常只記得「有這個技能」的一行描述，碰到對得上的任務才把整份翻出來照做，所以內容可以很詳細，卻不佔平常的腦容量。效果是同樣的規矩不用每個新對話重教一遍。
Skill 跟 CLAUDE.md 差在哪？該用哪個？
載入方式不同：CLAUDE.md 每場開工全文讀(常駐)，適合每場都需要的通用規則，要精簡;skill 按需載入，適合特定情境的完整 SOP，可以很長。判斷口訣：「每場都用得到」進 CLAUDE.md，「特定任務才用、一用就要整套」寫 skill。舉例來說，「回覆用繁中」放 CLAUDE.md，「寫文章的三千字規範手冊」做成 skill。
不會寫程式能自己做 skill 嗎？
能，skill 本體就是一份 Markdown 文字檔，沒有半行程式。更省力的做法是叫 Claude Code 幫你生：「我每次要你做 X 都要交代這些(貼上你常講的規則)，幫我整理成 skill 放到 skills 資料夾」。你要做的只有驗收：開新對話丟相關任務，看它是否自動照規矩;沒觸發就把 description 改具體一點。
為什麼我寫的 skill 都沒有被觸發？
9 成是 description 寫太模糊。AI 靠 description 那一行判斷「這個任務要不要翻這本手冊」，而「內容創作相關」對不上任何具體任務。改法：把你實際會說的話寫進去，例如「幫我寫社群貼文、想標題、改文案時使用」。另外檢查檔案位置(個人層級 skills 資料夾或專案 .claude/skills/)跟 SKILL.md 的 frontmatter 格式(--- 包起來的 name 加 description)有沒有寫對。
看完這篇之前先確認:
- 同樣的做事方法每個新對話都要重新教一遍
- 想把自己的 SOP 變成 AI 自動會的能力
- 聽過 skills 但不知道跟 CLAUDE.md 差在哪
- 連 CLAUDE.md 都還沒用過 (先從那個開始，門檻更低)
- 想找現成 skill 商店一鍵安裝 (主要還是自己寫)
- 想教 AI 寫程式技巧 (它本來就會，skill 教的是你的流程)