點擊下方“JavaEdge”，選擇“設為星標”

第一時間關(guān)注技術(shù)干貨！

本文已收錄在Github，關(guān)注我，緊跟本系列專欄文章，咱們下篇再續(xù)！

• 魔都架構(gòu)師 | 全網(wǎng)30W技術(shù)追隨者

• 大廠分布式系統(tǒng)/數(shù)據(jù)中臺實戰(zhàn)專家

• 主導交易系統(tǒng)百萬級流量調(diào)優(yōu) & 車聯(lián)網(wǎng)平臺架構(gòu)

• AIGC應用開發(fā)先行者 | 區(qū)塊鏈落地實踐者

• 以技術(shù)驅(qū)動創(chuàng)新，我們的征途是改變世界！

• 實戰(zhàn)干貨：編程嚴選網(wǎng)

Agent Skills 是擴展 Claude 功能的模塊化能力。每個 Skill 包含指令（instructions）、元數(shù)據(jù)（metadata）和可選資源（scripts腳本、templates模板），Claude 在相關(guān)時會自動使用這些資源。

1 為啥用 Skills

Skills 是可重用的、基于文件系統(tǒng)的資源，為 Claude 提供特定領(lǐng)域的專業(yè)知識：工作流、上下文和最佳實踐，將通用代理轉(zhuǎn)變?yōu)閷＜?。與提示不同（提示是對話級別的一次性任務指令），Skills 按需加載，無需在多個對話中重復提供相同的指導。

1.1 優(yōu)勢

• 專業(yè)化 Claude：為特定領(lǐng)域的任務定制功能

• 減少重復：創(chuàng)建一次，自動使用

• 組合功能：結(jié)合 Skills 構(gòu)建復雜工作流

Agent Skills 的架構(gòu)和實際應用的深入討論：使用 Agent Skills 為真實世界裝備代理。

2 使用 Skills

Anthropic 為常見文檔任務（PPT、Excel、Word、PDF）提供:

• 預構(gòu)建的 Agent Skills

• 也可創(chuàng)建自定義 Skills

二者工作方式相同。Claude 在與你的請求相關(guān)時會自動使用它們。

2.1 預構(gòu)建的 Agent Skills

可供 claude.ai 上的所有用戶和通過 Claude API 使用。請參閱下面的可用 Skills 部分了解完整列表。

2.2 自定義 Skills

讓你打包領(lǐng)域?qū)I(yè)知識和組織知識。它們在 Claude 的所有產(chǎn)品中都可用：在 Claude Code 中創(chuàng)建它們、通過 API 上傳它們，或在 claude.ai 設置中添加它們。

2.3 開始使用

• 預構(gòu)建的 Agent Skills：快速入門教程，開始在 API 中使用 PowerPoint、Excel、Word 和 PDF skills

• 自定義 Skills：Agent Skills 食譜，了解如何創(chuàng)建你自己的 Skills

Skills 利用 Claude 的虛擬機環(huán)境提供超越僅使用提示可能實現(xiàn)的功能。Claude 在具有文件系統(tǒng)訪問權(quán)限的虛擬機中運行，允許 Skills 作為包含指令、可執(zhí)行代碼和參考資料的目錄存在，組織方式就像你為新團隊成員創(chuàng)建的入職指南。

這種基于文件系統(tǒng)的架構(gòu)支持漸進式披露：Claude 按需分階段加載信息，而不是預先消耗上下文。

3.1 Skill內(nèi)容類型及其加載級別

Skills 可包含三種類型的內(nèi)容，每種在不同時間加載：

1級：元數(shù)據(jù)（始終加載）

內(nèi)容類型：指令。Skill 的 YAML 前置數(shù)據(jù)提供發(fā)現(xiàn)信息：

---
name: pdf-processing
description: 從 PDF 文件中提取文本和表格、填充表單、合并文檔。在處理 PDF 文件或用戶提及 PDF、表單或文檔提取時使用。
---

Claude 在啟動時加載此元數(shù)據(jù)并將其包含在系統(tǒng)提示中。這種輕量級方法意味著你可以安裝許多 Skills 而不會產(chǎn)生上下文成本；Claude 只知道每個 Skill 的存在以及何時使用它。

2級：指令（觸發(fā)時加載）

