全天最核心的一章。你會親手做出第一片超能力光碟。一個資料夾、一份 SKILL.md,一句話就能叫它幹活。
開場提問
先把這條老路的問題講透,你才會懂 skill 到底在解什麼。先講結論:把規則塞進對話這條路,有四個死穴。
接下來四頁,一個一個拆
根本原因 一

資訊超載 → 注意力分散。桌子就那麼大,堆太多,什麼都看不清。
根本原因 二
沒有一份物理性的 SOP 硬性約束,AI 遇到繁瑣檢查就會偷偷省略。這不是壞掉,是注意力被稀釋的必然結果。
傳統解法
所有規矩一次寫好(例如 CLAUDE.md),每次對話整包塞給 AI。規則寫死了,總不會忘了吧。
真實案例
2025 年中被外流的 Claude 系統提示詞,竟高達將近 2.4 萬 Token。Token 先想成 AI 每次要讀進去的文字量。
這跟你正在做的事一樣。每次重貼品牌語氣、SEO 檢查表、輸出格式,AI 還沒動筆,背景就先吃掉一截工作空間。
死穴 01 / 04
厚厚一本員工手冊,每次對話都得重傳一遍。正事還沒交辦,AI 光背手冊就累個半死。
事情都還沒做,負擔先到。
01
最直觀的死穴:開場空間被手冊塞滿,AI 還沒交辦正事就先扛了一身負擔。
死穴 02 / 04
同一條規則被複製在好幾個地方,改了一個,其他還是舊的,版本互相打架。
| 位置 | 狀態 | 同步 |
|---|---|---|
| 對話框 A | 沿用舊規則 | 未同步 |
| 專案檔 B | 這份已經改過 | 已更新 |
| CLAUDE.md | 沿用舊規則 | 未同步 |
規則散在四處,最容易被忽略,長期卻最痛。
死穴 03 / 04
03
重複背景字 × N 輪 = 看不見的帳單。預算被這些 Token 默默吃光,你卻以為自己在認真幹活。
死穴 04 / 04
04
規則塞太多,換來的不是更聽話,是更僵硬。塞越多越笨,呼應稀釋那一條。
收束 · 接到 SKILL
四個表面症狀
往下挖,根因只有一個:規則塞進對話、每次重講。

什麼是 AGENT SKILL
階梯 1 那個一次性 prompt,用完就散了。Agent Skill 把知識、規則、工具打包成一片光碟,AI 要用時自己挑出對的那一片。

