跳至主要內容

如何建立自訂技能

技能適用於 Free、Pro、Max、Team 和 Enterprise 方案的使用者。此功能需要啟用程式碼執行。技能也以測試版形式提供給 Claude Code 使用者和所有使用程式碼執行工具的 API 使用者。

自訂技能可讓您使用特定於您的組織或個人工作風格的專業知識和工作流程來增強 Claude。本文說明如何建立、結構化和測試您自己的技能。

技能可以簡單到只有幾行指示，也可以複雜到包含可執行程式碼的多檔案套件。最佳技能：

  • 解決特定的、可重複的任務

  • 具有 Claude 可以遵循的清晰指示

  • 在有幫助時包含範例

  • 定義應何時使用它們

  • 專注於一個工作流程，而不是試圖做所有事情

錄製技能

錄製技能適用於 Pro、Max 和 Team 方案，在 Claude for Mac 的 Cowork 中提供。在聊天、Windows 或 Free 和 Enterprise 方案中不可用。

您可以錄製自己執行任務的過程，讓 Claude 根據觀察到的內容建立技能，而不是手動編寫技能。您向 Claude 發送您的螢幕、點擊、輸入和語音的影片，Claude 會提出一個技能供您在儲存前審查。

錄製前

  1. 更新到最新版本的 Claude for Mac。

  2. 授予 macOS 權限 Claude 在您第一次錄製時要求的：用於滑鼠和鍵盤追蹤的無障礙，以及用於螢幕可見性的螢幕錄製。macOS 可能會要求您重新啟動 Claude。

  3. 關閉任何您不想被捕捉的檔案、應用程式或對話。

警告：錄製時不要輸入密碼或機密資訊，也不要顯示敏感資訊或私人對話。您螢幕上的所有內容都會在整個工作階段期間被捕捉，以及您說的任何內容。

錄製您的工作流程

  1. 在 Claude for Mac 中開啟 Cowork。

  2. 以下列兩種方式之一開始錄製：

    1. 按一下編寫器中的「+」按鈕，然後選擇「錄製技能」。

    2. 前往自訂 > 技能，按一下「新增」，然後選擇「錄製您的螢幕」。

  3. 按一下「開始錄製」。若要在工作時進行旁白，請保持麥克風開啟。使用麥克風控制將其靜音或選擇不同的輸入。

  4. 按照您通常的方式執行任務。捕捉列顯示錄製正在進行中，並計算它已捕捉的步驟。

  5. 完成後按一下「完成」，或按一下「捨棄」以丟棄錄製而不建立任何內容。

錄製可以執行約 10 分鐘。當您剩下約一分鐘時，倒數計時會出現在捕捉列中。當它達到零時，錄製停止，您捕捉到的所有內容都會發送給 Claude，就像您按一下「完成」一樣。

提示：在錄製時講述您正在做的事情。旁白為 Claude 提供了它無法從您的螢幕單獨獲得的背景資訊，例如您為什麼跳過一個步驟或您如何在兩個選項之間進行選擇。

按一下「完成」後會發生什麼

Claude 啟動 Cowork 任務並審查錄製，然後提出技能。根據它發現的內容，您會看到以下兩種情況之一：

  • 新技能，在提案卡上標記為新增。按一下「儲存」以保留它，或按一下「關閉」以捨棄提案。

  • 對現有技能的更新。如果錄製與您已有的技能重疊，Claude 會改為提出對該技能的變更。卡片顯示提案所基於的技能。按一下「更新」以套用變更，或按一下「關閉」以捨棄它們。

在提案卡上展開內容以在您決定前閱讀技能。

您從錄製中儲存的技能會出現在自訂 > 技能中，並像任何其他技能一樣工作。您可以在相同條款下編輯、共享和刪除它們。

從錄製中保留的內容

您的錄製中的影片和音訊不會被保留。在您將錄製發送給 Claude 後，Claude 會審查錄製以建立技能。之後儲存的是來自工作階段的一組螢幕截圖，您可以通過展開任務中的錄製演示步驟來查看。

由於這些螢幕截圖位於 Cowork 任務中，刪除任務會移除它們。請參閱開始使用 Claude Cowork以了解任務刪除和保留的工作方式。

建立 skill.md 檔案

每個技能都包含一個目錄，其中至少包含一個 skill.md 檔案，這是技能的核心。此檔案必須以 YAML 前置資訊開始，以保存名稱和描述欄位，這些是必需的中繼資料。它還可以包含其他中繼資料、Claude 的指示或參考檔案、可執行指令碼或工具。

必需的中繼資料欄位

name：您的技能的人類友善名稱（最多 64 個字元）

  • 範例：品牌指南

description：技能的功能和使用時機的清晰描述。

  • 這很關鍵—Claude 使用此來確定何時調用您的技能（最多 200 個字元）。

  • 範例：將 Acme Corp 品牌指南應用於簡報和文件，包括官方顏色、字體和徽標使用。

