Skill：把經驗寫成一本手冊
上一幕，MCP 讓 AI 拿得到資料、碰得到系統，但「這件事該怎麼做」還是得每次重講。這一幕，把做法寫一次，變成一本 AI 用得上就翻開的手冊。
同一件事每週都要做，難道每次都要把 Prompt 重新交代一遍？
同樣的三條規矩，每次都要重講一遍
史旺姬常請 AI 幫忙約會議。每一次，她都要重新交代同樣的三件事：避開午休、會議標題照指定格式、寄出前先給她看。這次說完，下次換一件事、換一位同事，又要從頭說一遍。
幫我約阿哲和 Amy，下週三討論活動企劃。
- ① 避開午休
- ② 標題照格式
- ③ 寄出前先給我看
幫我約小芳，週五對一下報價。
- ① 避開午休
- ② 標題照格式
- ③ 寄出前先給我看
幫我約王先生，下個月初開檢討會。
- ① 避開午休
- ② 標題照格式
- ③ 寄出前先給我看
寫成一本手冊
- 避開午休
- 標題照格式
- 寄出前先給我看
寫一次，之後只要說「這次約誰、談什麼」。
每次不一樣的只有「約誰、談什麼」；一直重複的，是做法和注意事項。
先想一想
你有沒有哪件事，每週都要重新交代一次？不是工作內容每次一模一樣，而是基本流程和注意事項一直重複。
這一幕要回答
既然重複，能不能把做法寫一次，整理成一本用得上就翻開的手冊，讓其他人也能沿用？這本寫給 AI 的手冊，就叫 Skill。
只記一句每次不一樣的寫在交辦裡；一直重複的做法，值得寫成一本手冊。
Skill：寫給 AI 的「新人工作手冊」
Skill 可以先用一句話理解：寫給 AI 的標準作業流程。它通常是一個資料夾，裡面有一份 SKILL.md，寫下這類工作應該怎麼做，也可以放範本或其他附件。
寫一次，每次照做：史旺姬把約會議的規矩，寫成一支叫 schedule-meeting 的 Skill（示意）。
一個資料夾
不用每次重講
寫 Skill 不是在訓練 AI
模型的參數沒有因為你寫了一份手冊而改變。做法是需要時把手冊內容交給它，讓它照著做；拿掉手冊，它就不會。
Anthropic 也公開了一批範例手冊，例如處理 PDF、Excel、Word、簡報檔的 Skill，以及幫你建立 Skill 的 skill-creator（後面「怎麼叫出 Skill」會再看到）。手冊不只能用在排會議：它的價值，是把你原本就會的工作方法，變成別人和 AI 都讀得懂、能重複使用的說明。
只記一句Skill 讓 AI 從「聰明的新人」，變成「懂你們做法的同事」。
出處：Anthropic〈Agent Skills〉（2025-10-16 發布，2025-12-18 更新）；Anthropic 公開範例 Skill：github.com/anthropics/skills（2026-10-06 查閱）。schedule-meeting 與其規則為本教材虛構示意。
一份 SKILL.md 的長相：寫給 AI 的 SOP（標準作業流程）
換史旺姬的第二支示意 Skill：meeting-notes，把會議逐字稿整理成紀錄；上面的 schedule-meeting 格式完全相同。看起來像程式碼，先別緊張——這其實是一份有結構的工作說明，對照四個標號一段一段看。
---name: meeting-notesdescription: 把會議逐字稿整理成給主管看的
摘要、決議與待辦表格。使用者提到
「會議紀錄」「整理逐字稿」時使用。---# 會議紀錄整理## 步驟1. 先寫三行摘要（給沒參加的主管）2. 列出所有「決議」3. 待辦做成表格：事項／負責人／期限## 規則- 沒提到期限 → 寫「待確認」，不要猜- 人名照原文，不要自己補全名## 範本請參考 template.md 的格式1名稱（name）
這支 Skill 叫什麼，用英文小寫和連字號。最上面兩條 --- 夾住的是「封面資料」：名稱＋說明。
2說明（description）
最重要的一段：AI 靠這段判斷「什麼時候該用我」。要寫清楚用途，和使用者會講的關鍵字。
3步驟與規則
就是 SOP 本體：照順序做什麼、遇到例外怎麼辦。像「沒提到期限就寫待確認、不要猜」這種規則，正是讓成果符合你做法的關鍵。
4範本與附件
範本、參考資料、小程式，放在同一個資料夾，需要時才讀。
只記一句會寫 SOP，就會寫 Skill。
示意：meeting-notes 為本教材虛構的示意 Skill；SKILL.md 格式依 Claude Code Docs〈Extend Claude with skills〉。
手冊一層一層翻（正式名稱：漸進式揭露）
AI 不是一開始就把每一本手冊全文讀完。名字聽起來抽象，其實就是：不要一開始把所有內容全部攤出來，需要到哪一層，再讀到哪一層。就像先看手冊目錄，再翻到用得上的那一章。
越往下，越晚才拿出來
第 1 層：先放目錄
每支 Skill 的名稱和說明，像手冊目錄上的一行：這本是排會議、那本是整理會議紀錄。「約 100 Token」只是說目錄很精簡，不是固定配額。
第 2 層：用得上才翻開
AI 判斷這一次用得上，才打開那份 SKILL.md 全文，讀完整的步驟和規則。不是每次一進來就先把幾十本手冊讀完。
第 3 層：需要才拿附件
做到一半需要範本或參考資料，再去拿。如果附的是小程式，通常是執行後把結果交回來，不必把整份程式碼當成閱讀材料。
如果所有手冊一開始全文上桌
佔掉大半張桌子，重要的內容反而更難被注意到。還記得 第二幕的辦公桌 嗎？桌面就這麼大。
只放目錄，用到才翻
桌面留給這次真正要用的內容。也因為這樣，目錄上那一行（description）寫不清楚用途和使用情境，AI 可能根本想不到該翻這本。
只記一句桌子有限，只先放目錄；「說明」寫不清楚，AI 就不會想到翻開。
出處：Claude Docs〈Agent Skills overview〉；Anthropic Engineering〈Equipping agents for the real world with Agent Skills〉；Claude Code Docs〈Extend Claude with skills〉。schedule-meeting、meeting-notes 為示意 Skill，pdf、xlsx 為 Anthropic 官方 Skill。
Prompt、Skill、MCP 一張表分清楚
這三個詞最容易混在一起，所以不要各講一套例子，全部用「排會議」來看。
| 比較項目 | Prompt：交辦 | Skill：手冊 | MCP：USB-C 規格 |
|---|---|---|---|
| 📍 排會議（示意） | 「幫我約下週三下午，我、阿哲、Amy 都有空的一小時」 | schedule-meeting（排會議手冊） | 行事曆 Server 的「查空檔」「建立邀請」工具（示意） |
| 給 AI 什麼 | 這一次要做什麼 | 這類事「怎麼做」 | 「做得到」的能力和資料 |
| 誰來寫 | 你，每次都寫 | 懂流程的人寫一次，大家共用 | IT 工程師做 Server（轉接線） |
| 放在哪 | 對話框 | 一個資料夾＋SKILL.md | 轉接線（MCP Server），裝在你的電腦或放在遠端的伺服器都可以 |
| 什麼時候上桌 | 送出那一刻 | 名稱＋說明一開始就在桌上；用得上才翻開全文 | 工具清單一開始就讓 AI 知道；AI 寫工單時才真的執行 |
| 佔桌面多少 | 你打多少就佔多少 | 平常只放名稱＋說明（約 100 Token），用到才放全文 | 工具名稱先上桌，用到才拿完整說明（跟 Skill 一樣省桌面） |
| 少了會怎樣 | AI 不知道你要什麼 | 每次都要重講，品質不一 | 說得再清楚，也碰不到資料 |
Prompt 說「做什麼」
這一次的對象、時間和目標。缺了它，AI 不知道你這次要什麼。
Skill 教「怎麼做」
避開午休、標題格式、發出前先確認。換了會議主題，這些做法照樣沿用。
MCP 讓 AI「做得到」
透過行事曆的工具，AI 才能真的查到空檔、把邀請送進系統。沒有工具，說得再清楚也不能憑空操作。
只記一句Prompt 說做什麼，Skill 教怎麼做，MCP 讓 AI 做得到。
出處：Claude Docs〈Agent Skills overview〉；Claude Code Docs〈Connect Claude Code to tools via MCP〉（tool search）。schedule-meeting 與行事曆 Server 為示意。
先練交辦，再用 Claude Code 寫 Skill、跑 Skill
用一般的聊天工具就好，還是要裝另一套軟體？答案是兩段走：先在聊天工具把交辦練熟，再到會讀 SKILL.md 的工具裡寫手冊、用手冊。你可以在自己的電腦上試，不需要為了理解這一幕，先把所有環境都裝好。
用你有權限使用的 AI 聊天工具，
先練好交辦（Prompt）和檢查結果
Anthropic 出的 AI 助理程式，不用會寫程式；
會讀你資料夾裡的 SKILL.md 照著做
CLAUDE.md＝辦公室公告欄
每次開工都會先讀一遍的固定規矩，不管這次做什麼事都適用。
Skill＝特定工作的手冊
遇到那一類工作才翻開。平常只在目錄上佔一行。
「寫」手冊：記事本就可以
SKILL.md 是純文字，任何文字編輯器都能寫。
「跑」手冊：要支援它的工具
讓工具認得、載入、測試那支 Skill，需要像 Claude Code 這樣的執行環境。
給想自己動手的人：skills 資料夾在哪裡？
~/.claude/skills/（~ 是你的使用者資料夾，所有專案都用得到），以及專案層 .claude/skills/（只在那個專案資料夾裡有效）。每支 Skill 一個子資料夾，裡面放 SKILL.md。現在不用背，要動手時再回來看。只記一句先練好交辦與檢查結果，再到 Claude Code 寫 Skill、跑 Skill。
出處：Claude Code Docs〈Overview〉；Claude Code Docs〈Extend Claude with skills〉（個人層 ~/.claude/skills/；專案層 .claude/skills/）。
在 Claude Code 怎麼用 Skill：直接說需求，它會自己挑
下面是 Claude Code 裝好之後，在它的對話框裡可以打的話。要注意：meeting-notes 是前面那份示意 Skill，要先放進固定的 skills 資料夾，才叫得出來——名稱不是你打了就會憑空出現。
自己挑
直接說需求。環境裡有合適的 Skill，而且說明對得上，它就自己翻開 meeting-notes。
直接點名
/meeting-notes 整理這份逐字稿用斜線加名稱。你知道要用哪支手冊，或它沒自己選對時，很方便。
看清單
/skills打 /skills 開選單；或直接問「你有哪些 Skill？」
pdf、xlsx、docx、pptx
怎麼開啟，依 Claude Code 官方說明。
skill-creator：幫你做 Skill 的 Skill
不用從空白頁開始寫，先讓它幫你打草稿，再自己改。
「你剛剛用了哪支 Skill？」
這只是確認的線索之一，不能只靠它自己說。有沒有真的照格式、有沒有把不知道的期限寫成「待確認」，還是要對照成果看。
只記一句最常用的是直接說需求；它沒挑對，就打「/名稱」點名。
出處：Claude Code Docs〈Extend Claude with skills〉（code.claude.com/docs/en/skills；以 claude.ai 帳號登入時 pdf、xlsx 等官方 Skill 會自動同步，2026-10-06 查閱）；github.com/anthropics/skills（2026-10-06 查閱）；Claude Docs〈Agent Skills overview〉。
第一支 Skill，挑哪件工作？
會叫用之後，先別急著做很多支。第一支 Skill，挑常做、花時間、步驟講得出來的工作；每次都不一樣、要人際判斷，或碰到個資、法律責任的，先不要。
怎麼替候選工作打分數、排出第一個題目，第六幕有完整做法：選題三問與打分示範 。
只記一句先挑常做、花時間、步驟講得出來的工作；要人際判斷或碰到個資的，先不要。
史旺姬寫了第三支 Skill「整理週報」（weekly-report），步驟寫得很完整。她對 AI 說「幫我整理這週的週報」，AI 卻沒用這支 Skill。最可能的原因是？
- A 步驟太長：AI 決定要不要打開之前，根本還沒讀到步驟，步驟長短不會影響它選不選。
- B 沒接 MCP：Skill 是工作說明，不一定要配 MCP 工具；整理你貼上的內容，不用接工具。
- D 先讀完全文：正好相反，開工時只放名稱和說明，不會先讀全文。
看答案
先把「手冊內容好不好」和「AI 有沒有想到打開這本手冊」分成兩件事，再選答案。答錯的話，回到上面的「手冊一層一層翻」重看。
說明（description）是入口：先讓 AI 想得到它
觸發率
在本來應該用到某支 Skill 的需求裡，AI 有多少次真的想到要打開它。就像新人遇到該翻手冊的狀況時，有沒有想到去翻。觸發率低，問題通常不在手冊內容，而在目錄上那一行。
說明太短：AI 對不上
使用者說「幫我整理這週的週報」，說明裡卻沒有任何一個對得上的字。
name: weekly-report
description: 週報。寫清楚用途＋使用者會講的字
照 meeting-notes 的寫法：先說它做什麼，再說什麼情況該用。
name: weekly-report
description: 把這週的工作紀錄整理成給主管看的
週報。使用者提到「週報」「整理這週的進度」
時使用。兩段 description 都是示意寫法。
- 寫清楚這支 Skill 做什麼（用途）。
- 寫進使用者實際會講的字（什麼時候用）。
- 用的時候追問「用了哪支 Skill」，再對照成果確認。
只記一句手冊正文要寫好，目錄上的那一行也要寫清楚。
出處：Claude Docs〈Agent Skills overview〉；Claude Code Docs〈Extend Claude with skills〉。weekly-report 為本教材虛構的示意 Skill。
想再多懂一點：Skill
先把這一幕讀完、小測驗做完，再挑一兩個來看。「官方」是 AI 公司自己出的入門資料；「史旺基專欄」是站上的進階文章，用到比較多工程術語。
第五幕，帶走這幾句
第五幕到這裡：交辦（Prompt）、工具（MCP）、手冊（Skill）都到齊了。下一幕把大腦和工具放進一個會反覆推進的迴圈，再配上交辦和手冊，變成會自己把事做完的同事——Agent。
- Skill＝一個資料夾＋一份 SKILL.md：把重複的做法寫一次，之後每次照做。它不是在訓練 AI，拿掉手冊，AI 就不會。
- AI 平常只看每支 Skill 的名稱和說明，用得上才翻開全文。說明（description）寫不清楚，手冊再好也不會被打開。
- Prompt 說這次做什麼，Skill 教這類事怎麼做，MCP 讓 AI 做得到。
- 第一支 Skill 挑常做、花時間、步驟講得出來的工作；要人際判斷、涉及個資或法律責任的，先不要。