AGENT SKILLS · MASTER CLASS

01 / 42

Agent Skills
給 AI 插上
超能力外掛卡

1 小時快速通關 · 解鎖 AI 無限戰力主講人：阿魁

CLAUDE CODE & AGENT SKILLS 2026.05

MODULE 1 · CURRICULUM MAP

02 / 42

課程地圖 · CURRICULUM MAP

1 小時快速通關，解鎖 AI 無限戰力

01

痛點與解方

AI 丟三落四與 Skills 革命

02

結構拆解

三層積木與按需加載哲學

03

實戰案例

從會議總結到發票按需加載

04

動手實踐

用 Claude Code 打造第一個 Skill

05

除錯診斷

避坑指南與三大照妖鏡

06

開放標準

跨平台生態與課後行動

MODULE 1 · BRAIN LIMITATION

03 / 42

AI 大腦局限性 · BRAIN LIMITATION

為什麼 AI 總是丟三落四？

MEMORY BURDEN

記憶體極限的瓶頸

資訊超載 ── 一次把所有的 SOP、家規、工具全部塞在對話裡，大腦就會陷入資訊爆炸，導致注意力分散。
考前抱佛腳 ── 這就像是在期末考前一天，把所有的課本一口氣塞進腦袋，結果進考場什麼都記不得！

ATTENTION DILUTION

注意力稀釋的致命傷

規則稀釋 ── 當對話歷史拉長，AI 就會開始遺忘先前交代的限制，開始裝傻、跳步。
AI 敷衍發懶 ── 沒有物理性的 SOP 強制，AI 遇到複雜步驟就會自主省略，導致執行失敗。

MODULE 1 · SYSTEM PROMPT CAGE

04 / 42

SYSTEM PROMPT CAGE

2.4 萬 Token 的
「提示詞牢籠」

在 2025 年中，被洩露的 Claude 系統提示詞竟然高達將近 2.4 萬 Token！為了解決 AI 忘東忘西，我們被迫塞滿落落長的全域規則。這種「人肉碎碎念」不僅稀釋了大腦注意力，更成為無法維護的代價噩夢。

CLAUDE_SYS_PROMPT (LEAKED) ● 23,800+ TOKENS

# ROLE CONFIGURATION
You are a highly-capable, autonomous AI system. You must maintain strict compliance with all system-level guidelines.

## BEHAVIORAL CONSTRAINTS
1. DO NOT assume anything that is not in the user query.
2. ALWAYS perform deep multi-step verification.
3. If an error is detected, perform surgical repair immediately.
4. DO NOT explain what the code does unless explicitly requested.
5. Avoid conversational filler such as "Sure", "I can help with that".

## COMPLIANCE & SAFETY
6. Always check double braces in expressions.
7. Always configure Error Trigger node in n8n.
8. Maintain 100% Traditional Chinese inside prompt variables.
9. Ensure zero border-radius and zero box-shadow in CSS files.
10. Do not use TailwindCSS unless specified by user.

## OPERATIONAL DIRECTIVES
11. Read SKILL.md before proceeding with any automation task.
12. Scan all YAML stickers in the local workspace directory.
13. If directory does not exist, throw an exception.
14. Always use Batch mode when calling API endpoints.
15. Limit network requests to absolute minimum.
... [System Prompt truncated due to context overflow] ...
... [Rule 157: Always check git diff before committing] ...
... [Rule 192: Do not use generic colors like red or green] ...

MODULE 1 · PROMPT PAIN POINTS

05 / 42

提示詞工程瓶頸 · PROMPT PAIN POINTS

「碎碎念家規」的 4 大死穴

01 · 字數爆炸

以前得寫一張厚厚的 CLAUDE.md 全域家規紙塞給 AI，每次對話都得重複傳送幾千字，還沒做事就累了。

02 · 極難維護

只要稍微修改一個細小規則，就得手動去改所有對話框或專案檔案，維護成本高到嚇人。

03 · 費用高昂

每次問答都在重複傳送一樣的幾千字背景廢話，狂燒你的荷包，預算迅速被 Token 吃光。

04 · 死板硬背

AI 腦袋塞滿限制，回答變得無比死板，缺乏靈活性，完全失去變通能力。

MODULE 1 · WHAT IS AGENT SKILLS

06 / 42

什麼是 Agent Skills · DEFINITION

什麼是 Agent Skills？

給 AI 插上的專屬「超能力外掛卡」

它用統一的開放協定格式，將知識、規則與自動化工具打包成一張實體小卡片。用記事本就能寫的 Markdown SOP，不需要懂任何深奧的程式碼！ 當不需要它時，它完全不佔用大腦空間，讓 AI 輕裝上陣！

FORMAT

