做一個自己的 Claude Skill:從 SOP 到 SKILL.md
Skill 就是把你本來就會做的一套流程(SOP),寫成一份說明檔,放到 Claude 找得到的地方。之後遇到相關的事,Claude 會翻出來照著做,你也可以用指令直接叫它。
官方對 Claude Code 的說法是:建立一個 SKILL.md 檔寫下指示,Claude 就會把它加進自己的工具箱;相關時 Claude 會自己用,或你用 /skill-name 直接呼叫。
這篇我用「會議紀錄整理」當範例,帶你從畫流程、寫檔案,到測試修正,走一遍。範例是我專門寫的通用版,可以直接拿去改。
Skill 和提示詞差在哪
提示詞是一次性的:你每次都要貼,或自己從筆記裡翻。Skill 是存起來的:寫一次,之後不用重貼。
我在內部教學時用過一個二分法,學員很快就懂:
- 一次性的事,用對話解決。
- 會反覆做、做法固定的事,存成 Skill。
如果你已經在用 Claude Projects(撰寫中),也可以這樣分:專案放「這個客戶、這個案子」的背景;Skill 放「這件事怎麼做」的流程。完整的 Claude Code 版介紹,看 Claude Code Skills 是什麼(撰寫中)。
先畫 SOP,再寫 Skill
我在教學時發現,很多人做得出來,卻說不清楚自己的 SOP。做久了的動作,常常已經變成直覺。
我給的功課很土:用紙筆,把你上一次做這件事的每個步驟寫下來,包含你自己都覺得「這不用寫吧」的小動作。
以會議紀錄為例,我的流程是:
- 拿到逐字稿或雜亂筆記。
- 抓出日期、與會者、主題。
- 把討論內容按議題分段,刪掉閒聊。
- 抽出每個決議,標負責人和期限。
- 沒講清楚的地方,標「需後續確認」,不補寫。
- 列出下次待確認事項。
SOP 寫出來,Skill 已經完成一半。
寫 SKILL.md
結構很簡單,兩個部分:開頭的描述區(名稱與說明),和後面的正文(Claude 要照做的內容)。
我自己做過一個整理逐字稿的 skill,用了一段時間之後,我最有感的是描述區要寫得精準。裡面我寫了三件事:它是做什麼的、哪些詞出現時該啟動、哪些事它不處理(要用另一個 skill)。Claude 判斷「現在該不該用這個 skill」,主要靠這段描述,所以別偷懶。
下面是通用版的完整範例:
---
name: meeting-notes
description: 把會議逐字稿或雜亂筆記整理成正式會議紀錄。當使用者提到「會議紀錄」「整理逐字稿」「會議摘要」「決議事項」時使用。不處理:課程筆記、影片摘要、一般文章摘要。
---
# 會議紀錄整理
## 你的角色
你是一位細心的行政助理,負責把會議內容整理成清楚、可追蹤的紀錄。
## 步驟
1. 先確認輸入是逐字稿還是筆記。如果缺少日期、與會者或主題,先問使用者,不要自己猜。
2. 依下列格式輸出:
- 一、基本資訊(日期/與會者/主題)
- 二、主要討論議題(每個議題一個小標題,不含閒聊與寒暄)
- 三、決議事項(每點附:決議內容+負責人+完成期限)
- 四、下次待確認事項
3. 沒有明確提到負責人或期限的,標注「需後續確認」,不要推測或補寫。
4. 全文使用台灣繁體中文用語。
5. 輸出後附一行提醒:「日期、人名、數字請對照原稿再確認一次。」
## 不要做的事
- 不要加入原稿沒有的內容。
- 不要把情緒性發言寫進紀錄。
這個範例可以直接複製。要換成你自己的,改三處就好:描述區的觸發詞、步驟裡的格式、最後的規則。
放到哪裡
放的位置依你用的 Claude 版本而定。
Claude Code:官方文件寫的是,個人層級放在家目錄 .claude 底下的 skills 資料夾,每個 skill 一個資料夾、裡面放 SKILL.md;專案層級放在專案資料夾的 .claude/skills 底下。放在本機個人層級,這台電腦上的 Claude Code 專案都能用;放在專案層級,則只在該專案有效。Cowork 和雲端工作階段不會直接讀取本機個人 skill。
claude.ai(網頁與桌面版):官方說明 Skills 在 Free、Pro、Max、Team、Enterprise 方案都能用,前提是開啟程式碼執行。個人方案到 Settings > Capabilities 開啟,再到 Customize > Skills 個別開關。自己做的 Skill 怎麼上傳,我這部分沒有實際深用,只講我知道的:請以 官方說明頁 為準。
介面和路徑可能調整,兩邊都以官方頁面為準。
測試與修正
寫完不要馬上說「完成」。我的測法是三關:
- 對的案例:貼一份真的逐字稿,看輸出格式有沒有照做。
- 缺資料的案例:故意貼一份沒講期限的,看它有沒有標「需後續確認」,還是自己編一個日期。
- 不該啟動的案例:貼一段課程筆記,看它會不會誤用這個 skill。
| 測試情境 | 測試方法 | 預期結果 |
|---|---|---|
| 正常輸入 | 貼上真實的逐字稿 | 依照設定的格式與步驟輸出 |
| 異常輸入 | 故意給缺資料的內容 | 標註「需後續確認」,不自行腦補 |
| 範圍外輸入 | 貼上課程筆記 | 拒絕處理或不會誤用此 Skill |
哪一關沒過,就回頭改。通常是改描述區(啟動條件不精準),或在步驟裡補一句更明確的規則。
改的原則跟寫提示詞一樣:說要做什麼,比說不要做什麼有效;每次只改一處,改完重測。
我自己的做法
幾個我用下來的習慣,供你參考:
- 一個 skill 只做一件事。寫成「萬能助理」的話,描述區會變得很長,Claude 也比較不容易判斷什麼時候該用。
- 把容易出錯的地方寫成明確規則。會議紀錄的「不要補寫期限」,就是這樣來的。
- 描述區寫「不處理什麼」。這是我的 skill 裡很實用的一行,可以避免它搶別人的工作。
- 做完一個 skill,過一陣子回頭看。流程改了、格式換了,skill 也要一起更新,不然它會一直照舊規矩做事。
至於我自己的 skill 實際長什麼樣子,內部的設定我不貼出來,只分享做法。
常見問題
Skill 和 Claude Projects 的自訂指示有什麼不同?
專案指示綁在那個專案裡,只有該專案的對話看得到。Skill 是獨立的流程說明,依你放的位置決定在哪裡可用。簡單分法:背景放專案,做法放 Skill。
不會寫程式,做得出 Skill 嗎?
這個範例是純文字說明,沒有任何程式。會用到程式碼的 Skill 是進階做法,我這篇不碰。
Skill 的內容會被別人看到嗎?
放在自己電腦或自己帳號底下的,預設是自己用。要分享給團隊,之前要先確認裡面沒有客戶名稱、金鑰或內部資料。我自己的原則是:能公開的流程才寫進 Skill 範本,敏感的資料另外處理。
我的 Skill 沒有被啟動,怎麼辦?
先看描述區。觸發詞太少、說明太籠統,是最常見的原因。也可以用 /skill-name 直接呼叫,確認 skill 本身有沒有問題。
下一步
想先把提示詞寫順,看 提示詞六元素(撰寫中)。想知道會議紀錄的完整流程,看 用 Claude 整理會議紀錄的流程(撰寫中)。想看 Claude Code 這邊更完整的 Skills 介紹,看 Claude Code Skills 是什麼(撰寫中)。
下一場小聚,帶著你想打包的那個 SOP 來:/events/#next。
價格與功能查證日:2026-10-05,以官方頁面為準。