如果你已經在用 Claude Code，大概聽過 Skills 這個功能，但不確定該怎麼用才有效？這次 Anthropic 官方直接公開他們內部大規模使用 Skills 的實戰心得，包含 9 種分類架構、撰寫技巧，以及如何把 Skills 分發給整個團隊。這篇文章整理自 Anthropic 官方部落格，帶你快速看懂重點，馬上就能上手。
Skills 是什麼？為什麼不只是 Markdown 檔案？
很多人第一次接觸 Skills，會以為它只是一個寫好指令的 Markdown 檔案，實際上這是最常見的誤解。根據官網的介紹，Skills 其實是一整個資料夾，裡面可以放腳本、素材、資料，甚至 SQLite 資料庫，讓 Claude 在工作時可以自行探索並取用。對開發者來說，這個差異非常關鍵：你不是在給 Claude 一張紙條，而是交給它一整個工具箱。Anthropic 內部目前有數百個 Skills 在運作中，這套架構讓他們的開發流程大幅提升效率。
🔔 不錯過任何精彩內容
立即訂閱我們的 LINE 或將本站設為 Google 偏好來源，掌握最新資訊！
Skills 的 9 種分類，你目前用到幾種？
Anthropic 整理出內部常見的 9 種 Skills 類型，每種各有不同的使用場景。根據官網的介紹，大多數團隊實際上只用到其中 2 到 3 種，主要原因不是其他分類沒用，而是根本不知道它們的存在。以下是完整的 9 種分類：
| 分類 |
說明 |
應用範例 |
| 1. 函式庫與 API 參考 |
說明如何正確使用特定 SDK 或 CLI |
內部帳務函式庫邊界情況、前端設計系統 |
| 2. 產品驗證 |
自動測試並驗證程式行為是否正確 |
自動跑完整個註冊流程並驗證每個步驟 |
| 3. 資料查詢與分析 |
連接資料庫與監控系統來取得數據 |
用戶轉換漏斗查詢、Grafana 儀表板對照 |
| 4. 業務流程自動化 |
將重複性工作流程自動化 |
自動產生每日站會摘要、建立工作票券 |
| 5. 程式碼模板與鷹架 |
快速生成符合團隊規範的樣板程式 |
新服務建立、資料庫 migration 模板 |
| 6. 程式碼品質審查 |
執行品質標準並協助 code review |
對抗性審查、測試撰寫規範 |
| 7. CI/CD 與部署 |
處理合併、部署與上線流程 |
自動監控 PR 並解決衝突、漸進式流量切換 |
| 8. 操作手冊（Runbook） |
收到問題訊號後自動調查並產出報告 |
服務異常除錯、On-call 警報處理 |
| 9. 基礎架構維運 |
例行維護與基礎設施操作 |
孤兒資源清理、帳單成本調查 |
如何撰寫一個真正好用的 Skill？
知道有哪些分類之後，下一步就是「怎麼寫」。根據官網的介紹，最有價值的內容不是把 Claude 已經知道的事情再寫一遍，而是把那些容易踩到的坑整理出來。Anthropic 把這個部分稱為「Gotchas 區塊」，也就是常見錯誤的彙整，這些內容通常不在正式文件裡，但卻是實際開發時最容易出問題的地方。以下是幾個官方分享的 Gotchas 原文範例及中文對照：
原文：
「The subscriptions table is append-only. The row you want is the one with the highest version, not the most recent created_at.」
中文：訂閱資料表是只能新增的結構。你要找的資料列應該是 version 最高的那筆，而不是 created_at 最新的那筆。
原文：
「This field is called @request_id in the API gateway and trace_id in the billing service. They're the same value.」
中文：這個欄位在 API gateway 叫做 @request_id，在帳務服務裡叫做 trace_id，但其實是同一個值。
原文：
「Staging returns 200 even when the Stripe webhook didn't actually process. Check payment_events for the real state.」
中文：測試環境就算 Stripe webhook 沒有真正執行，一樣會回傳 200。要確認真實狀態，請查 payment_events。
這些例子說明了一件事：好的 Skill 不是說明書，而是資深工程師在你耳邊低語「這個地方會咬人，小心」。
撰寫技巧：給 Claude 資訊，不要給死規則
Anthropic 特別提醒，Skills 的 description 欄位不是給人看的摘要，而是 Claude 用來判斷「這個 Skill 什麼時候該啟動」的條件說明。對開發者來說，這個欄位要寫的是觸發情境和關鍵詞，而不是功能介紹。此外，官方也建議不要把規則寫得太死，因為 Skills 會重複使用，過於僵硬的指令反而會讓 Claude 在不同情境下做出不合適的判斷。最好的方式是給 Claude 足夠的資訊，讓它保留彈性去因應每次不同的狀況。
如何把 Skills 分發給整個團隊？
Skills 另一個很實用的功能是團隊共享。根據官網的介紹，有兩種主要方式：第一種是把 Skills 直接 commit 進 repo 的 ./.claude/skills 資料夾，適合小型團隊或單一專案；第二種是建立內部的 plugin marketplace，讓大家自由選擇安裝哪些 Skills，更適合規模較大的組織。Anthropic 內部採用的是後者，運作方式很像開源社群，有人做了好用的 Skill，先放到 GitHub 的沙箱資料夾，在 Slack 上分享給同事試用，反應不錯之後再開 PR 合進正式 marketplace。這個過程沒有中央委員會審核，完全靠社群自然篩選。
操作步驟：如何建立你的第一個 Skill？
想從零開始建立一個 Skill，以下是基本流程：
- 在專案根目錄建立 .claude/skills/你的-skill-名稱/ 資料夾
- 在資料夾內建立 SKILL.md，填入 description（觸發條件）與使用說明
- 視需要加入 references/（參考文件）、assets/（範本）、scripts/（執行腳本）等子目錄
- 把最常踩到的錯誤整理到 Gotchas 區塊
- 在 Claude Code 聊天視窗輸入 /你的-skill-名稱，即可載入整個資料夾
- 實際使用後持續更新 Gotchas，讓 Skill 隨時間越來越準確
Anthropic 也推出了 Skill Creator 工具，可以在 Claude Code 內部直接輔助你建立 Skills，讓整個流程更順暢。
Skills 不是寫好就結束的靜態文件，而是隨著團隊遇到的真實問題持續成長的活文件。
從一個 Skill、幾行說明、一條 Gotcha 開始，往往就是讓 AI 開發效率脫胎換骨的第一步。