拾光 AI 工作室

Claude Code 非工程師實戰・第 4 篇・約 13 分鐘

把每週都要做的事變成一張技能卡：Agent Skills 入門（會議紀錄與發票歸檔）

本文目錄

    寫作時版本：Claude Code 2.1.x／2026 年 11 月（內容依官方文件 2026-11 查閱整理）。 Claude Code 更新很快，畫面文字、指令名稱、預設值都可能改變。看到的畫面和本文不一樣時，請以官方文件為準。

    這篇文章要幫你做到什麼

    上一篇我們把「每次都該知道的規則」寫進了 CLAUDE.md。但你一定還有另一種事：每週（或每次開完會）都要照同一套步驟做一遍的工作。

    例如：

    • 開完會，把逐字稿整理成「決議、待辦、負責人、期限」的會議紀錄
    • 月底，把這個月的發票照片／PDF 依月份、類別歸檔，再列一張清單

    這類「好幾個步驟的固定流程」，如果每次都重新打一大段指示給它，很累，也容易漏講。解法是做成一張技能卡（官方名稱 Skill，檔名 SKILL.md）：寫一次，之後輸入一個斜線指令，或直接說一句話，它就照著你寫的流程做。

    官方文件的建議時機也很直白：當你「不斷把相同的指示、檢查清單或多步驟程序貼到聊天中」，或 CLAUDE.md 的某一段已經長成「流程」而不是「事實」時，就該做成技能卡。

    讀完這篇你會：

    • 分清楚 CLAUDE.md 和技能卡各放什麼
    • 知道技能卡要放在哪個資料夾、長什麼樣子
    • 手把手做出第一張「會議紀錄」技能卡，並用兩種方式叫用
    • 做出第二張「發票歸檔」技能卡，學會用 disable-model-invocation 讓它只有你喊才會動
    • 技能卡沒反應時怎麼查

    需要準備：

    • 已照第 1 篇裝好並登入 Claude Code
    • 沿用 Claude練習 資料夾；建議順手看過第 3 篇
    • 約 40 分鐘

    先搞懂：技能卡 vs. CLAUDE.md

    CLAUDE.md 技能卡（SKILL.md）
    放什麼 每次都該知道的事實與規則（我是誰、檔名格式、哪裡不能碰） 一個多步驟的流程（先做 A、再做 B、最後輸出 C）
    什麼時候讀進去 每次啟動都讀 用到才讀；平常只佔一行說明的位置
    怎麼叫用 不用叫，自動讀 輸入 /技能名稱，或描述符合時它自己判斷要不要用

    官方文件的說法是：skill 的主體只在使用時才載入，所以再長的流程，平常幾乎不佔空間。所以：規則放 CLAUDE.md，流程放技能卡。

    技能卡放在哪裡

    技能卡是「一個資料夾，裡面一個叫 SKILL.md 的檔案」。官方文件列了很多種位置，非工程師記這兩個就夠：

    想要的效果 位置
    這台電腦上所有資料夾都能用 ~/.claude/skills/技能名稱/SKILL.md（Windows 的 ~ 就是 C:\Users\你的名字）
    只有某個專案／資料夾能用 該資料夾底下的 .claude/skills/技能名稱/SKILL.md

    資料夾名稱就是斜線指令的名字。 例如 .claude/skills/meeting-minutes/SKILL.md 會變成 /meeting-minutes。

    提醒三件事（都來自官方文件）：

    1. 同名時，優先順序是：企業 > 個人 > 專案。不要在兩處放同名的卡。
    2. 官方文件說，Claude Code 會監看這些技能資料夾，你在工作中新增或修改技能卡，不用重新啟動就會生效。（例外：你是在「啟動位置的下一層子資料夾」才有的 .claude/skills/，要等它讀到那個子資料夾的檔案才會載入。）
    3. 本文為了好懂，英文資料夾名稱用 meeting-minutes、invoice-archive；名稱建議用英文小寫加連字號，避免特殊符號（官方有名稱字元限制，名稱被拒絕時啟動時會有通知）。

    技能卡長什麼樣子

    一張技能卡由兩段組成：

    ---
description: 這張卡做什麼、什麼時候該用
---

（這裡用白話寫步驟，它會照著做）

    上面兩條 --- 之間叫「說明區」（frontmatter）。重點是 description：Claude 靠它判斷「現在這件事該不該用這張卡」。官方建議把最關鍵的用途放在最前面，並寫進你平常會自然說出口的字眼（例如「會議紀錄」「逐字稿」）。

    兩條 --- 底下是正文，就是你的步驟。官方也提醒：說明區的 --- 必須是檔案的第一行，否則整份都會被當成正文。

    步驟 1：建立資料夾（會議紀錄技能卡）

    先在練習資料夾準備一份假的逐字稿。用記事本新增 C:\Users\你的名字\Claude練習\逐字稿\20261105_採購檢討.txt，貼進：

    小安：今天要討論新供應商報價。
