如何創建和使用克勞德技能? 3種方法詳細指南!

CometAPI
AnnaOct 21, 2025
如何創建和使用克勞德技能? 3種方法詳細指南!

克勞德的新 技能 Anthropic 最近推出的一項功能,讓團隊和開發者能夠向 Claude 傳授可重複、可共享的功能:想像一下緊湊且版本化的「工具包」(包含說明、腳本和資源的文件夾),這些工具包可以讓 Claude 可靠地執行特定領域的任務,例如生成與品牌一致的幻燈片、生成包含公式的 Excel 工作簿,公式安全地執行小簿。本文將解釋 什麼是技能以及為什麼技能很重要然後,給了一個實用的、循序漸進的指南,指導你如何以三種方式使用 Skills:在 Claude 的 Web 應用程式中(無程式碼路徑)、在 克勞德·科德 (開發者 IDE 風格),並透過 克勞德API (程式化整合)。最後我們將介紹安全性、與其他代理模式的比較、最佳實踐以及故障排除技巧。

克勞德技能到底是什麼,它能帶來什麼好處?

簡短定義: A 技能 是一個獨立的資料夾/包,其中包含指令、腳本、資源以及可選的可執行助手程序,當任務與技能的觸發器相符時,Claude 可以動態載入這些助手程序。實際上,技能就像一個可重複使用的、版本化的“功能”,可以教導 Claude 如何執行特定類型的任務(例如,根據公司標準格式化電子表格、將品牌指南應用於幻燈片、按照規範的模板生成報告)。

技能的核心部分(您通常會發現的內容)

  • manifest / metadata — 名稱、版本、觸發器、權限。
  • instructions.md — 進階步驟、護欄、範例。
  • handlers or scripts — 用於產生檔案、呼叫內部工具或轉換資料的實際程式碼。
  • resources/ — 範本、樣式指南、樣本資料。
  • tests/ — 用於驗證技能的自動化測試。

技能能為克勞德增添什麼能力?

  • 自訂說明和內容包: 技能可以包括 Claude 用作權威背景的書面說明、模板和資源文件(樣式指南、CSV 等)。
  • 可執行元件(程式碼執行工具): 技能可能包括在 Anthropic 程式碼執行容器內執行的腳本或程式碼,用於執行確定性操作(檔案解析、數值計算、資料轉換)。這可以減輕那些如果純粹以令牌產生的方式執行,成本高昂或不可靠的工作負擔。
  • 自動啟動和選擇性使用: 當使用者的請求與技能範圍相符時,Claude 可以自動選擇並呼叫相關技能,並且可以解釋為什麼選擇該技能。
  • 版本控制和程式控制: 技能是一流的 API 物件:您可以上傳、管理版本和引用 skill_id來自 Claude API。這支援 CI 風格的工作流程和更新治理。
  • 跨端點分佈: 技能適用於 Claude 的產品系列——Web 應用程式、Claude Code 和 Anthropic 的 API/Agent SDK——既能提高最終用戶的生產力,又能實現開發人員的自動化。

如何在 Claude 網路應用程式(Claude.ai)中使用 Claude Skills?

我需要先決條件: (1) 您必須使用支援技能的 Claude 付費方案(發佈時提供專業版、高級版、團隊版或企業版)。可用性和管理控制因套餐和機構設定而異。 (2) 存取「設定」和工作區中的「技能」功能切換開關(設定 → 功能 → 技能)。管理員可能需要啟用技能建立功能或將安裝限制在已核准的技能範圍內。

在 Claude Apps Web 中建立和使用技能的逐步指南:

步驟 1:探索內建範例並開啟“技能”

開啟 Claude.ai → 設定 → 功能 → 技能。切換到預覽/範例技能,查看其結構和激活行為。這是了解技能外觀和行為的最快方法。

第 2 步:使用技能創建器 UI(第一個技能)