標準 Markdown + YAML

ECOSYSTEM

跨平台一鍵掛載

MODULE 1 · COMPARE

07 / 42

新舊模式對比 · COMPARE

「家規紙」 vs 「超能力外掛卡」

TRADITIONAL PROMPT

碎碎念家規（傳統模式）

負重前行 ── AI 出門前得重新背一遍 3,000 字全域 CLAUDE.md 家規紙。做任何事都要帶上這包沈重的垃圾文字。
效率低下 ── 來回對話中不斷重複載入系統提示詞，不僅拖慢反應速度，還浪費大量 Token 費用。

AGENT SKILLS

超能力外掛卡（Skills 模式）

輕裝上陣 ── AI 平常保持 100% 輕裝。只有當你喊出關鍵指令時，它才從口袋裡瞬間按需加載這張外掛卡。
高效省錢 ── 用完立刻放回口袋。不僅讓 AI 的反應速度飆升，更能幫你省下高達 90% 的 Token 開銷！

MODULE 1 · CORE VALUES

08 / 42

變革的核心價值 · CORE VALUES

為什麼 Skills 能成為自動化新革命？

FAST

極致提速

背景自動匹配，毫秒級喚醒，不需要任何人手動複製提示詞，隨時待命。

SAVE

超省荷包

只把最關鍵的規則貼在大腦上，省去 90% 的上下文廢話開銷，大筆削減成本。

EASY

輕鬆維護

卡片與對話徹底解耦，你只要修改專案裡的那份 MD 文件，所有助理助理瞬間同步！

MODULE 1 · MARKDOWN BASICS

09 / 42

一分鐘認識 Markdown · BASICS

別怕，Skills 用的
就是 Markdown

Markdown 是什麼？ 一種用純文字符號標記格式的寫法，像記事本一樣簡單。不需要任何程式基礎，用 # 標題、- 列點、**粗體** 就能寫出結構化的文件。

// Markdown 語法 → 對應效果

# 大標題　　　→　最大的標題

## 二級標題　　→　次級標題

**粗體文字**　→　粗體文字

- 列點項目　　→　• 列點項目

1. 編號項目　→　1. 編號項目

---　　　　　　→　分隔線

FOR AI

AI 讀 Markdown 的 # 和 ## 就像人類看目錄，瞬間抓到重點結構

FOR HUMAN

不需要學程式，用記事本就能編輯。GitHub、Notion 也通通用它

MODULE 2 · FILE STRUCTURE

10 / 42

檔案目錄結構 · FILE STRUCTURE

一張圖看懂 Skill 住在哪裡

// 電腦家目錄 ( Home Directory )

~/.claude/

└── skills/

└── my-first-skill/

├── SKILL.md ── 說明書

└── scripts/

└── helper.sh ── 自動化腳本

* Claude Desktop / App 一切自動化皆在此處

~/.claude/

大腦專屬隱私空間

Claude 自動化助理的本機家目錄，所有安全設定與偏好皆在此處。

skills/

超能力倉庫

存放所有技能的倉庫。每個子資料夾代表一張超能力外掛卡。

SKILL.md

魔法說明書

唯一的核心文件。用白話文寫好做事 SOP 流程，並用大字級鎖定限制規則。

MODULE 2 · SANDWICH

11 / 42

三明治結構 · STRUCTURE

超能力卡片的三明治結構

01 LAYER

識別貼紙 ( YAML )

最外層貼紙，包含卡片名稱與描述，AI背景 0.05 秒認出它，決定是否加載。

02 LAYER

魔法說明書 ( SKILL.md )

中間指令層，使用白話條列式寫明做事的 SOP 流程以及防呆防發懶天條限制。

03 LAYER

小抄與道具 ( References & Scripts )

最底層實體自動化 Python / JS 腳本與參考指南。AI 讀完 SOP 直接查閱並動手幹活！

MODULE 2 · YAML STICKER DETAIL

12 / 42

YAML 貼紙細節 · STICKER DETAIL

第一層：YAML 識別貼紙

SKILL.md ── YAML Frontmatter

---

description: 會議結束後自動整理

重點摘要、待辦事項與決議。

當使用者提到「會議總結」、

「整理會議記錄」時觸發此 skill。

---

name

唯一識別名稱

AI 載入與環境匹配的鑰匙，用小寫加連字號命名，像 meeting-assistant 這樣一眼看懂。

description

極其具體的白話描述

告訴 AI 這張卡是幹嘛的、什麼時候觸發。寫得越精準，AI 的匹配命中率越高。

--- ... ---

標準 YAML Frontmatter 格式

包裹在三條短橫線之間的輕量鍵值對，AI 背景掃描只需 0.05 秒即可完成辨識。