大明：A 廠比 B 廠便宜 8%，但交期要 21 天。
小安：我們庫存只剩兩週，我覺得 B 廠比較穩。
大明：那就決定先跟 B 廠下一小批試單，下週三前我去談。
小美：我來整理兩家的比較表，週五前給大家。
小安：好，下次會議 11 月 19 日再看試單結果。

    （人名、公司均為虛構。）

    接著用 PowerShell 建立技能卡資料夾（只給這個練習資料夾用）：

    cd "$env:USERPROFILE\Claude練習"
mkdir .claude\skills\meeting-minutes

    （若出現「已存在」的提示就代表之前建過，直接下一步）

    想要「所有資料夾都能用」，就改建在 $env:USERPROFILE\.claude\skills\meeting-minutes。

    步驟 2：寫 SKILL.md

    用記事本新增檔案，另存到 meeting-minutes 資料夾裡，檔名 SKILL.md（存檔類型選「所有檔案」、編碼選 UTF-8，不然會變 SKILL.md.txt 或亂碼）。貼入：

    ---
description: 把會議逐字稿整理成會議紀錄（決議、待辦、負責人、期限）。當使用者提到會議紀錄、逐字稿、整理會議時使用。
---

# 會議紀錄整理流程

使用者會指定一份逐字稿檔案（txt 或 docx）。請依序做：

1. 讀取該檔案。如果使用者沒說是哪一份，列出「逐字稿」資料夾的檔案，問使用者選哪一份。
2. 整理成下面的格式，用繁體中文（台灣用語）：
   - 會議名稱、日期（逐字稿檔名開頭若有 YYYYMMDD 就用它；找不到就標「待確認」）
   - 出席者
   - 決議事項（條列，每條一句話）
   - 待辦事項（表格：事項｜負責人｜期限）
   - 下次會議時間（沒提到就寫「未提及」）
3. **不要猜**：逐字稿沒有明講的負責人或期限，一律填「待確認」，不要自己補。
4. 把結果存成新檔案，放在「會議紀錄」資料夾（沒有就建立），檔名格式：
   YYYYMMDD_會議_主題_v1.md。若同名檔案已存在，版本號加 1，**不要覆蓋舊檔**。
5. 最後用 3 行說明：存到哪裡、有幾項決議、有幾項待確認。

    幾個小設計，是這張卡好用的原因：

    • 「不要猜」：最容易出事的就是它幫你補上不存在的期限。明確叫它填「待確認」。
    • 「不要覆蓋舊檔」：延續第 2 篇的安全習慣。
    • 最後的 3 行回報：讓你不用打開檔案就知道結果是否正常。

    步驟 3：叫用它（兩種方式）

    在 Claude練習 資料夾啟動：

    cd "$env:USERPROFILE\Claude練習"
claude

    方式一：直接輸入斜線指令（最穩）

    /meeting-minutes 逐字稿\20261105_採購檢討.txt

    斜線後面的文字，會當成「你給這張卡的額外資訊」一起交給它（官方文件：叫用時傳入的引數會附加進去）。

    方式二：用說的

    幫我把採購檢討的逐字稿整理成會議紀錄

    因為 description 寫了「會議紀錄、逐字稿」，Claude 會判斷要不要自動載入這張卡。自動判斷有時會失手，沒用到也不意外，這時直接用方式一就好。

    預期結果：會議紀錄\20261105_會議_採購檢討_v1.md 出現，內容應該像這樣（你的輸出文字會有差異，重點是結構與「待確認」）：

    決議事項
- 先向 B 廠下一小批試單
待辦事項
| 事項 | 負責人 | 期限 |
| 與 B 廠洽談試單 | 大明 | 下週三前（具體日期待確認） |
| 整理兩家比較表 | 小美 | 週五前（具體日期待確認） |
下次會議：11 月 19 日

    這裡有個值得注意的細節：逐字稿只說「下週三」「週五」，沒有給日期。好的結果會把它們標成待確認，而不是自己換算成日期。 如果它直接寫了具體日期，就回到 SKILL.md 把「不要猜」那條講得更具體，再試一次。

    步驟 4：確認它在清單裡

    技能卡沒反應時，第一件事是確認它有沒有被載入。在 Claude Code 裡輸入：

    /skills

    官方文件有這個指令，會列出目前可用的技能。你的 meeting-minutes 應該在裡面。也可以直接問：

    你現在有哪些技能可以用？

    （畫面依版本不同，作者未逐版比對。）

    步驟 5：第二張卡——發票歸檔（只准我喊才動）

    會議紀錄是「整理完存新檔」，風險低。發票歸檔要搬移檔案，這種事不該讓它自己判斷要不要做。

    官方文件為此提供一個欄位：disable-model-invocation: true。意思是：Claude 不會自動載入這張卡，只有你輸入 /名稱 時才會動。官方文件的說明是，這適用於「有副作用、你想控制時機」的工作流程，例如部署、提交。

    建立資料夾並寫入：

    mkdir "$env:USERPROFILE\Claude練習\.claude\skills\invoice-archive"

    SKILL.md 內容：

    ---