Anthropic 在應用程式內部部署了一個引導式技能創造器:選擇 創建技能 啟動精靈,詢問您希望技能執行的操作,提供預設資料夾佈局(自述文件、說明文件、範例範本以及可選的腳本),並協助編寫基本指令和觸發器。使用內建測試工具,透過範例提示驗證行為。

步驟 3:定義技能的目的、範例和資源

  • 模板/資源: 新增技能應參考的範本、CSV 範例、設計規格或實體字典。
  • 意圖/描述: 寫一個簡短、明確的描述,說明該技能的用途(這有助於克勞德匹配它)。
  • 啟動提示/觸發器: 添加關鍵字或範例提示,以使克勞德加載該技能。
  • 說明文件: 將穩定的指令(例如,品牌基調、必要部分)放入技能內的單一規格文件中。

步驟 4:下載並上傳技能

滿意後,Claude 會將技能打包為 ZIP 檔案。在左側邊欄中,點選「功能」。

如何創建和使用克勞德技能? 3種方法詳細指南!

或者,您可以將 ZIP 檔案拖曳到上傳區域。 Claude 會驗證並安裝它,確認已啟動。

第五步:在真實對話中運用技能

儲存後,請嘗試與技能觸發器相符的自然提示(或提及技能名稱)。應用會指示技能載入時間,並可能顯示其使用的資源;執行幾次迭代並最佳化指令,直到輸出可靠。當使用者要求 Claude 執行相關任務時,Claude 可以自動偵測並載入相符的技能,或者您可以明確地呼叫它。技能的指令、模板和程式碼將指導 Claude 的輸出。

Claude Apps Web 的提示

  • 系統包含常見任務的內建技能,例如:文件產生;報告建立;PowerPoint 簡報;Excel 公式計算。
  • 用戶可以直接自訂自己的技能。
  • 克勞德會自動召喚相關技能,無需手動選擇。
  • 在克勞德的推理過程中,使用者可以看到哪些技能被召喚。
  • 首先優先考慮不可執行的任務。 **僅指定指令(無程式碼)的 Web 技能更容易審核。

如何在 Claude Code 中使用 Claude 技能?

條件

  • 訪問克勞德法典:Claude Code 是 Anthropic 的 IDE/終端助手介面-通常包含在開發者計畫中,或可透過外掛程式/市集存取。某些技能功能需要存取程式碼執行工具或 ADK(代理開發工具包)。 CometAPI 提供對 Claude 程式碼和 Claude API 的存取。您可以在 CometAPI 的 Claude 程式碼中使用技能,並諮詢 文檔 使用克勞德代碼。
  • 本地開發者環境:如果技能包含測試套件或程式碼,您將需要克隆技能儲存庫並在本地運行測試。

在 Claude Code 中創建和使用技能的逐步指南

步驟 1:建立技能資料夾結構:

在 Claude Code 中,技能通常以資料夾的形式存在,其中包含清單(元資料)、指令檔案、測試輸入、幫助腳本(Python/JS)以及任何二進位檔案或範本:

  1. 定義技能清單:清單包括 skill_id、名稱、描述、作者、依賴項、入口點和安全說明。這會告訴 Claude Code 如何以及何時加載該技能。
  2. 實作輔助腳本和測試:如果您的技能使用程式碼來轉換或產生文件,請新增在程式碼執行環境內執行的小型、範圍良好的腳本和單元測試。

步驟 2:安裝或新增技能包

  • 在 Claude Code 中,打開插件/市場面板並 add anthropics/skills (或特定的技能庫)。
  • 或將技能儲存庫克隆到您的工作區。

如何創建和使用克勞德技能? 3種方法詳細指南!

選擇“人類代理技能”,

人類代理技能

然後選擇“document-skills”(用於文件生成)或“example-skills”(用於演示)。在本教學中,請選擇「document-skills」—它可以預覽 Word 文件建立等功能。點擊「立即安裝」;Claude Code 將下載並註冊這些技能。