MODULE 2 · SKILL MATCHING DEMO

13 / 42

Skill 匹配實況 · LIVE DEMO

看 AI 如何自動匹配 Skill

Claude Desktop

幫我總結剛才的會議內容

🔍 掃描 skills/ 目錄... 命中 meeting-assistant

📖 載入 SKILL.md... 完成

收到！我已載入會議總結助手，正在按照 SOP 整理...

01

意圖識別

AI 掃描使用者指令中的關鍵意圖，理解你真正想做什麼。

02

背景匹配

0.05 秒比對所有 YAML 貼紙的 description，精準鎖定目標。

03

按需載入

命中後才翻開 SKILL.md，大腦瞬間學會 SOP。

MODULE 2 · SECOND LAYER

14 / 42

說明書 · SECOND LAYER

第二層：SKILL.md 魔法說明書

BRAIN GUIDANCE

AI 大腦的動作指南

白話 SOP 流程 ── 採用結構化的 Markdown 語法，像教導剛上工的實習生一樣，寫清楚先做什麼、再做什麼。
重要規則限制 ── 強調「什麼不能做」，嚴防 AI 發揮過度想像力，避免工具調用發生災難。

MARKDOWN RULES

用大字級蓋上『防懶軍令狀』

大字固化天條 ── 採用在說明書中使用『## Important』或『## Critical』大字級標頭，強制蓋上軍令狀！
記憶死鎖 ── AI 背景匹配卡片時，大字級標頭的限制會死死鎖定在大腦核心記憶體中，徹底治好 AI 敷衍偷懶！

MODULE 2 · SKILL.md EXAMPLE

15 / 42

原始碼實例 · SOURCE CODE

原來 Skill 文件這麼簡單！

SKILL.md ── VS Code

---

description: 當使用者想要整理或總結會議內容時觸發

---

# 會議紀錄總結助理

## Critical Rules

- 必須將結論、決議、待辦事項以表格整理，嚴禁換行！

## Step-by-step SOP

1. 閱讀對話歷史中的會議逐字稿。

2. 提取出核心主題、待辦事項與指派負責人。

3. 輸出乾淨優雅的台灣繁體中文簡報級表格。

FRONTMATTER 貼在最外面

AI 一眼看懂功能！貼在最外面 AI 一眼看懂功能，不需要換行，利於閱讀。

SOP & CRITICAL 寫在內部

用最清晰的 Markdown 寫好流程與防懶軍令狀，AI 100% 聽話！

WRITING COST

不用懂程式碼，5分鐘完成

MAINTENANCE

純文字記事本即可編輯

MODULE 2 · THIRD LAYER

16 / 42

外部小抄 · THIRD LAYER

第三層：References 外部小抄

MERGED DOCS & TEMPLATES

合併文件與格式範本

稅務與計算手冊 ── 包含複雜的計算公式、國家法規或 API 介面規格，供 AI 在細節處作精確的對比查證。
標準輸出 Template ── 提供固定格式（如 XML、JSON 或 Markdown 表格格式），供 AI 開立時進行結構化對齊。

LAZY-LOAD VALUE

按需查閱：平常大腦根本不讀

零記憶干擾 ── 這些高達幾萬字的小抄平時藏在幕後。AI 大腦平常只專注於主幹 SOP 推理，根本不去讀取它們。
雙向省錢 ── 只有當 AI 這一步需要查閱特定規則時，才翻開 References 瞄一眼。大筆節省 Token 開銷！

MODULE 2 · AUTOMATED SCRIPTS

17 / 42

自動化道具 · SCRIPTS

隱藏武器：Scripts 腳本

REAL WORLD PHYSICAL HANDS

為 AI 裝上真實世界的雙手

擺脫心算與不確定性 ── 以前讓 AI 開發票，AI 大腦做乘法稅率常出錯。把腳本交給 Python/JS 執行，結果 100% 精準無誤！
做實體粗活 ── Python、Node.js 或是 Bash 腳本可以幫 AI 自動讀寫電腦檔案、呼叫 Webhook，甚至串接 LINE 發送推播！

SECURE SANDBOX EXECUTE

沙箱隔離與本地執行

本地極速運作 ── 所有 Python 腳本或 Shell 腳本均在本機目錄下執行，零網絡延遲。
授權確認保障 ── AI 在執行任何寫入或敏感命令前，均會主動彈出 macOS 系統終端授權確認，保證物理級安全。

MODULE 2 · CO-WORK

18 / 42

大腦與手臂的黃金配合 · SYSTEM COOPERATE

大腦說明書
與機器人手臂