description: 把「待歸檔發票」資料夾裡的發票檔案，依月份歸檔並產生清單。
disable-model-invocation: true
---

# 發票歸檔流程

使用者會告訴你要處理哪個月份（例如 2026-10）。請依序做：

1. 列出「待歸檔發票」資料夾的所有檔案，**先不要動任何檔案**。
2. 依檔名或內容判斷日期與類別（交通、餐飲、辦公用品、其他）。判斷不出來的歸「待確認」，不要猜。
3. 產生一張對照表給使用者看：舊檔名｜日期｜類別｜新位置。
4. **等使用者回答「好」才動手。** 使用者沒說好，就不要搬任何檔案。
5. 同意後：
   - 先把「舊檔名清單」存成 CSV（備份，之後可救回）。
   - **複製**（不是搬移）檔案到「發票歸檔\YYYY-MM\類別\」，檔名格式：YYYYMMDD_類別_金額.副檔名。
   - 不刪除、不覆蓋任何檔案。
6. 最後產生 `發票歸檔\YYYY-MM\清單.csv`（日期、類別、金額、檔名），並說明有幾筆、幾筆待確認。

    這張卡把前兩篇學的三個安全習慣都寫進去了：先給對照表、同意才動手、複製而不是搬移並留備份。

    叫用方式：

    /invoice-archive 2026-10

    先拿 5 個假發票檔案（隨便幾個命名像發票的 txt／圖片）測試，不要一開始就拿真的發票。

    提醒：disable-model-invocation 只管「它會不會自動載入這張卡」。真正的煞車還是第 1 篇的權限模式（動手前它會問你）以及卡片裡「等我說好」的規則。兩層一起用。

    技能卡沒反應時，怎麼查

    依官方疑難排解順序，翻成白話：

    1. 先 /skills，看卡有沒有列出來。 沒有 → 資料夾位置錯了（要是 .claude/skills/名稱/SKILL.md，注意是 .claude 前面有個點）或檔名不是 SKILL.md（常見：變成 SKILL.md.txt）。
    2. 直接輸入 /名稱。 能叫用、但說話時不會自動觸發，通常是 description 沒包含你平常會講的字眼。改寫 description 再試。
    3. 說明區的 --- 要在第一行，而且中間的 YAML 格式要正確。格式壞掉時，官方說技能還是會載入正文，所以 /名稱 仍然能用，但 Claude 沒辦法用 description 判斷何時該用。
    4. /名稱 也沒反應？ 可能是名稱被拒絕（有特殊字元）。可以用 claude --debug 啟動查看。
    5. 改了卡，結果沒變？ 官方說明，技能內容在目前工作階段中載入後，就是載入當下的版本；如果不確定，離開再重新啟動（輸入 /exit，再輸入 claude）最保險。
    6. 要自動化排程的話要注意： 官方說明，只存在你電腦 ~/.claude/skills/ 的技能卡，雲端執行的排程任務讀不到。這點下一篇（排程）會再談。

    四個「不要」

    1. 不要把密碼、帳號、客戶資料寫進 SKILL.md。 技能卡可能被複製、分享給同事。
    2. 不要一張卡塞太多事。 一張卡一件事，名稱一看就懂。
    3. 不要讓有副作用的卡（搬檔、刪檔、寄信）能自動觸發。 加上 disable-model-invocation: true，並寫「先給我看、同意才動手」。
    4. 不要寫了就信。 每張新卡都用假資料跑一次，看結果符不符合你的預期，再拿真的資料。

    想直接拿現成的？

    自己寫第一張最花時間，因為你要摸索「說明要寫到多具體、哪些要明講不准做」。我們整理了一組可以直接放進 .claude/skills/ 的技能卡，包含會議紀錄、檔案整理、報表等常見辦公情境，每張都寫好結構與「不要猜」「同意才動手」的安全規則，你只要改成自己的資料夾名稱。

    👉 看數位商品

    （不買也沒關係：上面這兩張就足以讓你開始用，照著改成你自己的流程即可。）

    下一篇預告

    第 5 篇：《不用守著電腦：讓 Claude Code 每天自己跑一次》 技能卡讓流程「一句話就能跑」；下一篇教你再往前一步，讓它按時間自己跑，以及為什麼「權限白名單、記錄檔、哪些事絕對不要交給排程」比怎麼排更重要。

    參考來源（均為官方文件，2026-11 查閱）

    操作說明：技能卡位置、frontmatter 欄位、/skills、disable-model-invocation、即時變更偵測與疑難排解均依上述官方文件整理，本篇範例技能卡未在作者電腦上逐項實測輸出，文中「預期結果」為示意，實際輸出會有差異（待驗證）；mkdir 指令為 Windows PowerShell 寫法，Mac 請改用 Terminal 的 mkdir -p .claude/skills/meeting-minutes，路徑 ~/.claude/skills/ 相同。範例中的人名、公司與逐字稿均為虛構。

    同系列延伸閱讀

    ← 回文章列表