步驟 3:編寫高階程式碼處理程序

  • 實作對檔案進行操作或呼叫外部工具的處理程序(例如,使用 python-pptx 產生 .pptx,使用 openpyxl 建立 .xlsx)。
  • 如果技能需要遠端程式碼執行,請確保它符合 Anthropic 的容器模型(API 文件描述了技能如何使用容器來運行程式碼)。

步驟 4:在 Claude 程式碼中載入並測試

  • 啟動 Claude Code 會話並要求 Claude 運行您的技能(例如,「使用 ReportGen Skill 創建 Q3 收入幻燈片」)。
  • 觀察工作區中的日誌、輸出和任何產生的工件。

步驟 5:打包並發布

將技能提交到您組織的技能註冊表或推送到已批准的 GitHub 程式碼庫。使用版本標籤並包含測試套件以便管理。

克勞德·科德的提示

  • 像對待程式碼項目一樣對待技能:當程式碼或範本發生變化時,使用 CI 執行技能測試。
  • 隔離副作用:如果技能可以執行腳本,請在一次性容器或沙箱中運行它們,以避免意外的資料外洩。
  • 清晰地記錄輸入/輸出 這樣非開發人員隊友以後就可以在 Web 應用程式中使用該技能。

如何在 Claude API 中使用 Claude Skills?

條件

造訪 Anthropic 的 訊息 API程式碼執行工具 已啟用(技能透過容器參數與訊息 API 整合)。您還需要 API 憑證以及在容器中執行技能程式碼所需的任何執行時間權限。

透過 API 創建和使用技能的逐步指南:

步驟 1:在本地準備技能包

建立一個符合 API 預期清單格式(名稱、版本、指令檔案、觸發器、可選資源路徑和輔助腳本)的 Skill 資料夾。 Anthropic 的文檔提供了相應的架構和範例。

第 2 步:上傳或註冊技能

人因管理技能:參考 skill_id 以及 API 呼叫中的可選版本(無需上傳)。使用您的 API 金鑰進行身份驗證並呼叫技能建立端點(例如, POST /v1/skills 或類似的終點。

curl -X POST "https://api.anthropic.com/v1/skills" \  
-H "x-api-key: $ANTHROPIC_API_KEY" \  
-H "anthropic-version: 2023-06-01" \  
-H "anthropic-beta: skills-2025-10-02" \  
-F "display_title=My Excel Skill" \  
-F "files=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

上傳技能負載或將 API 指向壓縮的工件。 API 將驗證並儲存工作區中的技能。

無論來源為何,技能都以相同的方式整合到訊息傳遞 API 中。您可以使用 skill_id、type 以及可選的 skill_version 參數指定技能版本,該參數將在程式碼執行環境中執行:

方面人擇技能客製化技能
類型值anthropiccustom
技能ID簡稱: pptxxlsxdocxpdf生成: skill_01AbCdEfGhIjKlMnOpQrStUv
版本格式基於日期: 20251013 or latest紀元時間戳: 1759178010641129 or latest
管理由 Anthropic 預先建造並維護透過技能 API 上傳和管理
庫存情況可供所有用戶使用專屬於您的工作區

步驟 3:使用容器參數呼叫訊息 API

在您的訊息 API 請求中,包含 container 字段指定 skill_id, type (anthropic or custom),以及可選的 version。訊息端點將執行路由到技能運行的程式碼環境。

範例(概念):

   {
     "model": "claude-sonnet-4-5-20250929",
     "messages": }],
     betas=,
     "container": {"type":"custom","skill_id":"skill_01AbCdEf","version":"latest"}
   }

步驟4:下載產生的文件

當技能建立文件(Excel、PowerPoint、PDF、Word)時,它會在回應中傳回 file_id 屬性。您必須使用檔案 API 下載這些檔案:

