Skip to content

Claude Code 的 CLAUDE.md 和 SKILL 教學,打造可重複使用的 AI 自動化工作流

每次叫 Claude Code 做事,都要重新交代格式和步驟?CLAUDE.md 寫的是「記住你是誰」;SKILL 則是「記住怎麼做事」。把「通用規則」和「特定流程」分開管理 ,讓你的 AI 助理真正學會做事。

📌目錄

用了 Claude Code 一陣子之後,你會開始發現一個問題:

每次叫 Claude Code 幫你記日記,你都要重新交代一次格式:「Time Log 用表格、時間用 24 小時制、結尾要算總工時。」

叫它整理閱讀筆記,你又要重新講一次:「原文放前面、翻譯放後面、最後加重點摘要。」

它做得到,但你每次都要講,反而沒有省到時間

我們可以用 CLAUDE.md 解決「記住你是誰」的問題,但「記住怎麼做事」又是另一件事。

簡單來說,CLAUDE.md 適合放通用規則 —— 語言、風格、資料夾結構。

但當你有一套完整的工作流程,步驟多、有邏輯、有例外處理,全塞進 CLAUDE.md 會讓它變得又長又亂,這時候你需要的是 Skills。


Skills 是什麼?給 AI 的 SOP

Skill = 工作說明書、標準作業程序(SOP),教 AI 在特定領域怎麼做事。

CLAUDE.md = 讓 AI 記住你是誰的設定指南、偏好和背景知識。

如果 CLAUDE.md 是「入職手冊」,那 Skills 就是「標準作業程序」。

SOP 這個概念你應該不陌生。

咖啡店有沖咖啡的 SOP,醫院有急救的 SOP,公司有報帳的 SOP。SOP 的重點是:不管今天是誰來做,照著步驟走,結果都一樣。

Claude Code 的 Skills 做的是同一件事,只是對象從「人」變成了「AI」。

一個 Skill 就是一個資料夾,負責一件事,裡面放一個叫 SKILL.md 的檔案,這個檔案會用 Markdown 寫,內容就是你希望 Claude 執行的步驟。

kill 的本質就是一份 Markdown 文件(SKILL.md),裡面寫著:

  1. 什麼時候觸發(description 欄位)
  2. 怎麼做(步驟、規則、模板)
  3. 參考哪些資料(附帶的 references 子資料夾)

最簡單的 Skill 長這樣

---
name: git-conventions
description: Git 操作慣例 — 口語對照、巢狀 repo、CHANGELOG
user-invocable: true
---

# Git 操作慣例

## 用戶說「Git 上去」時
1. 先跑 git status 確認變更
2. git add 相關檔案(不要 git add .)
3. 用中文寫 commit message
4. 推上 remote

寫一次,以後每次用 slash command 呼叫就好。

例如:

  • /journal — 幫你記錄今天的日記,自動套用你的 Time Log 格式
  • /summary — 對話結束時做全面檢查,確認所有對話都記錄到了

Skill 怎麼觸發?

兩種方式:

  1. 自動觸發:Claude 根據你的對話內容,判斷需要讀某個 Skill(靠 description 比對)
  2. 手動觸發:在對話中輸入 /skill-name,例如 /content-writing

不需要每次重複交代。打 /journal,它就知道該怎麼做。

Skill 放在哪裡?

Claude Code 會自動掃描這兩個位置的 Skill:

~/.claude/skills/          ← 全域(所有專案都能用)
你的專案/.claude/skills/    ← 專案層級(只在這個專案生效)

為什麼 Skill 是一個關鍵進化?

如果你在 2024、2025 年有玩過 ChatGPT 的 GPTs 或 Google Gemini 的 Gems,你一定做過這件事:把一整包 Prompt 塞進一個「自訂機器人」裡。

旅遊日誌生成器一個、電子報行銷內容一個、社群貼文寫手一個。

聽起來很美好,但用了一陣子你會發現最大的痛點:每包知識都散落在不同的對話機器人裡。

  • 想寫旅遊日誌?先去找那個 GPTs。
  • 想生成電子報?切到另一個 GPTs。
  • 想潤一段社群貼文?再開第三個。

每次要解決問題,你都得先想「要找誰」,而不是專注在「要做什麼」。

明明有一個任務要完成,卻得先花時間想該找誰、該開哪個對話框,沒辦法在同一個地方把事情搞定。

Skill 解決的就是這個問題。

因為每個 Skill 都有 description 欄位,AI 會自動讀懂你現在在做什麼,然後自己決定要調用哪個 Skill。

你不用再記「A 任務找 A Agent,B 任務找 B Agent」,只需要在同一個對話框裡說你要做什麼,AI 會自己去抓對應的知識和流程進來。

這是從「人去找工具」到「工具來找人」的轉變。你終於可以專注在任務本身,而不是在工具之間切來切去。(想了解這個 AI 工具進化的完整脈絡,可以看這篇我整理的三階段學習路徑。)

GPTs 時代 vs Skill 時代

實際案例

我目前自己寫了 25 個 Skill。(如果你好奇我是怎麼一步步打造出這套系統的,可以看我之前寫的 21 天實戰記錄。)

我寫的 Skill

