開場提問
既然能直接跟 AI 講規則，
為什麼還要做 Skill？
這是你心裡一定會冒出來的問題。動手做第一個 skill 之前，先把這條「老路」的問題講透，你才會懂 skill 到底在解什麼。
先講結論：把規則塞進對話這條路，有 四個死穴。接下來幾頁，一個一個拆給你看。
接下來要拆的四個死穴 ↓
① 字數爆炸
② 極難維護
③ 費用高昂
④ 死板硬背
AGENT SKILL 一日工作坊 · 階梯 2 / 11
這是全天最核心的一章。你會親手做出第一張屬於自己的超能力外掛卡 ── 一個資料夾、一份 SKILL.md，用記事本就寫得出來，一句話就能叫它出來幹活。
開場提問
這是你心裡一定會冒出來的問題。動手做第一個 skill 之前，先把這條「老路」的問題講透，你才會懂 skill 到底在解什麼。
先講結論：把規則塞進對話這條路，有 四個死穴。接下來幾頁，一個一個拆給你看。
接下來要拆的四個死穴 ↓
根本原因 一
所有 SOP + 家規 + 限制 + 工具定義，全部攤在桌上。桌子被塞爆，AI 看不清哪個才是重點。
就像考前一晚把整本課本硬塞進腦袋，進了考場反而腦袋一片空白。
資訊超載 → 注意力分散。還記得先備知識那張「有限的桌子」嗎？桌上堆太多，就什麼都看不清。
根本原因 二
遇到繁瑣的檢查，如果沒有一份物理性的 SOP 硬性約束，AI 常常會自己偷偷省略，然後就執行失敗。這不是 AI 壞掉，是注意力被稀釋的必然結果。
傳統解法
把所有規矩一次寫好(例如 CLAUDE.md)，每次對話整包塞給 AI。規則寫死了，總不會忘了吧？
# CLAUDE.md ── 全域家規(往下捲不完) [DO NOT] 不准在 root 建檔案... [ALWAYS] 每次都要先讀檔案... [DO NOT] 不准用 grep / find / cat... [ALWAYS] commit 後一定要 push... [DO NOT] 不准建立重複檔案... ⋮ ( 還有好幾百行 )
聽起來很合理對吧？下一頁讓你看看，它可以誇張到什麼程度。
真實案例
2025 年中被外流的 Claude 系統提示詞，竟然高達將近 2.4 萬 Token。
# ROLE CONFIGURATION You are a highly-capable, autonomous AI system... # BEHAVIORAL CONSTRAINTS 1. DO NOT assume anything not in the user query. 2. ALWAYS perform deep multi-step verification. ⋮ ( 角色、約束、合規⋯⋯ 還有好幾百行 )
你每次對話，還沒開始做事，這 2.4 萬 Token 就先被傳一遍。
章節 ANCHOR
每次對話都重傳幾千字背景，還沒做事就先累。
後果：開場就被塞滿，正事還沒開始就先燒一筆。
改一條小規則，得回頭翻過所有對話跟檔案。
後果：規則散在四處，改一條漏三條。
重複傳的那幾千字，每一輪問答都在計費。
後果：幾十輪對話，預算被重複的字默默吃光。
規則塞太多，AI 變僵硬，反而跳步裝傻。
後果：該靈活時不敢，反而更容易出錯。
記住這四個 ── 等一下你會看到 skill 剛好把它們全治了。
死穴 01 / 04
你得寫一張厚厚的全域家規紙塞給 AI。每一次對話，都得把這幾千字重複傳一遍。結果就是：你還沒開始交辦正事，光是「背家規」就已經把 AI 累個半死、把開場塞滿。
事情都還沒做，負擔先到。
死穴 02 / 04
同一條規則被複製在好幾個地方，改了一個，其他還是舊的(紅線處不一致)。
規則散在四處，維護成本高到嚇人。這是最容易被忽略，但長期最痛的問題。
死穴 03 / 04
每一次問答，都在重複傳送那幾千字的背景廢話。這些字不是拿來做事的，是拿來「複習家規」的 ── 但它一樣計費。
重複背景字 × N 輪 = 看不見的帳單。幾十輪對話下來，預算就被這些重複的 Token 默默吃光。
死穴 04 / 04
當你把 AI 的腦袋塞滿一條條框框，它的回答會變得無比死板。該靈活的時候它不敢靈活，因為滿腦子都是「不准這樣、一定要那樣」。
規則塞太多，換來的不是更聽話，是更僵硬。這也呼應前面：注意力被稀釋，反而更容易跳步裝傻。
收束 · 接到 SKILL
四個表面症狀
往下挖，根因只有一個 ──
規則塞進對話、每次重講。
規則做成一張卡
要用再抽
根因都是同一個：你把規則塞進對話、每次重講。那如果規則做成一張卡、要用再抽呢？規則別用嘴巴一直重講 ── 做成一張卡，要用再抽。
什麼是 AGENT SKILL
階梯 1 那個一次性的 prompt，用完就散了。現在正式給它一個名字 ── Agent Skill，一套統一開放協定，把知識、規則、工具打包成一張實體小卡。
用記事本就能寫的 Markdown SOP，不需要懂任何深奧程式碼。
不用它的時候完全不佔大腦空間，喊到對的任務才把卡抽出來。
為什麼不塞進對話就好
傳統做法是寫一份落落長的全域家規檔(像 CLAUDE.md)，每次對話整包塞給 AI。聽起來很直覺，但這條老路有四個過不去的關卡。
每次重複傳幾千字背景，還沒做事就先燒一堆 token。
改一條小規則，得回去翻所有對話跟檔案。
重複傳的那幾千字，每一次問答都在計費。
規則塞太多，AI 注意力被稀釋，反而跳步、裝傻、忘記限制。
負重前行 VS 輕裝上陣
AI 出門前得重新背一遍三千字全域家規，背著一堆沉重的垃圾文字上路，滿頭大汗。
AI 平常 100% 輕裝，描述對上了才瞬間載入那張卡，用完立刻放回口袋。
載入狀態 ── 負重前行，每次都背一遍 ↔ 輕裝上陣，要用才載入
Token 消耗 ── 重複傳一直燒，又慢又貴 ↔ 用完收回，省下高達 90%
變革的核心價值
背景自動匹配、毫秒級喚醒，不用任何人手動貼提示詞，隨時待命。
只把最關鍵的規則貼在大腦上，省去 90% 的上下文廢話開銷。
卡片與對話徹底解耦，改一份 Markdown，所有助理瞬間同步。
不用會程式
Markdown 是一種用純文字符號標記格式的寫法，像記事本一樣簡單。同一份檔案 ── AI 跟人，兩邊都讀得懂。
你寫的純文字
# 關鍵字清理流程 - 去掉重複項 - 全部轉小寫 這步**絕對不能省**
關鍵字清理流程
• 去掉重複項
• 全部轉小寫
這步 絕對不能省
一張卡的長相
最小就是一個資料夾、裡面一個 SKILL.md。上半是 YAML 識別貼紙，下半是 Markdown 做事步驟。
--- name: keyword-cleaner description: 清理雜亂的關鍵字清單，去重、 轉小寫、排序。當使用者貼上關鍵字 清單或提到「清理關鍵字」時使用。 --- # 關鍵字清理流程 1. 讀取使用者提供的 csv 或貼上的清單 2. 去掉重複項 3. 全部轉小寫、去掉前後空白 4. 按字母排序 5. 輸出乾淨清單
兩條 --- 之間的 name 與 description。
Markdown 列點寫的流程，AI 照著做。
下一頁逐層拆解三層結構 →
三明治結構 · 開場
解剖之前先回答最務實的問題：做好的卡放在哪？一個 skill 就是一個資料夾，你不用背路徑，但要看得懂這張地圖。
# 你家目錄底下的隱藏資料夾 ~/.claude/ └── skills/ └── my-first-skill/ ├── SKILL.md └── scripts/ └── helper.sh
核心隱喻
整章最重要的一張圖。先記住三層的「分工」，後面三頁再各別拆開。
負責「被認出來」。Claude 背景掃一眼 0.05 秒，就知道這張卡是幹嘛的。
負責「教 AI 做事」。命中之後才載入這份 SOP。
負責「查資料跟動手」。小抄與道具，要用才翻、要算才跑。
第一層 · 識別貼紙
--- 之間，只有 兩個欄位--- name: meeting-assistant description: 總結會議內容、整理 待辦與決議。當使用者說「幫我 總結剛才的會議」時使用。 ---
這張卡的唯一識別名稱，小寫加連字號。Claude 載入與環境匹配靠它，要跟資料夾同名。
極具體的白話描述，告訴 AI「這卡幹嘛、什麼時候用」。越具體，命中率越高。
關鍵機制 · Live Demo 等級
使用者打出一句話,AI 掃描指令裡的關鍵意圖。
同時比對所有本機 skills 的 description,精準命中那一張。
命中後才去讀 SKILL.md,大腦瞬間學會這套 SOP。
第二層 · SKILL.md 說明書
結構化 Markdown，像教剛上工的實習生：先做什麼、再做什麼。
強調「什麼不能做」，嚴防 AI 發揮過度想像力捏造或跳步。
# 會議總結流程 1. 讀取逐字稿 2. 抓出待辦與決議 3. 標出負責人與期限 4. 依模板輸出 # Important 重要規則 - 沒寫到的不要自己編 - 待辦一定要標負責人
最實用的一招 · 治偷懶
AI 對話一拉長，就容易裝傻、跳步、省略繁瑣檢查。解法很單純。
碎碎念塞在段落中間 → AI 拉長對話就忘，該檢查的不檢查。
# Critical Rules、# Important、# 重要規則 → 死死鎖在核心記憶，當成軍令狀。
# Important 重要規則 - 待辦事項一定要標出負責人，缺一個都不能輸出 - 原文沒提到的決議，絕對不准自己補
第三層之一 · References
複雜計算公式、國家稅務法規、API 規格這類幾萬字檔案，灰著、不載入，AI 根本不去讀(零記憶干擾)。
只有當 SOP 說「查稅率」那一刻，才翻開瞄一眼。算稅那瞬間才載入，平常不傳。
references/ ├── tax_guide.md # 稅率表，幾萬字 ├── item_codes.md # 品項代碼對照 └── output_format.md # 輸出範本
第三層之二 · Scripts
以前讓 AI 心算稅率乘法常出錯；交給 Python / JS 腳本跑，結果 100% 精準。
Python、Node、Bash 能讀寫檔案、呼叫 Webhook，甚至串 LINE 發推播。
寫入或敏感命令前，主動彈出 macOS 終端授權確認，物理級安全。
大腦與手臂的黃金配合
把三層串成一個畫面收尾：雙劍合璧，自動化才真正靠譜。
AI 大腦，有創造力，負責構圖與判斷。
Scripts。讓他能觸碰外面的實體畫紙：讀檔、連資料庫、點網頁。
Skills。教他畫出世紀大作的步驟，該做什麼、不該做什麼。
整章設計哲學 · 壓軸
回扣先備知識：Context 是有限的桌子 — 漸進式披露，就是只把當下要用的東西放上桌。
實戰案例 01
開完會丟一段逐字稿，Claude 自動吐出格式漂亮的繁中紀錄，主題、決議、任務表、待討論一次到齊。
每次都得重講一遍格式要求，AI 還常常漏項。同一句指令打第十遍。
一句「幫我總結會議」，格式自動齊全，主題、決議、任務表一項不少。
逐層拆解
--- name: meeting-summary description: 會議結束後自動整理重點摘要、待辦事項與決議。當使用者提到「會議總結」、「整理會議紀錄」時觸發。 --- # 會議總結助手 ## Critical SOP 1. 提取會議主題與日期。 2. 列出所有決議事項清單。 3. 整理指派任務表格(負責人 / 截止日)。 4. 標記未解決的待討論事項。 ## Important - 輸出語言：**台灣繁體中文** - 禁止捏造未提及的決議內容。
description 把「做什麼 + 何時觸發」一句寫滿，把使用者真會說的話塞進去當觸發詞。
大標題框起四個步驟，這是治偷懶的軍令狀。
鎖死兩條天條，輸出台灣繁中、禁止捏造決議。
誠實面對極限
它只能在對話框裡吐文字，碰不到真實世界。
不能自動把紀錄存成檔案。
不能丟上 Drive 或 Notion。
不能通知沒參加的同事。
碰不到任何真實世界服務。
實戰案例 02 · 進階一頁帶過
~/.claude/skills/taiwan-invoice/ ├── SKILL.md <- 第二層：貼紙與 SOP ├── references/ │ ├── tax_guide.md 含稅/未稅轉換 │ ├── item_codes.md 品項代碼表 │ └── output_format.md XML 輸出格式 └── scripts/ └── issue_invoice.py 串平台 + LINE 推播
SKILL.md 說明書，決定先做什麼。
稅務手冊上萬字，平常不讀，要算稅那一刻才翻。
乘稅率交給 Python，算 100% 精準。
選講 · 三層怎麼按需上場
避坑開場
卡片根本不會被觸發。9 成的「沒反應」都是這個，最痛也最常見。
步驟寫成上百行百科全書，把 AI 的桌子塞爆，反而開始跳步。
一大張稅率表硬塞進 body，而不是放 references 讓它要查才翻。
照妖鏡一 · 載入失敗
--- 有沒有成對閉合？~/.claude/skills/技能名/SKILL.md?name 100% 對齊？SKILL.md?# 資料夾名與 name 必須一致 ~/.claude/skills/meeting-summary/SKILL.md └─ 對齊 ─┐ name: meeting-summary <- 100% 一致
照妖鏡二 · 匹配衝突與沒觸發
「好用的工具」,Claude 看不出什麼時候該用，不觸發，而且容易跟別的卡撞名。
「當需要開立台灣電子發票並計算 5% 營業稅時呼叫」，關鍵詞夠多，精準命中。
照妖鏡三 · AI 裝傻跳步
對話裡直接點名，強制 AI 讀指定卡片。
# 直接打給 Claude 請用 meeting-summary 這個 skill 整理會議紀錄
回 SKILL.md，把絕對不能省的規則用大標題框起來。
# Critical SOP # 大字標頭被當軍令狀 # 對話再長也不跳步
## Critical SOP 已經看過了，現在知道它為什麼要寫成大字。硬底子排錯
找出哪一步 YAML 匹配失敗。
~/.claude/logs/把背景匹配、references 讀取整條流程印成日誌。
--verbosePermission Denied，忘了給腳本執行權限。
chmod +x scripts/fetch.sh
手把手開場
前面看完結構、看完兩個 Ordilux 真實案例。接下來這一段不是再聽我講，是你親手做出第一張 Skill。
Customize Panel 長怎樣
建目錄、貼貼紙、寫 SOP
當場自測 description
這張卡之後怎麼長大
不碰指令
給不想碰黑底終端機的人一顆定心丸。左側點一下 Customize，所有技能卡一目瞭然列在右邊。
┌──────────────┬────────────────────────────┐ │ Code │ # 已載入技能卡 │ │ Routines │ │ │ ▸ Customize │ [ON ] taiwan-invoice │ │ More │ [ON ] ig-reel-downloader │ │ │ [OFF] git-commit ← 待掛上 │ └──────────────┴────────────────────────────┘
先看全貌
這三步你都不用自己手動敲。你動腦，Claude 動手。
在 ~/.claude/skills/ 底下開一個 git-commit/ 資料夾。一張卡 = 一個資料夾。
兩條 --- 之間寫好 name 跟 description，這是卡片最外層的標籤。
白話條列做事流程，再用大字標頭蓋上「軍令狀」治偷懶。
STEP 01
~/.claude/skills/ # 第三章看過的同一個地方 │ ├── taiwan-invoice/ ├── ig-reel-downloader/ │ └── git-commit/ # ← 新增(高亮) └── SKILL.md # 待放，下一步寫
git-commit/。STEP 02
--- name: git-commit description: 自動產生符合規範的 git commit message。當使用者說「幫我 commit」、 「寫個 commit message」、「提交這次 變更」時觸發。 ---
載入與匹配的鑰匙。用小寫加連字號。
決定 Claude「何時」自動抽出這張卡。寫越具體、把使用者真會說的話塞進去，命中率越高。
STEP 03
# 會議紀錄產生流程 1. 讀逐字稿，抓出決議事項 2. 條列待辦，標出負責人 # Critical SOP 🔴 軍令狀 - 每條待辦一定要有負責人 - 日期一律 YYYY-MM-DD # Important 🔴 軍令狀 - 找不到負責人就標 [待確認] - 絕不自己編造結論
# Critical SOP、# Important。三步合體
git-commit/ └── SKILL.md ───────────────────────────── --- name: git-commit description: 自動產生 commit message。當使用者說「幫我 commit」、「提交變更」時觸發。 --- # git commit 流程 1. 讀 git diff，歸納改了什麼 2. 寫一行精準的標題 # Critical SOP - 格式：type(scope): 說明 - 標題不超過 50 字
一個資料夾 + 一份 SKILL.md。上半是 YAML 貼紙，下半是 SOP 說明書。
寫完必做
使用者一定會這樣說的話。
「幫我 commit 這次變更」
確認叫得出來。
講得模糊、但其實同一件事。
「這些改動幫我整理一下提交訊息」
確認也叫得出來。
相近、但其實不該用這張卡。
「幫我看這段程式有沒有 bug」
確認它「不會」誤觸發。
技術端 · 進階
三句話是手動快測。想做到位的人，官方的做法是再往前一步。
不只測三句，跑 10 到 20 個測試句，數它「自動觸發」的比例。抓 90% 以上才算合格。
拿「有掛 skill」跟「沒掛 skill」做同一件事，各花幾輪對話、各燒多少 token 比一比。數字會直接告訴你這張卡有沒有省到力。
收束預告
純文字 SOP。
你今天在這。
Critical 軍令狀，治 AI 偷懶。
稅率表、範本拆出去，省 token。
精準計算、檔案操作交給腳本。
持續調整，沉澱成偏好檔。
＝三層俱全的真實 skill。