def extract_file_ids(response):
file_ids = []
for item in response.content:
if item.type == 'bash_code_execution_tool_result':
content_item = item.content
if content_item.type == 'bash_code_execution_result':
for file in content_item.content:
if hasattr(file, 'file_id'):
file_ids.append(file.file_id)
return file_ids

for file_id in extract_file_ids(response):
file_metadata = client.beta.files.retrieve_metadata(
file_id=file_id,
betas=
)
file_content = client.beta.files.download(
file_id=file_id,
betas=
)

file_content.write_to_file(file_metadata.filename)
print(f"Downloaded: {file_metadata.filename}")

API 使用技巧

  • 更傾向於使用人類管理的常見格式技能 (pptx/xlsx/docx)以避免重複造輪子。
  • 使用版本字段。 固定到生產中的技能版本以避免意外行為。
  • 實施護欄 在您的系統中:清理輸入、限製檔案大小並在向外部公開工件之前執行生成後驗證。

為什麼要使用 Claude Skills——有什麼好處和壞處?

優勢

  • 一致性和質量: 技能編碼組織最佳實踐(品牌規則、法律措辭),因此產出是一致的,並減少手動返工。
  • 生產率: 自動執行可重複的任務(資料準備、投影片建立、範本應用程式)可縮短週期-早期客戶在 Beta 測試中報告了更快的輸出時間。
  • 可重複使用性與治理: 技能成為版本化的產物,可以像軟體一樣進行審查、測試和推出,從而簡化審計和合規性。
  • 降低複雜流程的令牌/計算成本: 由於 Claude 僅在需要時加載技能的相關部分,因此您可以避免始終發送冗長的系統​​提示,從而降低成本和上下文膨脹。

限制:

  • 前期工作: 建立強大的技能需要設計、文件和測試——您正在用產品工程來交換提示工程。
  • 可執行風險: 運行程式碼或存取資料的技能會增加安全表面積;企業必須限制誰可以發布和批准可執行技能。
  • 計劃和功能可用性: 技能功能已於公告發佈時向 Pro、Max、Team 和 Enterprise 套餐推出;免費用戶可能預設無法使用技能功能。請查看您的套餐。

Claude Skills 與其他平台和代理商模式相比如何?

技能 = 更豐富、版本化的構件。 ** 它們比一次性的工具呼叫或範本更具結構化:技能將指令、資源、腳本和清單打包在一個可重複使用的套件中。這使得它們更接近一個可部署的微代理,而非單一的工具呼叫。

技能與臨時系統提示和提示庫

系統提示是短暫的,必須每次會話都提供;而技能是持久的、版本化的、集中管理的。因此,技能更適合企業規模化和可重複性。

技能與基於工具的代理(工具呼叫/函數呼叫)

基於工具的代理(例如,函數呼叫模式)專注於賦予模型具體的外部能力(API、工具呼叫)。技能結合 說明 + 資源 + 可選助手 並旨在教導模型 如何 完成一項任務(包括何時使用工具)。簡而言之:工具 執行器;技能編纂可能使用工具的程序和政策。

Skills 與 OpenAI 的 AgentKit 和類似的代理框架

最近發布的產品(例如在 OpenAI DevDay 上)強調了打包代理商和開發者工具包,以便從原型轉向生產。 Claude Skills 扮演著類似的角色,但更專注於 資料夾化說明 + 資源 以及跨 Claude 應用程式、程式碼和 API 的緊密交叉整合。這兩種方法正在融合:都旨在支援生產代理,但實作細節(SDK API、治理控制、市場模式)有所不同。如果您已經使用代理框架,技能通常可以作為您載入到這些代理程式中的「能力模組」。

什麼時候應該選擇技能而不是自訂代理?

  • 使用技能時 您需要跨使用者和 UI 的標準化、可共享、低摩擦的功能(非開發人員受益)。
  • 在以下情況下使用自訂代理 您需要在 Claude 的 Skill 執行模型之外,使用自訂的控制邏輯進行複雜的多工具編排。 Skill 非常適合處理打包整齊的領域任務;而 Agent 則適用於重量級的編排。