動作指南與物理接口的結合 ── SOP 說明書（Skills）負責教導大腦該做什麼；而底層腳本（Scripts）則充當物理機械臂，幫 AI 讀取檔案、連接資料庫、點擊網頁。兩者雙劍合璧，自動化才真正靠譜！

大眾秒懂的達文西畫畫指南 · ANALOGY AI 大腦就像是一位富有創造力的藝術家，物理機械手臂 給了他畫架與畫筆，讓他能觸碰到外面的物理畫紙；而 Skills 技能卡 則是教導他如何畫出世紀大作的『畫畫 SOP 指南』！

MODULE 2 · KEY TAKEAWAY

19 / 42

漸進式披露 · PROGRESSIVE DISCLOSURE

漸進式披露：AI 只讀它當下需要的東西

LAYER 1 & 2

貼紙 + SOP 說明書

YAML 元數據讓 AI 背景 0.05 秒認出它。命中之後才翻開 SKILL.md，按照 SOP 一步一步執行。用完就收回口袋。

REFERENCES

外部小抄按需查閱

將龐大的法規、範本、計算公式放在 References 資料夾。AI 平常不讀，只在 SOP 指示時才翻開查閱，大筆省下 Token 開銷。

SCRIPTS

自動化腳本精準執行

Python 或 Shell 腳本幫 AI 做精準計算和實體操作。大腦出策略，腳本出勞力，結果 100% 精準不偷懶。

MODULE 3 · CASE STUDY I

20 / 42

CASE STUDY I

30 秒看懂：
會議總結助手

用超簡單的純文字 Skill 卡片，讓 AI 動態匹配並輸出格式完美的繁體中文會議紀錄！

案例一：會議紀錄整理

極簡 SOP，一眼秒懂

CORE CONCEPT

3 STEPS SOP

01

背景關鍵字命中

當對話出現「總結會議」、「逐字稿」時，0.05 秒自動匹配 YAML 載入卡片。

02

強固定 SOP 限制

說明書強迫大腦必須提取主題、結論、待辦表格，絕不胡言亂語。

03

標準格式完美輸出

零提示詞干擾，AI 100% 聽話地輸出乾淨、專業的台灣繁體中文表格！

MODULE 3 · 簡單入門案例

MODULE 3 · MEETING ASSISTANT CODE

21 / 42

完整卡片原始碼 · SOURCE CODE

會議總結 Skill

SKILL.md ── VS Code

---

description: 會議結束後自動整理重點摘要、

待辦事項與決議。當使用者提到「會議

總結」、「整理會議記錄」時觸發。

---

# 會議總結助手

## Critical SOP

1. 提取會議主題與日期。

2. 列出所有決議事項清單。

3. 整理指派任務表格（負責人 / 截止日）。

4. 標記未解決的待討論事項。

## Important

- 輸出語言：**台灣繁體中文**

- 禁止捏造未提及的決議內容

EASY SETUP 極簡寫作

沒有任何繁雜的程式碼，僅用 Markdown 記事本，用白話文就能寫出完美的商務秘書助理！

SOP FIXATION 徹底解決偷懶

把規則寫入 Critical SOP 標頭，AI 將被徹底鎖定記憶，再長對話也不裝傻！

TRIGGER RATE

100% 精準匹配

COST REDUCTION

節省 95% 多餘 Token

MODULE 3 · REAL WORLD CONNECT

22 / 42

進階轉場 · TRANSITION

進階挑戰：當 Skill 需要連接真實世界

PURE TEXT ASSISTANT LIMIT

純文字助理的局限性

空中閣樓 ── 會議助理只能在對話框裡做純文字摘要，無法自動把會議紀錄存成檔案、上傳雲端，或發送推播。
缺乏外部資訊 ── AI 不知道客戶目前的電子發票稅務轉換規則，無法呼叫任何真實世界的金流或資料庫 API。

FULL-STACK AUTO ACTION

實體工具與小抄的覺醒

按需載入 References ── 在需要專業稅務轉換時，AI 在背景精確讀取「稅務手冊小抄」，不再心算胡猜。
Scripts 腳本動手幹活 ── 調用 Python / Shell 腳本自動開立電子發票、呼叫發票平台 API、一秒推送 LINE！

MODULE 3 · CASE STUDY II

23 / 42

CASE STUDY II

進階實戰：
台灣電子發票開立
自動化流程

擺脫重複的手動開發票地獄，串接 LINE CRM，讓 AI 結合稅務小抄與 Python 腳本完成 100% 精準自動開立！

案例二：電子發票自動開立

LINE CRM 實戰，即插即用

CORE CONCEPT

BUSINESS AUTOMATION

01

手動開發票的繁瑣痛點

核對金額、稅額計算、手動登入財政部或第三方電子發票整合服務平台，極易出錯。

02

稅額心算的不確定性