Skill用途為什麼要自己寫?
content-writing雷蒙風格寫作我的語氣、模板、用詞,沒有 Plugin 能替代
wordpressWP 文章管理綁定我的 API、分類、區塊格式
email-assistant信箱助理我的分類規則、回信語氣、合作評估流程
skill-creator建立新 Skill 的 SOP確保每個新 Skill 品質一致
notion-apiNotion 資料庫操作我的 database ID、欄位定義
yt-transcriptYouTube 逐字稿擷取指定我慣用的 whisper 模型和輸出格式
web-design品牌網頁設計系統我的配色、字體、元件風格,做 Landing Page 時自動套用

你看出規律了嗎?

Plugin 處理「通用功能」 — 查文件、管部署、抓語法錯誤。這些不管誰來用,邏輯都一樣。

Skill 處理「個人知識」 — 我的寫作風格、我的 API 設定、我的工作流程。這些只有我自己知道。

順帶一提,我未來有打算把一些不涉及個人帳號的 Skill 公開分享出來。

Skill 的好處就在這裡,它本質是一份文件,不需要會寫程式就能讀、能改、能學。

你看完別人的 Skill,馬上就能理解他的工作邏輯,然後改成自己的版本。

這種「用文件交流工作方法」的感覺,其實很像開源社群的精神:不是把成品丟給你用,而是把思路攤開來讓大家互相學習。


❌ 別急著裝,先學會判斷

Skill 裡面不只有文字指令,還可以包含 scripts/(執行腳本)。

這代表一個 Skill 被觸發時,它有能力在你的電腦上跑(惡意)程式。

所以當你在網路上看到別人推薦「超好用的 Skill」時,不要無腦安裝

與其說「❌ 幫我安裝這個 Skill」

我自己的做法是:先把那個 Skill 的網址或內容丟給我的 AI,問它:

✅ 幫我看一下這個 Skill 是什麼?適合我們嗎?

AI 會幫我分析裡面的結構、邏輯,如果發現有問題(例如不必要的權限、奇怪的腳本),它會直接告訴我。如果內容不錯,它也會指出哪些部分值得借鏡。

這有兩個好處:

  1. 避免 FOMO 焦慮:社群上每天都有人在分享新 Skill,全部裝下來你只會得到一堆你根本不會觸發的死檔案
  2. 學到比安裝更多:別人寫了 10 個 reference 文件,你可能只需要學其中 2 個的寫法,再根據自己的需求優化出 4 個版本——這比直接照抄整包更有價值

記住:最好的 Skill 是你自己長出來的,不是別人打包好的。 別人的 Skill 是靈感來源,不是標準答案。

別人的 Skill 怎麼用

新手該從哪裡開始?

第一步:先裝幾個實用的 Plugin

推薦清單:

# 查程式庫文件(寫程式必備)
claude plugin install context7

# CLAUDE.md 健檢工具
claude plugin install claude-md-management

# 對話分析,自動建立防呆
claude plugin install hookify

第二步:遇到「每次都要重複講」的事,就寫 Skill

判斷標準很簡單:

如果你連續三次在不同對話中跟 Claude 講同一件事,那就是一個 Skill。

例如:

  • 「我的文章結尾都要放品牌簽名檔」→ 寫一個 content-writing Skill
  • 「部署到 Zeabur 前要先跑測試」→ 寫一個 deploy Skill
  • 「Git commit message 用中文」→ 寫一個 git-conventions Skill

第三步:Skill 穩定後,考慮打包成 Plugin 分享

如果你的 Skill:

  • 不綁定個人帳號和 API
  • 別人也能用
  • 已經穩定了一段時間

那就可以包一層 Plugin 外殼,推到 GitHub 讓別人安裝。


進階:Skill 的進化路徑

「每次都要講」
    ↓
寫一份 SKILL.md(最簡版)
    ↓
加入 references/ 子資料夾(拆分知識)
    ↓
加入 scripts/(附帶腳本自動化)
    ↓
加入版本號和 changelog(追蹤變更)
    ↓
打包成 Plugin(分享給別人)

大部分人到第三步就夠了。不需要一開始就追求完美結構,先從一份簡單的 SKILL.md 開始,用著用著自然會長大。


常見問題

Q:Skill 和 CLAUDE.md 有什麼差別?

CLAUDE.md 是「每次對話都會載入」的核心規則,適合放簡短、通用的指令。Skill 是「按需載入」的專業知識庫,適合放特定領域的詳細流程。

把它想成:CLAUDE.md 是你的「個人簡介」,Skill 是你的「專業技能書」。你不會把整本書塞進簡介裡。

CLAUDE.mdSKILL
用途通用偏好和規則特定任務的完整流程
內容語言、風格、禁區、資料夾結構步驟、格式、範例、例外處理
載入實際每次對話都自動載入相關時才載入(或用 slash command 觸發)
比喻入職手冊SOP
更新頻率偶爾經常(每次做錯就改)

Q:我不是工程師,能自己寫 Skill 嗎?

完全可以。Skill 就是一份 Markdown 文件,你在 Obsidian 或任何筆記軟體裡就能寫。不需要會程式語言。

你甚至可以直接跟 Claude 說:「幫我把這段對話整理成一個 Skill」,它就會幫你產出 SKILL.md。


📍 AI Agent(Claude Code、Codex)系列教學文章

分享按鈕

關於作者

留言回應

訂閱
接收通知
guest
0 留言
最新的留言
最舊的留言 Most Voted
Inline Feedbacks
View all comments

領取高效生產力的秘訣!

Free 免費 NT$ ?????
免費入門課&電子書&精華文章一次帶走
  • 聰明工作者的 10 堂體驗課
  • 現代人必備的 25+ 款數位工具
……更多你需要的現代人精進指南!