其他模式仍然獲勝

  • 低延遲、輕量級任務:對於微小的任務或不需要可重複的輸出,函數呼叫或系統提示仍然更簡單。
  • 客製化工俱生態系統:如果您已經擁有透過 API 公開的大型自訂工具基礎設施,那麼與編排層整合的函數呼叫/插件可能更適合。

實際的現實世界範例和食譜

範例 1 — 品牌投影片格式化程式(Web 應用技能)

  • 它的作用: 將原始幻燈片重點轉換為公司品牌幻燈片(字體、色調、幻燈片順序)。
  • 在 Web 應用程式中建立: 使用技能建立器 → 新增品牌風格指南、投影片範本和範例輸入/輸出。為設計團隊啟用。透過詢問「使用品牌幻燈片格式化程式格式化這些筆記」進行測試。

範例 2 — CSV 資料審計員(Claude 程式碼技能)

  • 它的作用: 驗證 CSV 資料列,執行輕量級 Python 檢查(缺失值、類型不符),並傳回摘要報告。
  • 在程式碼中建立: 培養技能 validators.py 助手、單元測試和範例 CSV。在 Claude Code 的筆記本中進行迭代測試,然後打包並發布。

範例 3 — 合約紅線助理(API 技能)

  • 它的作用: 將公司法律標準應用於合約文本並產生紅線和理由。
  • 透過 API 創建: 編寫說明文件和子句庫,透過上傳 POST /skills,然後從您的合約管理系統調用 skill_id 產生標準化的紅線輸出。

結論

Claude Skills 是臨時指令和成熟代理工程之間的實用橋樑:它們讓團隊能夠掌握機構專業知識,強化風格和安全性,並在 UI 和程式介面上自動執行重複性任務。無論您是使用 Web Skill-Creator 的非技術產品經理,還是使用 Claude Code 交付可重複開發工具的工程師,還是使用 Messages API 將 Skills 整合到應用中的平台團隊,遵循小型且規範的實踐——版本控制、測試、最小權限和分階段發布——都能確保您的 Skills 在生產環境中可靠且可審計。

入門

CometAPI 是一個統一的 API 平台,它將來自領先供應商(例如 OpenAI 的 GPT 系列、Google 的 Gemini、Anthropic 的 Claude、Midjourney、Suno 等)的 500 多個 AI 模型聚合到一個開發者友好的介面中。透過提供一致的身份驗證、請求格式和回應處理,CometAPI 顯著簡化了將 AI 功能整合到您的應用程式中的過程。無論您是建立聊天機器人、影像產生器、音樂作曲家,還是資料驅動的分析流程,CometAPI 都能讓您更快地迭代、控製成本,並保持與供應商的兼容性——同時也能充分利用整個 AI 生態系統的最新突破。

CometAPI 提供對 Claude 程式碼和 Claude API 的存取。您可以在 CometAPI 的 Claude 程式碼中使用技能並諮詢 文檔 使用克勞德代碼。

為什麼要透過 CometAPI 使用 claude 程式碼?

頂級人工智慧功能:使用專為開發人員構建的模型輕鬆生成、調試和優化程式碼。

  • 靈活的模型選擇:我們全面的模型系列使您能夠更無縫地進行開發。
  • 無縫整合:API 始終可用。只需幾分鐘即可將 Claude Code 直接整合到您現有的工作流程中。
  • 透過 CometAPI 使用 Claude 程式碼將節省更多成本CometAPI提供的Claude API比官方價格優惠20%,並由官方更新最新模型。最新模型是 克勞德俳句 4.5 API.

準備出發了嗎? → 立即註冊 CometAPI !

如果您想了解更多有關 AI 的提示、指南和新聞,請關注我們 VKX   不和!

SHARE THIS BLOG

一個 API 中超過 500 個模型

最高 20% 折扣