掌握 Claude Code 的 Skills 技能：Anthropic 內部完整攻略（2026 最新版） 

(本文整理自 Anthropic Claude Code 工程師 Thariq（@trq212）於 2026 年 3 月發布的公開推文串。Thariq 同時具備 YC W20 及 MIT Media Lab 背景，長期深耕 AI 工具開發。)

前言：Skills 為什麼是 Claude Code 最強的擴充功能？

Skills（技能）已成為 Claude Code 中最強大、使用最頻繁的擴充功能之一。它靈活、快速、易於共享 — 但這份靈活性也讓許多開發者不知道「該建什麼」以及「如何讓它真正發揮效用」。

在 Anthropic，我們在生產環境中已建立並使用了數百個 Skills。本文整理了來自真實內部使用場景的設計模式、分類方法與實戰經驗，是一份「讓 Claude Code 從通用 AI 助手進化為組織專屬超級代理人」的完整實戰手冊。

什麼是 Skills？打破「只是 Markdown 檔案」的迷思

許多人仍然認為 Skills「只是 Markdown 文字檔」。這只說對了一半。

一個 Skill 實際上是一個完整的資料夾，可以包含：

• 指令文件（Markdown 格式）
• 腳本（Bash、Python 等）
• 資源檔案（範本、範例檔案、圖片）
• 資料（JSON、日誌，甚至小型 SQLite 資料庫）
• 設定檔
• 動態鉤子（如 PreToolUse 等事件觸發器）

Claude 可以主動探索資料夾內的檔案、按需讀取、瀏覽子目錄，甚至在適當時機修改內容。Skills 同時支援豐富的設定選項：包含鉤子（hooks）的註冊、讓 Claude 能自動發現的描述設定等。

真正的威力，在於你如何創意地運用完整的資料夾結構。

Anthropic 內部使用的 9 大 Skills 類型

整理我們所有的 Skills 後，我們發現它們集中在以下幾個反覆出現的類別中。設計最乾淨、最高價值的 Skills，通常只專注在一個類別。而較雜亂的 Skills，往往是因為試圖同時解決太多問題。

類型一：函式庫與 API 參考

用途： 提供內部函式庫、CLI 工具、SDK 或複雜第三方工具的專屬知識。

重點包含：

• 常見陷阱與邊界情況
• 範例程式碼片段
• Claude 預設行為容易出錯的使用模式

實際案例：

• billing-lib：整理計費函式庫的邊界情況與危險操作
• internal-platform-cli：子命令說明與使用時機
• frontend-design：強制執行公司專屬的設計系統

類型二：產品驗證

用途： 自動化流程，用來測試與驗證程式碼輸出結果（通常搭配 Playwright、tmux 等工具）。

這類 Skills 槓桿效益極高，值得投入大量工程時間打磨。

常用技術：

• 錄製瀏覽器或 CLI 操作的影片
• 在每個步驟進行程式化的狀態斷言

實際案例：

• signup-flow-driver：完整的「註冊 → 驗證 → 引導流程」並附帶狀態斷言
• checkout-verifier：Stripe 測試卡號 + 發票狀態確認
• tmux-cli-driver：互動式 TTY 終端機測試

類型三：資料抓取與分析

用途： 為你的監控與資料分析技術棧，預先打包好查詢語句、儀表板與分析輔助工具。

實際案例：

• funnel-query：從「註冊 → 啟用 → 付費」的多表 JOIN 查詢
• cohort-compare：留存率與轉換率的差異分析，附顯著性標記
• grafana：資料來源 UID、叢集名稱、以及「症狀 → 對應儀表板」的映射表

類型四：業務流程與團隊自動化

用途： 一鍵自動化重複性的團隊工作流程。通常由簡單指令加上其他 Skills 的依賴組成，並善用日誌來保持記憶與一致性。

實際案例：

• standup-post：彙整 Tickets + GitHub + 上次 Slack 訊息，只發送「差異更新」
• create-ticket：強制執行 Issue 格式規範，並觸發建立後的後續工作流程
• weekly-recap：已合併 PR + 已關閉 Tickets → 格式化的每週回顧報告

類型五：程式碼鷹架與範本

用途： 使用組織的精確慣例生成樣板程式碼，包含驗證、日誌、部署設定等必要的標準配置。

實際案例：

• new-<framework>-workflow：特定框架的工作流程起始範本
• new-migration：資料庫遷移範本，附常見坑點提醒
• create-app：新應用程式的完整鷹架建立

類型六：程式碼品質與審查

用途： 強制執行程式碼風格、進行對抗性審查、引導測試流程。可以是確定性的腳本，也可以是代理式的 AI 任務。透過 Hooks 或 GitHub Actions 觸發。

實際案例：

• adversarial-review：以「全新視角」提出批評 → 修正 → 反覆迭代
• code-style：強制執行 Claude 預設行為容易忽略的程式碼風格
• testing-practices：測試策略指引