你的技能櫃
規則別用嘴巴一直重講,做成一片光碟,要用再抽。光碟 = 打包好的知識 + 規則 + 工具。
負重前行 VS 輕裝上陣
AI 出門前先背一遍三千字手冊,扛著沉重的垃圾文字上路。
AI 平常 100% 輕裝,描述對上了才瞬間載入那片光碟,用完立刻放回口袋。
| 載入狀態 | 負重前行,每次都背一遍 ↔ 輕裝上陣,要用才載入 |
| Token 消耗 | 重複傳一直燒,又慢又貴 ↔ 用完收回,省下高達 90% |
光碟用到才算,反應速度飆升,還能省下高達 90% 的 Token 開銷。
變革的核心價值
極致提速。背景自動匹配、毫秒級喚醒,不用任何人手動貼提示詞,隨時待命。
超省荷包。只把最關鍵的規則貼在大腦上,省去 90% 的上下文廢話開銷。
輕鬆維護。光碟與對話徹底解耦,改一份 Markdown,所有助理瞬間同步。
三個字記起來:快、省、好維護。這就是 Skills 能成為自動化新革命的理由。
不用會程式
用純文字符號標記格式,像記事本一樣簡單。檔名結尾的 .md(CLAUDE.md、SKILL.md)就是 Markdown 檔。同一份檔案,AI 跟人都讀得懂。
你寫的純文字
AI / 人看到的結構
AI 看標題層級(#、##)就像人看目錄,瞬間抓到重點。不用會 code,照樣寫出光碟。
一片光碟的長相
一個資料夾、一個 SKILL.md。上半是識別貼紙(name 和 description),下半是 Markdown 做事步驟。
--- 之間的 name 與 description。下一頁逐層拆解三層結構 →
看懂一件事就好:原來一片光碟就這麼短,用記事本就寫得出來。
三明治結構 · 開場
解剖之前先回答最務實的問題:做好的光碟放在哪?不用背路徑,但要看得懂這片地圖。
~/.claude/skills/my-first-skill/~/ 換成 C:\Users\你的帳號\,位置一樣。一個 Skill 等於一個資料夾,資料夾名字要跟貼紙上的 name 對齊。今天請 Claude 幫你建就好。
核心隱喻
整章最重要的一張圖。先記住三層的分工。
三層疊起來像個三明治:被認出來、教做事、查跟動手。
第一層 · 識別貼紙
--- 之間,只有 兩個欄位這種兩行 --- 夾起來的格式叫 YAML。名字記不住沒關係,看得懂這兩欄就夠了。
description 寫得越精準,AI 的匹配命中率越高,這是整片光碟成敗的關鍵。下午會花一整段練怎麼寫。
關鍵機制 · LIVE DEMO 等級
使用者打出一句話,AI 掃描指令裡的關鍵意圖。
同時比對所有本機 skills 的 description,精準命中那一張。
命中後才去讀 SKILL.md,大腦瞬間學會這套 SOP。
平常 AI 只掃那一行貼紙、不讀內文。這就是為什麼 description 要寫好,也是 skill 平常零負擔的原因。
整章設計哲學 · 壓軸
| 時機 | 動作 | 狀態 |
|---|---|---|
| 平常 | 桌上只有貼紙,極輕,AI 背景 0.05 秒認出 | 零負擔 |
| 命中 | 才翻開 SKILL.md,一步步執行,用完收回口袋 | 載入 SOP |
| 要查 | SOP 指示時才疊上 References,省大筆 token | 載入小抄 |
| 要動手 | 才跑 Scripts,大腦出策略、腳本出勞力,100% 精準 | 腳本動手 |
該載的才載、該查才查、該算才算。這就是為什麼 skill 又快、又省、又不裝傻。
回扣先備知識:Context 是有限的桌子,只把當下要用的放上桌。
直覺例 · 漸進式披露
那四態有點抽象,用規劃旅遊來看一次就懂了。
平常桌上只有最上層那一句。這趟要去京都,才一路打開 itinerary.md → kyoto.md。
第二層 · SKILL.md 說明書
## Step 1、## Step 2 把步驟一段段切清楚,像帶實習生:先做什麼、再做什麼。這層只放 主幹流程,不要寫成百科全書。細節要丟到第三層去。
最實用的一招 · 治偷懶
AI 對話一拉長,就容易裝傻、跳步、省略繁瑣檢查。解法很單純。
# Critical Rules、# Important、# 重要規則 → 框成最顯眼的硬天條,Claude 當軍令狀守。規則別藏在內文裡碎碎念。用大標題蓋一個軍令狀的章,規則夠硬夠顯眼,AI 才不會偷偷省。
第三層之一 · References
龐大的稅務手冊平常不傳,只在算稅那一刻才載入,省下大筆 Token。
第三層之二 · Scripts
以前讓 AI 心算稅率乘法常出錯。交給 Python / JS 腳本跑,結果 100% 精準。
Python、Node、Bash 能讀寫檔案、呼叫 Webhook,甚至串 LINE 發推播。
寫入或敏感命令前,主動彈出 macOS 終端授權確認,物理級安全。
| 左腦 | 出策略、做判斷 | 大腦 |
| 右手臂 | 跑腳本、讀寫檔、呼叫 API、發 LINE | 腳本 |
像一個開發票 skill 範例:把稅率規則放 references、開票腳本放 scripts。
真實範例 · 會議紀錄 skill
拿一支會議紀錄總結 skill 當例子:讀會議逐字稿、自動吐出紀錄,整支就這張 SKILL.md。這支等等你會親手做(在階梯 3 之後的動手練習)。
誠實面對極限
它只能在對話框裡吐文字,碰不到真實世界。
因為它只有第二層說明書,沒有第三層的小抄跟手臂。 要查專業資料、要動真格,就得補上 references 跟 scripts。
實戰案例 02 · 進階一頁帶過
稅率規則放 references 不放說明書,是省 90% Token 的關鍵。
選講 · 三層怎麼按需上場
references 跟 scripts 不是一開始就載入,是 AI 讀到 SOP 那一步、發現需要才動用。
避坑開場
references 讓它要查才翻。沒觸發是貼紙的錯、變鈍是說明書太肥的錯,兩個都別靠加長正文來救。
照妖鏡一 · 載入失敗
--- 有沒有成對閉合?~/.claude/skills/技能名/SKILL.md?name 100% 對齊?SKILL.md?照妖鏡二 · 匹配衝突與沒觸發
念出你自己的 description,問一句:「Claude 看得出來什麼時候該用嗎?」看不出來,就是關鍵詞不夠。
沒觸發 = 路由問題,改貼紙,不改正文。
照妖鏡三 · AI 裝傻跳步
對話裡直接點名,強制 AI 讀指定光碟。
回 SKILL.md,把絕對不能省的規則用大標題框起來。
第二招你在 P27 會議總結光碟的 ## Critical SOP 已經看過了,現在知道它為什麼要寫成大字。
卡住怎麼辦
看到報錯,截圖或複製錯誤訊息,貼回對話:「這是剛剛的錯,幫我看怎麼回事。」
「幫我檢查 description、檔名、放的位置對不對。」九成的「沒反應」都出在這三個。
「剛剛這個 skill 沒被叫出來,幫我看哪裡沒對上。」它能回頭檢視這段 session,找出原因。
你不用開什麼日誌、記什麼指令。除錯這件事,本來就可以丟回給 AI 自己做,它比你會查。
手把手開場
接下來不是再聽我講,是你親手做出第一張 Skill。
Customize Panel 長怎樣。
建目錄、貼貼紙、寫 SOP。
當場自測 description。
這片光碟之後怎麼長大。
聽夠了,動手做一張。全程只說自然語言,不寫一行 code。
不碰指令也行
桌面 App 真的有一個圖形面板,能看、能一鍵開關你「從 App 加進來」的 skill。
.claude/skills/,Claude Code 直接讀、自動觸發。一句話分清楚:面板管「從 App 加的」skill;你做的 skill 住在資料夾、Claude Code 自己讀。
先看全貌
這三步你都不用自己手動敲。你動腦,Claude 動手。
在 ~/.claude/skills/ 底下開一個 seo-content-planner/ 資料夾。一片光碟 = 一個資料夾。
兩條 --- 之間寫好 name 跟 description,這是光碟最外層的標籤。
白話條列做事流程,再用大字標頭蓋上「軍令狀」治偷懶。
動手 30 分鐘、3 步、第一片光碟。你動腦想清楚要解決什麼,Claude 動手把檔案寫好。
STEP 01
資料夾名字就是這片光碟的名字。做 SEO 內容規劃光碟就叫 seo-content-planner/。
你不用記路徑。直接跟 Claude 說:「在我的 ~/.claude/skills/ 底下幫我建一個 seo-content-planner 資料夾」,它就建好了。
一片光碟 = 一個資料夾,這是規矩。就是第三章那張倉庫結構圖裡的同一個地方。
STEP 02
Claude 背景掃一眼 description,就決定要不要抽出這片光碟。這一行寫得好不好,直接決定光碟會不會在對的時機被叫出來。
STEP 03
# Critical SOP、# Important。說明書只留主幹,要查的細節留到第三層。別把 SKILL.md 寫成百科全書。
三步合體
| 寫作成本 | 5 分鐘記事本就編完,不用懂程式碼。 |
| 硬約束效果 | 規則進 Critical SOP,又硬又顯眼,AI 不敢省。 |
這就是你帶得走的第一個 Skill。寫作成本低到不可思議,效果卻很硬。
進階捷徑
官方的 skill-creator 會訪談你、幫你起草、自動跑測試,下次不用從零來。先看 Claude 怎麼裝。
Claude:Customize ▸ Skills ▸ 搜「skill」▸ 裝官方的 /skill-creator

進階捷徑 · 換工具
codex:外掛程式 ▸ 搜「skill」▸ 在 Skill Creator 上點「新增 skill」

為什麼今天還要你手動做一遍?先親手走過,你才看得懂它生出來的東西、也改得動。會看地圖的人,才敢放心開快車。
寫完必做
這三句,正好對上官方「每個 skill 至少寫三個評測」的建議。
使用者一定會這樣說的話。
「用『除濕機推薦』規劃一篇 SEO 內容」
確認叫得出來。
講得模糊、但其實同一件事。
「這個關鍵字要怎麼寫才排得上去」
確認也叫得出來。
相近、但其實不該用這片光碟。
「幫我回一封跟客戶道歉的信」
確認它「不會」誤觸發。
鐵律:沒觸發是「路由」問題,不是「內容」問題。先改 description,別急著加長 SKILL.md 內文。
技術端 · 進階
三句話是手動快測。想做到位的人,官方的做法是再往前一步。
行銷端:三句話夠用|技術端:往這走。這段給想做到位的人,聽過知道有這條路就好。
收束預告
你今天在第 01 格,下午一階一階往上爬,親眼看光碟從純文字長成三層俱全的真實 skill。