AI 大腦不擅長精確乘法心算。若算錯稅額或未稅金額，會造成嚴重的財務法規問題。

03

解方：三明治大會師

將「稅務轉換手冊」寫入 References，將「發票開立 API」寫成 Python 腳本，打造完美閉環！

MODULE 3 · 實戰案例

MODULE 3 · INVOICE SKILL STRUCTURE

24 / 42

發票 Skill 的結構設計 · STRUCTURE

發票 Skill 的結構設計

// ~/.claude/skills/taiwan-invoice/

├── SKILL.md ── 貼紙與 SOP 說明書

├── references/

│ ├── tax_guide.md ── 含稅未稅計算公式

│ ├── item_codes.md ── 財政部品項代碼表

│ └── output_format.md ── 發票 XML 輸出格式

└── scripts/

└── issue_invoice.py ── 發票 API 自動化腳本

SKILL.md

最外層貼紙與 SOP

定義「自動開立台灣電子發票」的 YAML 描述，匹配後指導 AI 依序檢查金額並執行發票開立指令。

references/

多份外部小抄按需查閱

包含稅務計算公式、品項代碼、輸出格式等多份 Markdown 小抄。AI 執行 SOP 時只翻開當前步驟需要的那一份，其餘完全不讀，精準實現漸進式披露。

issue_invoice.py

發票 API 動手道具 ( Scripts )

隔離執行的 Python 腳本。負責調用第三方電子發票平台 API，開立成功後向 LINE 發送 Webhook Push 推播通知。

MODULE 3 · FULL FLOW CHART

25 / 42

電子發票開立全流程 · LIVE DEMO

載入全流程一覽

Claude Desktop

我要開立發票，金額 1000 元

🔍 掃描 skills/ 目錄... 命中 taiwan-invoice

📖 載入 SKILL.md... 執行 SOP 流程

💡 偵測營業稅計算... 按需載入 references/tax_guide.md

⚙️ 隔離計算未稅 952 元 + 稅額 48 元... 執行 Python 腳本

收到了！發票已開立成功（號碼 AB-12345678），並已透過 LINE 推送給客戶！

01

掃描貼紙匹配

偵測 LINE 指令「開發票 1,000 元」，0.05 秒自動匹配 YAML 啟用發票 Skill。

02

按需讀取小抄

AI 發現需要計算營業稅，這時翻閱 tax_guide.md 稅務小抄，實現漸進式披露。

03

動手調用腳本

大腦下達決策命令，調用 issue_invoice.py 進行隔離精準心算與 API 開立發票。

04

LINE Webhook 推播

發票在第三方平台成功開立後，LINE CRM 自動對使用者發送開立完成通知與明細。

MODULE 3 · LAZY-LOAD HIGHLIGHT

26 / 42

關鍵亮點 · LAZY-LOAD HIGHLIGHT

關鍵亮點：References 按需載入

只在深入分析時才去翻閱小抄

這就是 「漸進式披露」 的最高境界！平時，大腦記憶體裡只有 SOP 流程。直到第 2 步 AI 意識到：「糟糕，我需要計算含稅與未稅營業稅了！」大腦才會在背景瞬間定位並讀取『tax_guide.md』這份稅務小抄。

BENEFIT I

大腦推理完全不受龐大雜亂規則干擾

BENEFIT II

節省 90% 以上對話上下文廢話

MODULE 3 · CASE RESULT

27 / 42

實戰執行結果 · CASE RESULT

執行結果與 LINE 推送

Invoice Result Line Push Notification Screenshot

3 SECONDS

極速一鍵開立

AI 自動呼叫發票系統 API，在背景 3 秒內完美開立電子發票，零人工手動介入。

LINE PUSH

無縫 LINE 推播通知

發票一經開立，系統自動向 LINE 發送 push 推播，將發票連結與開立明細送達客戶手中！

TOKEN SAVED

高達 90% Token 費用節省

因為 References 稅務小抄只在匹配時載入，避免了每次問答傳送多餘字元，節省高達 90% 上下文開銷！

MODULE 3 · FIRST PRINCIPLES

28 / 42

根本原理回顧 · FIRST PRINCIPLES

為什麼按需加載最有效率？

01

避免干擾主幹推理

大腦如果一次性塞滿萬字規則，會導致注意力稀釋，回答裝傻。保持輕量，大腦才能做出最明智的決策。

02

按需載入專業知識

只在 AI 需要計算稅率四捨五入的精確那一刻，才翻開 References 稅務小抄，保證專注！

03

隔離執行物理命令

大腦下達決策命令，具體複雜的心算與開立發票 API 呼叫，全權交給 Python 腳本隔離執行，100% 精準防呆！