選用的中繼資料欄位

dependencies：您的技能所需的軟體套件。

  • 範例：python>=3.8, pandas>=1.5.0

skill.md 檔案中的中繼資料作為漸進式揭露系統的第一級，提供足夠的資訊讓 Claude 知道何時應使用技能，而無需載入所有內容。

Markdown 正文

Markdown 正文是元資料之後的第二層詳細資訊，因此 Claude 在閱讀元資料後如需要會存取此內容。根據您的任務，Claude 可以存取 skill.md 檔案並使用該技能。

範例 skill.md

品牌指南技能

## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents

## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.

## Brand Colors

Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography

Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt

## Logo Usage

Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.

## When to Apply

Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients

## Resources

See the resources folder for logo files and font downloads.

新增資源

如果您有太多資訊無法新增至單一 skill.md 檔案（例如，僅適用於特定情境的章節），您可以在技能目錄中新增檔案來新增更多內容。例如，將包含補充和參考資訊的 REFERENCE.md 檔案新增至您的技能目錄。在 skill.md 中參考它將幫助 Claude 決定執行技能時是否需要存取該資源。

新增指令碼

對於更進階的技能，將可執行程式碼檔案附加至 skill.md，允許 Claude 執行程式碼。例如，我們的文件技能使用以下程式設計語言和套件：

  • Python (pandas, numpy, matplotlib)

  • JavaScript/Node.js

  • 協助檔案編輯的套件

  • 視覺化工具

注意：Claude 和 Claude Code 在載入技能時可以從標準儲存庫（Python PyPI、JavaScript npm）安裝套件。使用 API 技能時無法在執行時安裝其他套件—所有相依性必須預先安裝在容器中。

封裝您的技能

技能資料夾完成後：

  1. 確保資料夾名稱與您的技能名稱相符。

  2. 建立資料夾的 ZIP 檔案。

  3. ZIP 應包含技能資料夾作為其根目錄（不是子資料夾）。

正確的結構：

my-skill.zip

└── my-skill/

├── skill.md

└── resources/

不正確的結構：

my-skill.zip

└── (ZIP 根目錄中的檔案)

測試您的技能

上傳前

1. 檢查您的 skill.md 是否清晰。

2. 檢查描述是否準確反映 Claude 應何時使用該技能。

3. 驗證所有參考的檔案是否存在於正確的位置。

4. 使用範例提示進行測試，以確保 Claude 適當地呼叫它。

上傳至 Claude 後

1. 在 自訂 > 技能中啟用該技能。

2. 嘗試應該觸發它的多個不同提示。

3. 檢查 Claude 的思考過程以確認它正在載入該技能。

4. 如果 Claude 在預期時未使用它，請反覆修改描述。

當您在聊天中與 Claude 反覆修改技能時，您可以直接編輯在對話旁邊開啟的技能檔案。反白您想要變更的文字，按一下「使用 Claude 編輯」，然後輸入您的要求。對於有多個檔案的技能，在檔案中留下編輯要求並一起傳送，Claude 會在一次通過中套用它們。深入瞭解編輯成品。

Team 和 Enterprise 方案的注意事項：若要讓組織中的所有使用者都能使用技能，請參閱為您的組織佈建和管理技能。

最佳實踐

保持專注：為不同的工作流程建立個別技能。多個專注的技能比一個大型技能組合得更好。

撰寫清晰的描述：Claude 使用描述來決定何時呼叫您的技能。請具體說明何時適用。

從簡單開始：在新增複雜指令碼之前，先從 Markdown 中的基本指示開始。您稍後可以隨時擴展該技能。

使用範例：在您的 skill.md 檔案中包含範例輸入和輸出，以幫助 Claude 瞭解成功的樣子。

逐步測試：在每次重大變更後進行測試，而不是一次性建立複雜的技能。

技能可以相互建立：雖然技能無法明確參考其他技能，但 Claude 可以自動一起使用多個技能。這種可組合性是技能功能最強大的部分之一。

檢查開放代理技能規範：遵循agentskills.io的指南，以便您建立的技能可以在採用該標準的平台上運作。

如需更深入的技能建立指南，請參閱我們 Claude 文件中的技能編寫最佳實踐。

安全考量

  • 在將指令碼新增至您的 skill.md 檔案時要謹慎。

  • 不要硬編碼敏感資訊（API 金鑰、密碼）。

  • 在啟用任何下載的技能之前，請先檢查它們。

  • 使用適當的 MCP 連線來存取外部服務。

參考範例技能

造訪我們在 GitHub 上的儲存庫，查看可作為範本使用的範例技能：https://github.com/anthropics/skills/tree/main/skills。

相關文章
是否回答了您的問題？