--- title: Agent Skills url: https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview description: Agent Skills 是可擴充 Claude 功能的模組化能力。每個 Skill 都封裝了指令、中繼資料以及選用的資源（腳本、範本），Claude 會在相關時自動使用它們。 featureMetadata: status: stable zdr: eligibility: not-eligible note: 技能資料依標準政策保留。 supportedModels: - claude-fable-5-1 - claude-mythos-5-1 - claude-fable-5 - claude-mythos-5 - claude-mythos-preview - claude-opus-5-5 - claude-opus-5 - claude-sonnet-5-5 - claude-sonnet-5 - claude-haiku-5-5 - claude-haiku-4-5-20251001 - claude-opus-4-8 - claude-opus-4-7 - claude-opus-4-6 - claude-sonnet-4-6 - claude-opus-4-5-20251101 - claude-sonnet-4-5-20250929 supportedPlatforms: Claude API: stable Claude Platform on AWS: stable Claude Models on Google Cloud (Anthropic managed): stable Microsoft Foundry (hosted on Anthropic): availability: stable note: 僅限託管於 Anthropic 的部署；Foundry 不支援技能版本下載端點（`GET /v1/skills/{skill_id}/versions/{version}/content`）。 --- **API 支援**：用法因產品而異。 * **Messages API**：在 `container` 參數中列出 `skill_ids`，並加入程式碼執行工具，技能會在其容器中執行。 * **Managed Agents**：在代理的 `skills` 陣列中附加技能，或從掛載於工作階段的 GitHub 存放庫載入技能。 ## 為什麼要使用 Skills Skills 是可重複使用、以檔案系統為基礎的資源，能賦予 Claude 特定領域的專業知識：工作流程、上下文與最佳實務，將通用型代理轉變為專家。與提示（針對一次性任務的對話層級指令）不同，Skills 會依需求載入，因此您不必在不同對話中重複相同的指引。 **主要優點：** * **讓 Claude 專業化：** 針對特定領域的任務量身打造能力 * **減少重複：** 建立一次，自動使用 * **組合能力：** 結合多個 Skills 以處理複雜的多步驟任務 如需進一步了解 Agent Skills 的架構與實際應用，請參閱工程部落格文章[透過 Agent Skills 讓代理為真實世界做好準備](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)。 ## 使用 Skills Anthropic 為常見的文件任務（PowerPoint、Excel、Word、PDF）提供預先建置的 Agent Skills，您也可以建立自己的自訂 Skills。兩者的運作方式相同：一旦某個 Skill 在您的環境中可用，Claude 就會在與您的請求相關時自動使用它。 **預先建置的 Agent Skills** 可在 claude.ai、Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) 以及 [Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 上使用。在 Microsoft Foundry 上，Agent Skills 需要[託管於 Anthropic 的部署](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure)。完整清單請參閱[可用的 Skills](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview#available-skills)。 **自訂 Skills** 讓您能封裝領域專業知識與組織知識。它們可在 Claude 的各項產品中使用：在 Claude Code 中建立、透過 Claude API 上傳，或在 claude.ai 設定中新增。在 [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) 與 [Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 上，請透過 Skills API 上傳自訂 Skills。 **開始使用：** * 預先建置的 Agent Skills：請參閱[快速入門教學](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/quickstart)，開始在 API 中使用 PowerPoint、Excel、Word 與 PDF Skills * 自訂 Skills：請參閱 [Agent Skills Cookbook](https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction)，了解如何建立您自己的 Skills ## Skills 的運作方式 Skills 利用 Claude 的 VM 環境，提供僅靠提示無法達成的能力。Claude 在具有檔案系統存取權的虛擬機器中運作，使 Skills 能以目錄的形式存在，其中包含指令、可執行程式碼與參考資料，組織方式就像您為新進團隊成員準備的入職指南。 這種基於檔案系統的架構實現了 **「progressive disclosure」（漸進式揭露）：** Claude 會依需要分階段載入資訊，而非預先耗用上下文。 Skills 可包含三種類型的內容，各自在不同時間載入： ### 第 1 層：中繼資料（始終載入） Skill 的 YAML frontmatter 提供探索資訊： ```yaml --- name: pdf-processing description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction. --- ``` Claude 會在啟動時載入這些中繼資料，並將其納入「system prompt」（系統提示）中。`description` 是 Claude 在判斷是否觸發該 Skill 時用來比對您請求的依據，因此它必須同時說明該 Skill 的功能以及何時使用。這種輕量化的做法意味著您可以安裝許多 Skills 而不會造成上下文負擔：在 Skill 被觸發之前，只有其名稱與描述會佔用上下文。 ### 第 2 層：指令（觸發時載入） `SKILL.md` 的主體包含程序性知識：工作流程、最佳實務與指引： ````markdown # PDF Processing ## Quick start Use pdfplumber to extract text from PDFs: ```python import pdfplumber with pdfplumber.open("document.pdf") as pdf: text = pdf.pages[0].extract_text() ``` For advanced form filling, see [FORMS.md](FORMS.md). ```` 當您提出的請求符合某個 Skill 的描述時，Claude 會使用 bash 從檔案系統讀取 `SKILL.md`。只有在此時，這些內容才會進入上下文視窗。 ### 第 3 層：資源和程式碼（依需要載入） Skills 可以附帶額外的資料： * `pdf-processing/` * `SKILL.md`（主要指示） * `FORMS.md`（表單填寫指南） * `REFERENCE.md`（詳細的 API 參考） * `scripts/` * `fill_form.py`（公用程式腳本） **指示：** 額外的 Markdown 檔案（`FORMS.md`、`REFERENCE.md`），包含專門的指引與工作流程 **程式碼：** Claude 透過 bash 執行的可執行腳本（`fill_form.py`、`validate.py`），提供確定性的操作，而無需將其程式碼載入上下文 **資源：** 參考資料，例如資料庫結構描述、API 文件、範本或範例 Claude 只有在被引用時才會存取這些檔案。檔案系統模型意味著每種內容類型各有不同的優勢：指示提供彈性的指引，程式碼提供可靠性，資源則用於查詢事實。 | 層級 | 載入時機 | Token 成本 | 內容 | | -------------- | ---------- | ---------------------- | ---------------------------------------------- | | **第 1 層：中繼資料** | 一律載入（啟動時） | 每個 Skill 約 100 個 token | YAML frontmatter 中的 `name` 與 `description` | | **第 2 層：指示** | Skill 被觸發時 | 少於 5k 個 token | 包含指示與指引的 `SKILL.md` 主體 | | **第 3 層以上：資源** | 依需要 | 存取前無成本 | 隨附的檔案。參考檔案在被讀取時載入上下文。腳本透過 bash 執行，只有其輸出會進入上下文。 | 漸進式揭露確保在任何時候只有相關內容會佔用上下文視窗。 ### Skills 架構 Skills 在程式碼執行環境中運作，Claude 在其中擁有檔案系統存取權、bash 命令和程式碼執行能力。Skills 以目錄的形式存在於虛擬機器上，Claude 使用與您在電腦上瀏覽檔案時相同的 bash 命令與它們互動。 ![Agent Skills 架構，顯示 Skills 如何與代理的設定及虛擬機器整合](https://platform.claude.com/docs/zh-TW/images/agent-skills-architecture.svg) **Claude 如何存取 Skill 內容：** 當 Skill 被觸發時，Claude 會使用 bash 從檔案系統讀取 `SKILL.md`，將其指示帶入上下文視窗。如果這些指示參照其他檔案（例如 `FORMS.md` 或資料庫結構描述），Claude 也會透過額外的 bash 命令讀取這些檔案。當指示提到可執行腳本時，Claude 會透過 bash 執行它們，且只接收輸出（腳本程式碼本身永遠不會進入上下文）。 **此架構所帶來的可能性：** * **隨需存取檔案：** Claude 只會讀取每個任務所需的檔案。一個 Skill 可以包含數十個參考檔案，但如果您的任務只需要銷售結構描述，Claude 就只會載入那一個檔案。其餘檔案保留在檔案系統中，不耗用任何 token。 * **高效的腳本執行：** 當 Claude 執行 `validate_form.py` 時，腳本的程式碼永遠不會載入上下文視窗。只有其輸出（例如「Validation passed」或特定的錯誤訊息）會耗用 token，這使得腳本遠比讓 Claude 在任務中生成同等程式碼更有效率。 * **隨附內容實際上沒有限制：** 檔案在被存取之前不會耗用上下文，因此 Skills 可以包含完整的 API 文件、大型資料集或大量範例。未被使用的隨附內容不會造成任何上下文負擔。 ### 範例：載入 PDF 處理 Skill 以下說明 Claude 如何載入並使用前面範例中的自訂 `pdf-processing` Skill（而非預建的 `pdf` Skill）： 1. **啟動：** 系統提示包含：`pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.` 2. **使用者請求：**「擷取此 PDF 的文字並加以摘要。」 3. **Claude 呼叫：** `bash: cat pdf-processing/SKILL.md` → 指示載入上下文。 4. **Claude 判斷：** 不需要填寫表單，因此 Claude 不會讀取 `FORMS.md`。 5. **Claude 完成任務：** 使用 `SKILL.md` 中的指示。 ![Skills 載入上下文視窗：Skill 中繼資料和內容的漸進式載入](https://platform.claude.com/docs/zh-TW/images/agent-skills-context-window.svg) ## Skills 的適用範圍 Skills 可在 Claude 的各項代理產品中使用： 在以下所有章節中，Claude Platform on AWS 和 Microsoft Foundry 沿用與 Claude API 相同的 Skills 行為，除非[限制與約束](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview#limitations-and-constraints)另有說明。 ### Claude API Claude API 同時支援預建 Agent Skills 和自訂 Skills。兩者的運作方式完全相同：在 `container` 參數中指定相關的 `skill_id`，並搭配[程式碼執行工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/code-execution-tool)使用。 **先決條件：** 透過 API 使用 Skills 需要[程式碼執行工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/code-execution-tool)，Skills 會在其容器中執行。 透過引用 `skill_id`（`pptx`、`xlsx`、`docx` 或 `pdf`）來使用預建 Agent Skills，或透過 Skills API（`/v1/skills` 端點）建立並上傳您自己的 Skills。自訂 Skills 在整個工作區內共享：所有工作區成員都可以存取它們。 API 上的 Skills 在沙箱容器中執行，沒有網路存取權，也無法在執行時安裝套件。詳情請參閱[限制與約束](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview#limitations-and-constraints)。 如需進一步了解，請參閱[透過 API 使用 Agent Skills](https://platform.claude.com/docs/zh-TW/build-with-claude/skills-guide)。 ### Claude Code [Claude Code](https://code.claude.com/docs/zh-TW/overview) 支援自訂 Skills。預建的文件 Skills（PowerPoint、Excel、Word、PDF）在 Claude Code 中無法使用，不過開源的 [Claude API 技能](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/claude-api-skill)已隨附其中。請參閱 Claude Code 隨附的[內建命令和 Skills](https://code.claude.com/docs/zh-TW/commands) 完整清單。 **自訂 Skills：** 將 Skills 建立為包含 `SKILL.md` 檔案的目錄。Claude 會自動探索並使用它們。 Claude Code 中的自訂 Skills 以檔案系統為基礎，不需要透過 API 上傳：將它們放在 `~/.claude/skills/`（個人）或 `.claude/skills/`（專案）中。 如需進一步了解，請參閱[在 Claude Code 中使用 Skills](https://code.claude.com/docs/zh-TW/skills)。 ### claude.ai [claude.ai](https://claude.ai) 同時支援預建 Agent Skills 和自訂 Skills。 **預建 Agent Skills：** 這些 Skills 在您建立文件時會啟用。Claude 會直接使用它們，無需任何設定。 **自訂 Skills：** 以 zip 檔案上傳您自己的 Skills。適用於 Pro、Max、Ultra、Team 和 Enterprise 方案，且需[啟用程式碼執行](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude)。 如需進一步了解如何在 claude.ai 中使用 Skills，請參閱 Claude 說明中心的以下資源： * [什麼是 Skills？](https://support.claude.com/en/articles/12512176-what-are-skills) * [在 Claude 中使用 Skills](https://support.claude.com/en/articles/12512180-using-skills-in-claude) * [如何建立自訂 Skills](https://support.claude.com/en/articles/12512198-creating-custom-skills) * [使用 Skills 教導 Claude 您的工作方式](https://support.claude.com/en/articles/12580051-teach-claude-your-way-of-working-using-skills) ## Skill 結構 每個 Skill 都需要一個帶有 YAML frontmatter 的 `SKILL.md` 檔案： ```markdown --- name: your-skill-name description: Brief description of what this Skill does and when to use it --- # Your Skill Name ## Instructions [Clear, step-by-step guidance for Claude to follow] ## Examples [Concrete examples of using this Skill] ``` **必要欄位：** `name` 與 `description` **欄位要求：** `name`： * 最多 64 個字元 * 只能包含小寫字母、數字與連字號 * 不得包含 XML 標籤 * 不得包含保留字：`anthropic`、`claude` `description`： * 不得為空 * 最多 1,024 個字元 * 不得包含 XML 標籤 `description` 必須同時包含該 Skill 的功能以及 Claude 應在何時使用它。完整的撰寫指引請參閱 [Skill 撰寫最佳實務](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/best-practices)。 ## 安全性考量 請只使用來自可信來源的 Skills：您自己建立的，或從 Anthropic 取得的。Skills 透過指示與程式碼賦予 Claude 新的能力，這也意味著惡意的 Skill 可能會指示 Claude 以不符合該 Skill 所宣稱用途的方式呼叫工具或執行程式碼。 如果您必須使用來自不受信任或未知來源的 Skill，請務必極度謹慎，並在使用前徹底稽核。視 Claude 執行該 Skill 時擁有的存取權限而定，惡意的 Skills 可能導致資料外洩、未經授權的系統存取或其他安全風險。 **主要安全性考量：** * **徹底稽核：** 檢閱 Skill 中隨附的所有檔案：`SKILL.md`、腳本、圖片及其他資源。留意異常模式，例如非預期的網路呼叫、檔案存取模式，或不符合該 Skill 所宣稱用途的操作。 * **外部來源具有風險：** 從外部 URL 擷取資料的 Skills 特別具有風險，因為擷取的內容可能包含惡意指示。即使是值得信任的 Skills，若其外部相依項目隨時間變更，也可能遭到入侵。 * **工具濫用：** 惡意的 Skills 可能以有害的方式呼叫工具（檔案操作、bash 命令、程式碼執行）。 * **資料暴露：** 可存取敏感資料的 Skills 可能被設計成將資訊洩漏至外部系統。 * **比照安裝軟體看待：** 將 Skills 整合到可存取敏感資料或關鍵操作的正式環境系統時，請格外小心。 如需組織規模的治理、審核與部署指引，請參閱[企業適用的 Skills](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/enterprise)。Claude Enterprise 組織也可以針對在 claude.ai 與 Claude Cowork 中上傳的自訂 Skills 開啟 [Skill 內容掃描](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/enterprise#skill-content-scanning)。掃描不涵蓋透過 Skills API 或 Claude Console 上傳的 Skills。 ## 可用的 Skills ### 預先建置的 Agent Skills 下列預先建置的 Agent Skills 可立即使用： * **PowerPoint (pptx)：** 建立簡報、編輯投影片、分析簡報內容 * **Excel (xlsx)：** 建立試算表、分析資料、產生含圖表的報告 * **Word (docx)：** 建立文件、編輯內容、格式化文字 * **PDF (pdf)：** 產生格式化的 PDF 文件與報告 這些 Skills 可在 Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)、[Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 與 claude.ai 上使用。請參閱[快速入門教學](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/quickstart)，開始在 API 中使用它們。 ### 開源 Skills Anthropic 也在 [skills 儲存庫](https://github.com/anthropics/skills)中發布開源 Skills： * **[Claude API 技能](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/claude-api-skill)：** 為 Claude 提供最新的 API 參考資料、SDK 文件，以及八種程式語言的最佳實務。隨附於 Claude Code，也可從 skills 儲存庫安裝。 ### 自訂 Skills 範例 如需自訂 Skills 的完整範例，請參閱 [Agent Skills Cookbook](https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction)。 ## 資料保留 Agent Skills 不在 ZDR 安排的涵蓋範圍內。Skill 定義與執行資料會依據 Anthropic 的標準資料保留政策保留。 如需 Skills API 操作的稽核記錄，請參閱「透過 API 使用 Agent Skills」中的[稽核記錄](https://platform.claude.com/docs/zh-TW/build-with-claude/skills-guide#audit-logging)。 ## 限制與約束 在以下各小節中，Claude Platform on AWS 和 Microsoft Foundry 遵循與 Claude API 相同的限制。此外，在 Microsoft Foundry 上，無法使用 [Skill 版本下載端點](https://platform.claude.com/docs/zh-TW/api/beta/skills/versions/download)（`GET /v1/skills/{skill_id}/versions/{version}/content`）。 ### 跨介面可用性 **自訂 Skills 不會跨介面同步**。上傳至某一介面的 Skills 不會自動在其他介面上可用： * 上傳至 claude.ai 的 Skills 必須另外上傳至 API。 * 透過 API 上傳的 Skills 無法在 claude.ai 上使用。 * Claude Code Skills 是基於檔案系統的，與 claude.ai 及 API 皆互相獨立。 請針對您想使用 Skills 的每個介面分別管理與上傳。 ### 共享範圍 Skills 依您使用的位置而有不同的共享模式： * **Claude API：** 整個工作區。所有工作區成員皆可存取已上傳的 Skills。 * **Claude Code：** 個人（`~/.claude/skills/`）或以專案為基礎（`.claude/skills/`）。也可透過 Claude Code 外掛程式共享。 ### 執行階段環境約束 您的 Skill 可用的確切執行階段環境取決於您使用它的產品介面。 * **claude.ai：** * **網路存取程度不一：** 視使用者/管理員設定而定，Skills 可能擁有完整、部分或無網路存取權限。如需更多詳細資訊，請參閱[使用 Claude 建立與編輯檔案](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude#h_6b7e833898)支援文章。 * **Claude API：** * **無網路存取：** Skills 無法進行外部 API 呼叫或存取網際網路。 * **無法在執行階段安裝套件：** 只能使用預先安裝的套件。您無法在執行期間安裝新套件。 * **僅限預先設定的相依項目：** 請查看[程式碼執行工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/code-execution-tool)文件以取得可用套件清單。 * **Claude Code：** * **完整網路存取：** Skills 擁有與使用者電腦上任何其他程式相同的網路存取權限。 * **不建議全域安裝套件：** Skills 應只在本機安裝套件，以避免干擾使用者的電腦。 請規劃您的 Skills，使其能在這些約束下運作。 ## 後續步驟 了解如何在 10 分鐘內使用 Agent Skills 搭配 Claude API 建立文件。 了解如何透過 API 使用 Agent Skills 擴充 Claude 的能力。 在 Claude Code 中建立與管理自訂 Skills。 了解如何撰寫 Claude 能夠探索並成功使用的有效 Skills。 ## 可用性 Agent Skills在所有模型上可供使用。 ### API 支援 #### [Messages API](https://platform.claude.com/docs/zh-TW/build-with-claude/working-with-messages) * 可用性：可用 * 用法：在 `container` 參數中列出 `skill_ids`，並加入程式碼執行工具，技能會在其容器中執行。 | 狀態 | 雲端平台 | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 可用 | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | | 可用1 | [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) | 1. 僅限託管於 Anthropic 的部署；Foundry 不支援技能版本下載端點（`GET /v1/skills/{skill_id}/versions/{version}/content`）。 #### [Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview) * 可用性：可用 * 用法：在代理的 `skills` 陣列中附加技能，或從掛載於工作階段的 GitHub 存放庫載入技能。 | 狀態 | 雲端平台 | | -- | ------- | | 可用 | 所有支援的平台 | ### 資料處理 [資料處理概覽](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#feature-eligibility) | 項目 | 零資料保留 | HIPAA | | ---- | ----------------------------------------------------------------------------------------------------------------- | ----- | | 狀態 | 不符合資格 | 不符合資格 | | 詳細資訊 | 技能資料依標準政策保留。 [深入了解](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview#data-retention) | — | 適用端點： * `/v1/skills` * `/v1/messages` 搭配 `skills`