MODULE 3 · COMMON MISTAKES

29 / 42

避坑指南 · COMMON MISTAKES

初學者常犯的 3 大錯誤

01 · description 寫太模糊

最外層 YAML 識別貼紙描述寫得不清不楚，導致 AI 背景靜默掃描時無法精準匹配意圖，卡片無法載入。

02 · SOP 超過 500 行

SKILL.md 寫得像一本沈重的百科全書。太冗長的流程會重新塞爆 AI 大腦，再次引發丟三落四與注意力稀釋！

03 · 忘記放 References

把海量法規、格式範本一股腦塞進中層 SOP，而不是獨立合併成「外部小抄」References 進行漸進式披露。

MODULE 3 · TROUBLESHOOTING I

30 / 42

照妖鏡一 · TROUBLESHOOTING I

照妖鏡一：Skill 載入失敗怎麼辦？

SYNTAX & FILEPATH CHECK

語法與檔案路徑校驗

YAML 語法檢查 ── YAML 元數據的短橫線 --- 是否成對閉合？縮排是否使用了非法 Tab 空格？語法錯誤會導致整個卡片報廢。
路徑層級確認 ── 檔案是否精確放在『~/.claude/skills/my-skill/SKILL.md』？子目錄名稱是否與貼紙中的 name 變數 100% 對齊？

INTENT TRIGGER OPTIMIZE

意圖描述與觸發詞優化

description 關鍵字匹配 ── 在 YAML 描述中加入明確的觸發關鍵字，如「開立電子發票」、「會議逐字稿總結」，幫助 AI 進行背景靜默意圖命中。
防呆與手動喚醒 ── 若 AI 裝傻，可以在對話中手動輸入「請幫我使用『issue-invoice』技能開立發票」，強行指示 AI 讀取指定卡片。

MODULE 3 · TROUBLESHOOTING II

31 / 42

照妖鏡二 · TROUBLESHOOTING II

照妖鏡二：破解 AI 匹配錯誤或裝傻的迷思

CONFLICT & AMBIGUITY CHECK

多卡衝突與描述模糊

排除卡片撞名與衝突 ── skills 目錄中是否存在兩個 description 描述高度相似的技能卡？描述衝突會導致 AI 陷入混亂。
描述具體化 ── 描述絕不能只寫「這是一個好用的工具」，必須明確寫出「當需要開立台灣電子發票並計算 5% 營業稅時調用」。

RESOLVE AI LAZINESS

解決 AI 裝傻、敷衍偷懶

強制觸發詞設計 ── 在 SKILL.md 中明確告知 AI：若使用者打出關鍵命令，你必須第一時間啟用本卡片 SOP 流程。
天條蓋章警告 ── 在 SOP 說明書中使用『## Critical』蓋上強制大字印章，命令 AI 絕不能省略任何計算與檢查步驟。

MODULE 4 · CLAUDE CODE

32 / 42

CLAUDE CODE

Claude Code：
你的 AI 開發搭檔

這不是簡單的終端機工具！它已完全整併進桌面 App，成為你的全能 AI 搭檔。

動手做：打造第一個 Skill

桌面 App 加持，戰力狂飆

CORE VALUE

INTEGRATED POWER

01

全自動 agent 執行

大腦能理解你的工作目錄、自動修改程式碼、閱讀 References，並在本機跑腳本。

02

桌面 App 深度整併

不再糾結終端命令列！已完全內建進 Claude Desktop App，提供極具視覺衝擊感的圖形化操作介面。

03

0 門檻啟用超能力

你只需要在 UI 點擊 Customize，將本機的技能目錄掛載載入，即可瞬間匹配啟用！

MODULE 4 · 打造你的第一個 Skill

MODULE 4 · GUI MANAGEMENT

33 / 42

Claude Desktop App

</> Code

+ New session

⚡ Routines

💼 Customize

∨ More

💼 SKILLS CUSTOMIZE PANEL

本地技能一鍵掛載與管理

taiwan-invoice 開立台灣電子發票並發送推播

ACTIVE

圖形化管理面板：一指乾淨掌控

這就是 Anthropic 為桌面 App 設計的 Skills 極簡圖形管理面板！不需要下達任何複雜的 terminal 命令。在左側點擊 Customize，你就能一目瞭然地看清所有本機載入的超能力卡，並一鍵點擊開關、極速啟用與停用！

MODULE 4 · STEP BY STEP

34 / 42

動手實踐三部曲 · TIMELINE

從零開始：打造第一個 Skill

STEP 01 建立本機目錄在 ~/.claude/skills/ 下建立專案資料夾 git-commit/

STEP 02 貼上 YAML 識別貼紙在 SKILL.md 頭部寫好名稱與什麼時候命中的 description

