Claude Code Skills 教學:讓 AI 記住你的 SOP
先講重點
短答給趕時間的人:Skill 是 Claude Code 的知識外掛 — 一個資料夾裡放一份 SKILL.md(你的做事方法說明書),AI 碰到對得上的任務會自動翻出來照做。跟 CLAUDE.md 的差別:CLAUDE.md 每場都讀(放通用規則),skill 按需載入(放特定情境的完整 SOP),所以 skill 可以寫很長卻不佔平常的腦容量。第一個 skill 20 分鐘能寫好,而且可以叫 AI 幫你寫。
我發現自己每次要 AI 寫社群貼文,都要重新交代一次語氣規則:別用啟發體、數字要具體、結尾別雞湯⋯每次講、每次漏。後來把整套規則寫成一個 skill,現在只要說「寫篇貼文」,它自己會把規則翻出來套 — 這篇講 skill 是什麼、跟 CLAUDE.md 怎麼分工、第一個 skill 怎麼寫。
Skill 是什麼?跟 CLAUDE.md 差在哪?
兩個都是「把你的要求變成 AI 的預設行為」,差在載入方式:CLAUDE.md 是常駐 — 每次開場都整份讀進腦裡,適合放每場都需要的通用規則(語言、專案背景、禁區);skill 是按需 — 平常只記得「有這個技能跟它是幹嘛的」(一行描述),碰到對得上的任務才把整份內容翻出來。
| 面向 | CLAUDE.md | Skill |
|---|---|---|
| 載入時機 | 每場開工全文讀 | 對到任務才展開 |
| 適合放 | 每場都要的通用規則 | 特定情境的完整 SOP |
| 長度 | 要精簡 (常駐佔腦容量) | 可以很長 (平常只佔一行) |
| 範例 | 回覆用繁中 / 別動 legacy 資料夾 | 寫貼文的完整語氣手冊 / 部署流程 SOP |
| 生效範圍 | 所在專案資料夾 | 個人層級或專案層級都可 |
判斷口訣:這條規則「每場都用得到」→ CLAUDE.md;「特定任務才用得到、但一用就要整套」→ skill。我的實例:「回覆用繁中」在 CLAUDE.md,「寫 SEO 文章的完整規範」(幾千字的檢查清單)是一個 skill — 寫文章時才需要,平常帶著純浪費。
第一個 skill 動手做(20 分鐘)
一個 skill 最小只需要:一個資料夾 + 裡面一份 SKILL.md。放在個人層級的 skills 資料夾(所有專案通用)或專案的 .claude/skills/(跟著專案走)。SKILL.md 的骨架:
---
name: social-post
description: 幫我寫社群貼文時使用。包含語氣規則、格式、禁區。
---
# 社群貼文 SOP
## 語氣
- 直接、口語,像跟朋友講話
- 每篇至少一個具體數字
- 不用「勢必」「賦能」這類書面詞
## 格式
- 第一行就是重點,不鋪陳
- 全文 500 字內,分 3-4 段
## 禁區
- 不寫「這給我們的啟示是」式雞湯結尾
- 不保證任何成效最關鍵的一行是開頭的 description — 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 就是命令列工具。
如果內容對你有用就太好了
隨喜斗內
相關文章
▸ 常見問題
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 教的是你的流程)
- 把 skill 寫成教科書 — AI 要的是可執行的步驟不是理論
- description 寫太模糊 — AI 對不上任務就永遠不會觸發
- 什麼都想塞進一個 skill — 一個 skill 管一件事