載入中

什麼是技能?

第 1 課9 分鐘
本課內容完成後,您將能夠
  • 定義 Claude Code 技能是什麼以及它們如何運作
  • 說明技能存放的位置(個人目錄 vs. 專案目錄)
  • 區分技能、CLAUDE.md 與斜線指令
  • 識別技能是合適自訂工具的情境

什麼是技能?

載入中

什麼是技能? · 3 分鐘

摘要逐字稿

本影片介紹技能——可重複使用的 markdown 檔案,教導 Claude Code 如何自動處理特定任務。您不需要每次要求 Claude 審查 PR 或撰寫提交訊息時都重複說明指示, 只需撰寫一次技能,Claude 就會在任務出現時套用它。本影片涵蓋技能是什麼、存放在哪裡, 以及與其他 Claude Code 自訂選項的比較。

重點摘要

  • 技能是指示的資料夾,Claude Code 可以發現並用來更準確地處理任務。每個技能都存放在一個 SKILL.md 檔案中,其 frontmatter 包含名稱與描述
  • Claude 使用描述來將技能與請求配對。 當您要求 Claude 做某件事時,它會將您的請求與可用的技能描述進行比對,並啟動相符的技能
  • 個人技能 存放在 ~/.claude/skills 中,並會跟隨您橫跨所有專案。專案技能 存放在儲存庫內的 .claude/skills 中,並會與任何複製(clone)該儲存庫的人共用
  • 技能會依需求載入 —— 與 CLAUDE.md(會載入每次對話)或斜線指令(需要明確呼叫)不同,技能會在 Claude 辨識出情境時自動啟動
  • 如果您發現自己反覆向 Claude 解釋同一件事,那就代表有一個技能等著被寫出來

每次您向 Claude 解釋團隊的程式碼標準時,您都是在重複自己。每次 PR 審查,您都要重新描述希望回饋的結構方式。每次提交訊息,您都要提醒 Claude 您偏好的格式。技能可以解決這個問題。

技能是一個 markdown 檔案,只需教導 Claude 一次如何做某件事。之後 Claude 會在相關時自動套用該知識。

什麼是技能

技能是指示與資源的資料夾,Claude Code 可以發現並用來更準確地處理任務。每個技能都存放在一個 SKILL.md 檔案中,其 frontmatter 包含名稱與描述。

pr-review 的 SKILL.md 在程式碼編輯器中開啟,顯示審查檢查項目,例如不得有硬編碼的機密資訊與 Pydantic schemas。

描述是 Claude 決定是否使用該技能的依據。當您要求 Claude 審查 PR 時,它會將您的請求與可用的技能描述進行比對,並找出相關的技能。Claude 會讀取您的請求,將其與所有可用的技能描述進行比較,並啟動相符的技能。

以下是技能的 frontmatter 範例:

yaml
---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

在 frontmatter 下方,您撰寫實際的指示——您的審查檢查清單、格式偏好,或是 Claude 在該任務中需要知道的任何事項。

技能存放的位置

您可以根據誰需要這些技能,將其存放在不同的位置:

  • 個人技能 存放在 ~/.claude/skills(您的家目錄)中。這些技能會跟隨您橫跨所有專案——您的提交訊息風格、您的文件格式、您偏好的程式碼說明方式。
  • 專案技能 存放在您儲存庫根目錄內的 .claude/skills 中。任何複製該儲存庫的人都會自動獲得這些技能。團隊標準就存放在這裡,例如您公司的品牌指南、網頁設計偏好的字型與顏色。

在 Windows 上,個人技能存放在 C:/Users/<your-user>/.claude/skills 中。

專案技能會與您的程式碼一起提交到版本控制系統中,因此整個團隊都能共用它們。

技能 vs. CLAUDE.md vs. 斜線指令

Claude Code 有多種自訂行為的方式。技能之所以獨特,是因為它們是自動且針對特定任務的。以下是它們的比較:

  • CLAUDE.md 檔案會載入每次對話中。如果您希望 Claude 始終使用 TypeScript 的嚴格模式,這應該寫在 CLAUDE.md 中。
  • 技能 會在與您的請求相符時依需求載入。Claude 最初只會載入名稱與描述,因此它們不會佔滿您整個上下文視窗。當您在除錯時,您的 PR 審查檢查清單不需要放在上下文中——它會在您實際要求審查時才載入。
  • 斜線指令 需要您明確輸入它們。技能則不需要。Claude 會在辨識出情境時套用它們。

當 Claude 將技能與您的請求配對時,您會在終端機中看到它載入:

在要求審查分支 sg-221 上的 pull request 後,一行 Skill pr-review 顯示「Successfully loaded skill」。

何時使用技能

技能最適合用於適用於特定任務的專業知識:

  • 您團隊遵循的程式碼審查標準
  • 您偏好的提交訊息格式
  • 您組織的品牌指南
  • 特定類型文件的文件範本
  • 特定框架的除錯檢查清單

經驗法則很簡單:如果您發現自己反覆向 Claude 解釋同一件事,那就代表有一個技能等著被寫出來。

課程反思

  • 回想您最近與 Claude Code 的互動。有哪些指示是您發現自己一直重複的?技能可能如何為您節省時間?
  • 思考您團隊的工作流程。哪些標準或流程最適合編碼為技能?

接下來是什麼

在下一課中,您將從頭開始建立您的第一個技能,並了解 Claude Code 在背後如何發現、配對與載入技能。