內(nèi)容類型：指令。SKILL.md 的主體包含程序知識：工作流、最佳實踐和指導：

# PDF 處理

 ## 快速入門

 使用 pdfplumber 從 PDF 中提取文本：

 ```python
import pdfplumber

 with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

 有關(guān)高級表單填充，請參閱 [FORMS.md](FORMS.md)。

當你請求與 Skill 描述匹配的內(nèi)容時，Claude 通過 bash 從文件系統(tǒng)讀取 SKILL.md。只有這樣，此內(nèi)容才會進入上下文窗口。

3級：資源和代碼（按需加載）

內(nèi)容類型：指令、代碼和資源。Skills 可捆綁其他材料：

pdf-skill/
├── SKILL.md (主要指令)
├── FORMS.md (表單填充指南)
├── REFERENCE.md (詳細 API 參考)
└── scripts/
    └── fill_form.py (實用腳本)

指令：包含專業(yè)指導和工作流的其他 markdown 文件（FORMS.md、REFERENCE.md）

代碼：Claude 通過 bash 運行的可執(zhí)行腳本（fill_form.py、validate.py）；腳本提供確定性操作而不消耗上下文

資源：參考資料，如數(shù)據(jù)庫架構(gòu)、API 文檔、模板或示例

Claude 僅在引用時訪問這些文件。文件系統(tǒng)模型意味著每種內(nèi)容類型都有不同的優(yōu)勢：指令用于靈活指導，代碼用于可靠性，資源用于事實查詢。

級別

加載時間

令牌成本

內(nèi)容

1級：元數(shù)據(jù)

始終（啟動時）

每個 Skill 約 100 個令牌

YAML 前置數(shù)據(jù)中的name和description

2級：指令

觸發(fā) Skill 時

不到 5k 個令牌

包含指令和指導的 SKILL.md 主體

3級+：資源

按需

實際上無限制

通過 bash 執(zhí)行的捆綁文件，不將內(nèi)容加載到上下文中

漸進式披露確保任何給定時間只有相關(guān)內(nèi)容占據(jù)上下文窗口。

3.2 Skills 架構(gòu)

Skills 在代碼執(zhí)行環(huán)境中運行，Claude 具有文件系統(tǒng)訪問、bash 命令和代碼執(zhí)行功能。可想象成，Skills 作為虛擬機上的目錄存在，Claude 使用與你在計算機上導航文件相同的 bash 命令與它們交互。

① Agent Skills 架構(gòu)

顯示 Skills 如何與代理的配置和虛擬機集成：

② Claude 如何訪問 Skill 內(nèi)容

觸發(fā) Skill 時，Claude 用 bash 從文件系統(tǒng)讀取 SKILL.md，將其指令帶入上下文窗口。

若這些指令引用其他文件（如 FORMS.md 或數(shù)據(jù)庫架構(gòu)），Claude 也會用其他 bash 命令讀取這些文件。當指令提及可執(zhí)行腳本時，Claude 通過 bash 運行它們并僅接收輸出（腳本代碼本身永遠不會進入上下文）。

③ 此架構(gòu)支持的功能

按需文件訪問：Claude 僅讀取每個特定任務所需的文件。Skill 可以包含數(shù)十個參考文件，但如果你的任務只需要銷售架構(gòu)，Claude 僅加載該文件。其余文件保留在文件系統(tǒng)上，消耗零令牌。

高效的腳本執(zhí)行：當 Claude 運行validate_form.py時，腳本的代碼永遠不會加載到上下文窗口中。僅腳本的輸出（如"驗證通過"或特定錯誤消息）消耗令牌。這使腳本比讓 Claude 即時生成等效代碼要高效得多。

捆綁內(nèi)容沒有實際限制：因為文件在訪問前不消耗上下文，Skills 可包含全面的 API 文檔、大型數(shù)據(jù)集、廣泛的示例或任何你需要的參考資料。對于未使用的捆綁內(nèi)容沒有上下文成本。

這種基于文件系統(tǒng)的模型是使?jié)u進式披露工作的原因。Claude 導航你的 Skill 就像你參考入職指南的特定部分一樣，訪問每個任務所需的確切內(nèi)容。

3.3 示例：加載 PDF 處理 skill

Claude加載和使用 PDF 處理 skill 的方式：

1. 啟動：System prompt包括：PDF Processing - Extract text and tables from PDF files, fill forms, merge documents

2. 用戶請求：「從此 PDF 中提取文本并總結(jié)」

3. Claude 調(diào)用：bash: read pdf-skill/SKILL.md→ 指令加載到上下文中

4. Claude 確定：不需要表單填充，因此不讀取 FORMS.md

5. Claude 執(zhí)行：使用 SKILL.md 中的指令完成任務

Skills 加載到上下文窗口 - 顯示 skill 元數(shù)據(jù)和內(nèi)容的漸進式加載：

該圖表顯示：

1. 預加載系統(tǒng)提示和 skill 元數(shù)據(jù)的默認狀態(tài)

2. Claude 通過 bash 讀取 SKILL.md 觸發(fā) skill

3. Claude 根據(jù)需要可選地讀取其他捆綁文件，如 FORMS.md

4. Claude 繼續(xù)執(zhí)行任務

這種動態(tài)加載確保只有相關(guān)的 skill 內(nèi)容占據(jù)上下文窗口。

4 Skills 工作的地方

Skills 在 Claude 的代理產(chǎn)品中可用：

4.1 Claude API

Claude API 支持預構(gòu)建的 Agent Skills 和自定義 Skills。兩者的工作方式相同：在container參數(shù)中指定相關(guān)的skill_id以及代碼執(zhí)行工具。

前提條件：通過 API 使用 Skills 需要三個 beta 標頭：

• code-execution-2025-08-25- Skills 在代碼執(zhí)行容器中運行

• skills-2025-10-02- 啟用 Skills 功能

• files-api-2025-04-14- 上傳/下載文件到/從容器所需

通過引用其skill_id（例如pptx、xlsx）使用預構(gòu)建的 Agent Skills，或通過 Skills API（/v1/skills端點）創(chuàng)建和上傳你自己的。自定義 Skills 在組織范圍內(nèi)共享。

要了解更多信息，請參閱使用 Claude API 的 Skills。

4.2 Claude Code

Claude Code 僅支持自定義 Skills。

自定義 Skills：創(chuàng)建包含 SKILL.md 文件的目錄形式的 Skills。Claude 自動發(fā)現(xiàn)并使用它們。

Claude Code 中的自定義 Skills 基于文件系統(tǒng)，不需要 API 上傳。

要了解更多信息，請參閱在 Claude Code 中使用 Skills。

4.3 Claude Agent SDK

Claude Agent SDK 通過基于文件系統(tǒng)的配置支持自定義 Skills。

自定義 Skills：在.claude/skills/中創(chuàng)建包含 SKILL.md 文件的目錄形式的 Skills。通過在allowed_tools配置中包含"Skill"來啟用 Skills。

SDK 運行時會自動發(fā)現(xiàn) Skills 中的 Skills。

要了解更多信息，請參閱 SDK 中的 Agent Skills。

4.4 Claude.ai

Claude.ai 支持預構(gòu)建的 Agent Skills 和自定義 Skills。

預構(gòu)建的 Agent Skills：這些 Skills 在你創(chuàng)建文檔時已在后臺工作。Claude 使用它們而不需要任何設置。

自定義 Skills：通過設置 > 功能將你自己的 Skills 作為 zip 文件上傳。在啟用代碼執(zhí)行的 Pro、Max、Team 和 Enterprise 計劃上可用。自定義 Skills 對每個用戶是個人的；它們不在組織范圍內(nèi)共享，管理員無法集中管理。

要了解更多關(guān)于在 Claude.ai 中使用 Skills 的信息，請參閱 Claude 幫助中心中的以下資源：

• 什么是 Skills？

• 在 Claude 中使用 Skills

• 如何創(chuàng)建自定義 Skills

• 使用 Skills 教 Claude 你的工作方式

每個 Skill 都需要一個帶有 YAML 前置數(shù)據(jù)的SKILL.md文件：

---
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 個字符

• 只能包含小寫字母、數(shù)字和連字符

• 不能包含 XML 標簽

• 不能包含保留字：「anthropic」、「claude」

description：

• 必須非空

• 最多 1024 個字符

• 不能包含 XML 標簽

description應包括 Skill 的功能以及 Claude 何時應使用它。有關(guān)完整的創(chuàng)作指導，請參閱最佳實踐。

6 安全考慮

我們強烈建議僅從受信任的來源使用 Skills：你自己創(chuàng)建的或從 Anthropic 獲得的。Skills 通過指令和代碼為 Claude 提供新功能，雖然這使它們功能強大，但也意味著惡意 Skill 可以指導 Claude 以與 Skill 聲稱的目的不匹配的方式調(diào)用工具或執(zhí)行代碼。

如果你必須使用來自不受信任或未知來源的 Skill，請格外謹慎并在使用前徹底審計它。根據(jù) Claude 在執(zhí)行 Skill 時擁有的訪問權(quán)限，惡意 Skills 可能導致數(shù)據(jù)泄露、未授權(quán)系統(tǒng)訪問或其他安全風險。

關(guān)鍵安全考慮：

• 徹底審計：查看 Skill 中捆綁的所有文件：SKILL.md、腳本、圖像和其他資源。尋找異常模式，如意外的網(wǎng)絡調(diào)用、文件訪問模式或與 Skill 聲稱的目的不匹配的操作

• 外部來源有風險：從外部 URL 獲取數(shù)據(jù)的 Skills 特別有風險，因為獲取的內(nèi)容可能包含惡意指令。即使是可信的 Skills 如果其外部依賴項隨時間變化也可能被破壞

• 工具濫用：惡意 Skills 可以以有害方式調(diào)用工具（文件操作、bash 命令、代碼執(zhí)行）

• 數(shù)據(jù)泄露：具有敏感數(shù)據(jù)訪問權(quán)限的 Skills 可能被設計為向外部系統(tǒng)泄露信息

• 像安裝軟件一樣對待：僅從受信任的來源使用 Skills。在將 Skills 集成到具有敏感數(shù)據(jù)或關(guān)鍵操作訪問權(quán)限的生產(chǎn)系統(tǒng)時要特別小心

以下預構(gòu)建的 Agent Skills 可立即使用：

• **PowerPoint (pptx)**：創(chuàng)建演示文稿、編輯幻燈片、分析演示文稿內(nèi)容

• **Excel (xlsx)**：創(chuàng)建電子表格、分析數(shù)據(jù)、生成帶圖表的報告

• **Word (docx)**：創(chuàng)建文檔、編輯內(nèi)容、格式化文本

• **PDF (pdf)**：生成格式化的 PDF 文檔和報告

這些 Skills 在 Claude API 和 claude.ai 上可用。請參閱快速入門教程開始在 API 中使用它們。

自定義 Skills 示例

有關(guān)自定義 Skills 的完整示例，請參閱 Skills 食譜。

8 限制和約束

了解這些限制有助于你有效規(guī)劃 Skills 部署。

跨平臺可用性

自定義 Skills 不會跨平臺同步。上傳到一個平臺的 Skills 不會自動在其他平臺上可用：

• 上傳到 Claude.ai 的 Skills 必須單獨上傳到 API

• 通過 API 上傳的 Skills 在 Claude.ai 上不可用

• Claude Code Skills 基于文件系統(tǒng)，與 Claude.ai 和 API 分離

你需要為要使用 Skills 的每個平臺單獨管理和上傳 Skills。

共享范圍

Skills 根據(jù)使用位置有不同的共享模型：

• Claude.ai：僅限個人用戶；每個團隊成員必須單獨上傳

• Claude API：工作區(qū)范圍；所有工作區(qū)成員可以訪問上傳的 Skills

• Claude Code：個人（~/.claude/skills/）或基于項目（.claude/skills/）

Claude.ai 目前不支持自定義 Skills 的集中管理員管理或組織范圍分發(fā)。

運行時環(huán)境約束

Skills 在代碼執(zhí)行容器中運行，具有以下限制：

• 無網(wǎng)絡訪問：Skills 無法進行外部 API 調(diào)用或訪問互聯(lián)網(wǎng)

• 無運行時包安裝：僅預安裝的包可用。你無法在執(zhí)行期間安裝新包。

• 僅預配置的依賴項：檢查代碼執(zhí)行工具文檔了解可用包的列表

規(guī)劃你的 Skills 在這些約束范圍內(nèi)工作。

編程嚴選網(wǎng)：http://www.javaedge.cn/ 專注分享AI時代下軟件開發(fā)全場景最新最佳實踐~