類型七：CI/CD 與部署管理

用途： 守護部署流程，監控 PR 狀態，處理漸進式推送與自動回滾。

實際案例：

• babysit-pr：重試不穩定的 CI、解決衝突、自動合併
• deploy-<service>：建置 → 冒煙測試 → 漸進式推送 → 自動回滾
• cherry-pick-prod：精挑提交到生產環境的工作流程

類型八：操作手冊（Runbooks）

用途： 「症狀 → 結構化調查 → 報告」的全流程處理。非常適合值班（on-call）場景。

實際案例：

• <service>-debugging：症狀 → 工具 → 查詢模式的完整指引
• oncall-runner：值班處理自動化
• log-correlator：依 Request ID 關聯日誌

類型九：基礎設施維運

用途： 例行性的維運與維護（對破壞性操作設有防護機制）。

實際案例：

• <resource>-orphans：找出孤立資源 → 發送 Slack 通知 → 確認 → 清理
• dependency-management：依賴套件更新工作流程
• cost-investigation：帳單費用異常的根因查詢

11 個實戰最佳實踐（Anthropic 內部使用心得）

1. 不要陳述顯而易見的事

Claude 已經懂一般的程式設計最佳實踐，也看得到你的程式碼庫。請專注在組織特有的知識，這些知識才能推動 Claude 脫離預設行為。

例：frontend-design 這個 Skill 是在反覆迭代後，才成功讓 Claude 戒掉「預設使用 Inter 字體 + 紫色漸層」的習慣。

2. 建立「常見坑點（Gotchas）」章節 — 這是含金量最高的部分

捕捉 Claude 真實踩過的錯誤，持續更新。 這通常是任何 Skill 中最有價值的部分。

3. 善用完整資料夾結構與漸進式揭露

讓 Claude 只在需要時才讀取特定檔案：

skill/
├── SKILL.md              # 主要指令
├── references/
│   └── api.md            # 詳細 API 簽章
├── assets/
│   └── template.md       # 可直接複製使用的範本
└── scripts/              # 輔助腳本

4. 避免過度約束指令

Skills 是可複用的，因此要提供資訊與靈活度，而不是把 Claude 強制導入單一僵化的執行路徑。

5. 支援設定與初始化

在 Skill 資料夾中放置 config.json。若設定檔不存在，指示 Claude 向使用者詢問（可使用 AskUserQuestion 工具進行結構化輸入）。

6. Description 欄位是寫給模型看的

這是 Claude 在 Session 開始時掃描、用來判斷 Skill 是否相關的依據。 請以「觸發條件描述」的方式撰寫，而非人類閱讀的摘要。

7. 透過檔案實現記憶功能

在 Skill 資料夾（或更穩定的 $CLAUDE_PLUGIN_DATA 目錄）中儲存日誌、JSON 或 SQLite 資料。

例：standups.log 讓下次執行時，Claude 能看到上次的差異，只更新變動的部分。

8. 提供輔助腳本與函式庫給 Claude 使用

讓 Claude 能夠組合使用，而不是每次都從頭重寫樣板程式碼。

例：提供資料抓取的輔助函式，讓 Claude 能動態串接分析函數。

9. 按需啟用鉤子（On-Demand Hooks）

只在需要時才啟用某些強制性行為：

• /careful：封鎖 rm -rf、DROP TABLE、強制推送等危險操作
• /freeze：鎖定只能編輯特定目錄

10. 分發與規模化策略

⚠️ 警告：缺乏策展機制，最終會導致技能重複與品質低落。

11. 追蹤使用數據

使用 PreToolUse 鉤子記錄呼叫次數，找出哪些 Skills 最受歡迎、哪些已被廢棄。

如何開始？給新手的建議

Anthropic 近期推出了 Skill Creator 工具，讓建立 Skills 的過程更加簡單 — 建議從這裡開始。

大多數我們內部的 Skills 一開始都非常精簡（幾行指令 + 一個常見坑點），隨著使用者持續新增真實邊界情況才逐漸成長茁壯。

Skills 讓 Claude Code 從一個通用 AI 助手，蛻變為高度符合組織需求的超級代理人。 現在還是早期發展階段，建議積極實驗、持續迭代，並將成果分享給社群。

常見問題（FAQ）

Q：Skills 和一般的 System Prompt 有什麼差別？ A：System Prompt 是靜態的文字，而 Skills 是包含腳本、資料、模板的完整資料夾結構，Claude 能主動與這些檔案互動。

Q：一個 Skill 可以呼叫另一個 Skill 嗎？ A：可以。「業務流程與團隊自動化」類型的 Skills 就常常以其他 Skills 作為依賴。

Q：Skills 適合個人開發者使用嗎？ A：當然。即使是個人使用，建立「常見坑點」與「API 參考」類型的 Skills 也能大幅提升與 Claude Code 的合作效率。