STEP 03 編寫 SOP 與軍令狀用純白話條列出做事流程，並用大字級鎖定 Critical 防懶規則

MODULE 4 · IG REELS DOWNLOADER SKILL CODE

35 / 42

手把手實戰原始碼 · SOURCE CODE

實戰：IG 影片下載 Skill

SKILL.md ── VS Code

---

description: 當貼上 instagram.com/reel/ 連結或說「下載 IG」時觸發。

---

# IG Reel Downloader

## 何時使用此 skill

- 使用者貼上 instagram.com/reel/ 連結

- 提到「下載 IG」「存這個 reel」「下載 Instagram」

## Critical SOP

1. 執行 bash scripts/ensure_dirs.sh 確保分類目錄存在。

2. 跑 bash scripts/probe.sh <URL> 抓取影片 description。

3. 依主題判斷分類（生態、美食、旅遊、知識、生活、迷因）。

4. 跑 bash scripts/fetch.sh <URL> <分類> 下載到對應目錄。

## Response Style

- 開頭以「魁哥。」起頭，字句精簡，嚴禁廢話。

SEMANTIC CATEGORIZATION 智慧語意分類

AI 讀完影片 metadata，自動將影片歸類到美食、生態等子資料夾，省去手動分類！

TOOL DELEGATION 大腦與雙手協同

AI 負責聰明的語意判斷，並將實體影片下載與目錄操作交給 bash 腳本，穩固自動化！

WRITING TIME

不用懂複雜程式碼，5分鐘完成

MODULE 4 · ADVANCED SKILLS

36 / 42

疊加與擴充 · ADVANCED SKILLS

加上 References 與 Scripts 道具

ON-DEMAND REFERENCES

加上「外部小抄」References

寫入分類對照小抄 ── 在 references 目錄下建立 category_rules.md，詳細寫明美食、生態等主題判定規則與範例。
按需閱讀 ── 大腦平時保持輕裝，只有在面臨「看起來像生活、又像旅遊」的模糊分類時，才精準翻閱小抄，零干擾！

AUTOMATED SCRIPTS IMPLEMENT

疊加自動化 Scripts 腳本

寫入下載實體腳本 ── 在 scripts 目錄下寫入 ensure_dirs.sh 和 fetch.sh，用來建立目錄和呼叫 yt-dlp 下載影片。
一指實體下載 ── AI 判斷完分類後，依說明書指示，呼叫 fetch.sh 自動化下載並合併影音，完成 100% 物理自動化！

MODULE 4 · TROUBLESHOOTING

37 / 42

本機實戰除錯 · TROUBLESHOOTING

當 Skill 出問題：實戰除錯技巧

DEBUG LOGS ANALYSIS

日誌查看與排除

查看除錯日誌 ── 進入『~/.claude/logs/』目錄查看 AI 當前匹配與執行記錄，找出是哪一步 YAML 匹配失敗。
詳細輸出日誌 ── 在啟用時加入『--verbose』參數，AI 會把背景匹配與 References 讀取全流程以日誌打印，病灶一目瞭然！

COMMON ERRORS RESOLVE

排除常見錯誤與日誌分析

腳本權限報錯 ( Permission Denied ) ── 忘記給腳本執行權限。本機執行『chmod +x scripts/commit.sh』即可排除。
YAML 匹配撞名與衝突 ── 兩個卡片 description 相似度極高。將它們合併，或用更具體的名詞重新定義觸發詞。

MODULE 4 · START GUIDE

38 / 42

起步指南 · QUICK GUIDE

快速起步黃金指南

01

建目錄寫貼紙

在『~/.claude/skills/』下建立資料夾，編寫帶有 name 與 description 的極簡 YAML 貼紙。

02

理清 SOP 天條

在 SKILL.md 用純白話列出做事流程，並蓋上『## Critical SOP』防發懶大字印章。

03

Customize Panel 掛載

打開桌面 App 的 Customize 面板，一鍵掛載與啟用！3 步 30 分鐘，解鎖 AI 無限超能力！

MODULE 5 · OPEN ECOSYSTEM

39 / 42

開放協定與生態 · ECOSYSTEM

Skills 是一個跨平台的開放標準

CROSS-PLATFORM STANDARD

不只侷限於 Claude Code

跨平台一卡通用 ── Agent Skills 使用的 YAML + Markdown + Scripts 標準，是一個開放的公共技能標準格式。
主流 AI 編輯器支持 ── 相同的 Skills 資料夾格式與說明書，可以無縫直接掛載到 Cursor、Windsurf 平台，一秒完成超能力轉移！

THE FUTURE IS AGENT SKILLS

技能卡生態的未來

公共技能庫庫覺醒 ── GitHub 上已湧現出海量的開源公共 Skills 卡片，從 Git 自動化、專案審查，到數據分析一應俱全。
授權 AI 幹活的靈魂 ── 這就是未來 AI 助理的核心心智與雙手。學會寫卡片，你就擁有了授權 AI 自動化一切的無上限戰力！

MODULE 5 · LEARNING RESOURCES

40 / 42

精選學習資源與技能庫 · LEARNING RESOURCES

這堂課後，你的黃金 3 大行動

01 · 今天就建立第一個最簡卡片

在『~/.claude/skills/』下建立資料夾，花 5 分鐘寫好 YAML 貼紙與 SOP 魔法說明書即可。

02 · 將高頻重複的繁雜工作 SOP 化

把每天在公司要做的發信、資料審查、周報整理等，寫成 SKILL.md 說明的條列流程，交給 AI 讀取。

03 · 分享給團隊，解鎖無上限戰力

將寫好的 skills 專案資料夾直接打包發給同仁，所有人一鍵 Customize 掛載，瞬間解鎖全團隊自動化戰力！

AGENT SKILLS · MASTER CLASS

42 / 42

THANK YOU

Set the rules.
Unlock the skills.
Automate everything.

定好規則。解鎖超能力。讓一切自動化。

Q&A 時刻，感謝聆聽

解鎖 AI 無限超能力

Q&A SESSION

ASK EVERYTHING

QA 時刻 ──

歡迎提問！無論是有關 YAML 貼紙匹配、SOP 軍令狀撰寫，還是 Python 實體自動化串接 LINE，現在就來大膽解惑！

SET THE RULES · UNLOCK THE SKILLS

Agent Skills給 AI 插上超能力外掛卡

1 小時快速通關，解鎖 AI 無限戰力

痛點與解方

結構拆解

實戰案例

動手實踐

除錯診斷

開放標準

為什麼 AI 總是丟三落四？

記憶體極限的瓶頸

注意力稀釋的致命傷

2.4 萬 Token 的「提示詞牢籠」

「碎碎念家規」的 4 大死穴

01 · 字數爆炸

02 · 極難維護

03 · 費用高昂

04 · 死板硬背

什麼是 Agent Skills？

給 AI 插上的專屬「超能力外掛卡」

「家規紙」 vs 「超能力外掛卡」

碎碎念家規（傳統模式）

超能力外掛卡（Skills 模式）

為什麼 Skills 能成為自動化新革命？

極致提速

超省荷包

輕鬆維護

別怕，Skills 用的就是 Markdown

一張圖看懂 Skill 住在哪裡

大腦專屬隱私空間

超能力倉庫

魔法說明書

超能力卡片的三明治結構

識別貼紙 ( YAML )

魔法說明書 ( SKILL.md )

小抄與道具 ( References & Scripts )

第一層：YAML 識別貼紙

唯一識別名稱

極其具體的白話描述

標準 YAML Frontmatter 格式

看 AI 如何自動匹配 Skill

意圖識別

背景匹配

按需載入

第二層：SKILL.md 魔法說明書

AI 大腦的動作指南

用大字級蓋上『防懶軍令狀』

原來 Skill 文件這麼簡單！

第三層：References 外部小抄

合併文件與格式範本

按需查閱：平常大腦根本不讀

隱藏武器：Scripts 腳本

為 AI 裝上真實世界的雙手

沙箱隔離與本地執行

大腦說明書與機器人手臂

漸進式披露：AI 只讀它當下需要的東西

貼紙 + SOP 說明書

外部小抄按需查閱

自動化腳本精準執行

30 秒看懂：會議總結助手

背景關鍵字命中

強固定 SOP 限制

標準格式完美輸出

會議總結 Skill

進階挑戰：當 Skill 需要連接真實世界

純文字助理的局限性

實體工具與小抄的覺醒

進階實戰：台灣電子發票開立自動化流程

手動開發票的繁瑣痛點

稅額心算的不確定性

解方：三明治大會師

發票 Skill 的結構設計

最外層貼紙與 SOP

多份外部小抄按需查閱

發票 API 動手道具 ( Scripts )

載入全流程一覽

掃描貼紙匹配

按需讀取小抄

動手調用腳本

LINE Webhook 推播

關鍵亮點：References 按需載入

Agent Skills
給 AI 插上
超能力外掛卡

2.4 萬 Token 的
「提示詞牢籠」

別怕，Skills 用的
就是 Markdown

大腦說明書
與機器人手臂

30 秒看懂：
會議總結助手

進階實戰：
台灣電子發票開立
自動化流程

Claude Code：
你的 AI 開發搭檔

Set the rules.
Unlock the skills.
Automate everything.