> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# Claude 技能手册
- URL: https://www.hubwiz.com/blog/claude-skill-codebook/
- Published: 2025-10-27T01:35:01.000Z
- Updated: 2025-10-27T01:35:22.000Z
- Description: 技能（Skill）就像为 Claude 提供了一套工具和一些肌肉记忆。它们将它从一个喋喋不休的助手转变为一个能够真正做事的实践者。
- Author: admin
- Tags: APPLICATION, #Import 2026-10-14 14:41

Anthropic 在 GitHub 上悄悄发布了[ Claude 技能手册](https://github.com/anthropics/claude-cookbooks.git?ref=hubwiz.com)。起初，我以为这只是一份枯燥的 API 文档。但经过几个小时的钻研，我意识到——这玩意儿实际上改变了 Claude 的运作方式。

简而言之，技能（Skill）就像为 Claude 提供了一套工具和一些肌肉记忆。它们将它从一个喋喋不休的助手转变为一个能够真正做事的实践者——创建电子表格、制作 PowerPoint、分析数据，甚至生成 PDF。没错，你也可以发展自己的技能。

让我告诉你我学到了什么。

## 1、好吧，“技能”到底是什么？

可以将技能想象成一小包指令，告诉 Claude 如何在特定环境下行动。它一部分是代码，一部分是剧本，一部分是氛围。

每个技能通常包含三部分：

- 一些指令（Claude 应该做什么）
- 一些代码（以便它能够实际执行）
- 可选资源（例如模板或数据集）

这样做的目的是赋予 Claude 特定的专业知识——类似于安装一个小插件。例如：

- “xlsx”技能 → 制作 Excel 工作表、图表和数据透视表
- “pptx”技能 → 制作演示文稿
- “pdf”技能 → 格式化并导出 PDF
- “docx”技能 → 编写 Word 文档

你无需一次性加载所有这些技能 — 技能仅在需要时加载。这就是 Anthropic 所说的渐进式披露，它有助于限制模型的令牌使用。

## 2、技能手册内容

技能手册分为三个主要笔记本。每个笔记本分别关注技能工作流程的不同部分。

- 技能简介 — 一个快速演示，介绍如何设置并生成您的第一个 Excel 或 PDF 文件。
- 金融应用 — 如果您喜欢仪表板、投资组合分析或任何数据密集型应用，那么这个技能会很有趣。
- 自定义技能开发 — 您可以在这里学习如何从头开始构建自己的技能。

克隆后的文件夹结构如下：

```
skills/
├── notebooks/
│   ├── 01_skills_introduction.ipynb
│   ├── 02_skills_financial_applications.ipynb
│   └── 03_skills_custom_development.ipynb
├── sample_data/
│   ├── financial_statements.csv
│   ├── portfolio_holdings.json
│   ├── budget_template.csv
│   └── quarterly_metrics.json
```

每个笔记本都会引导您完成特定的工作流程——从创建 Excel 仪表板到生成精美的 PDF 报告。至于示例数据集？它们看起来非常真实。

## 3、设置（其实没那么吓人）

你需要准备以下东西：

- Python 3.8 或更高版本
- Anthropic API 密钥
- Jupyter Notebook 或 JupyterLab

然后在终端中运行以下命令：

```
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks/skills
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# add your ANTHROPIC_API_KEY to .env
jupyter notebook
```

进入 Jupyter 后，打开 01\_skills\_introduction.ipynb 即可。

## 4、深入内部

接下来才是真正有趣的地方。 Claude 不会自动“知道”如何运行代码或下载文件——这就是测试版标头（beta header）的作用。

你实际上需要告知 API 它可以使用 Skills 系统和文件功能。类似如下：

```
from anthropic import Anthropic

client = Anthropic(
    api_key="your-api-key",
    default_headers={
        "anthropic-beta": "code-execution-2025-08-25,files-api-2025-04-14,skills-2025-10-02"
    }
)
```

这些标头解锁：

- 代码执行（以便 Claude 可以安全地运行 Python）
- Files API（以便它可以创建和下载实际文件）
- Skills 框架（新增部分）

一旦这些设置完成，Claude 就变成了一个可以跨文档操作的自动化引擎。

## 5、示例：创建 Excel 文件（仅需一个提示）

这是我运行的一个演示。我只需要一个简单的预算电子表格。

```
from anthropic import Anthropic
client = Anthropic(api_key="your-api-key")

response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "latest"}
        ]
    },
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
    messages=[{
        "role": "user",
        "content": "Create an Excel file with a simple monthly budget spreadsheet"
    }]
)
# extract file_id (you'll have a helper in the notebook)
file_id = extract_file_id(response)
# download it
file_content = client.beta.files.download(file_id=file_id)
with open("outputs/budget.xlsx", "wb") as f:
    f.write(file_content.read())
print("Done. Check outputs/budget.xlsx")
```

无需 Pandas，无需 OpenPyXL，无需公式。Claude 只需输出整个 Excel 文件并返回即可。我在本地运行了它，没错，它是一个真正的电子表格，包含行、总计，甚至还有格式。

## 6、自定义技能：强大功能

这是吸引我注意的部分——你可以教 Claude 你自己的专业工作流程。

假设你希望它每月创建品牌财务报告。你可以将该逻辑打包成一个技能，如下所示：

```
my_skill/
├── SKILL.md
├── scripts/
│   └── processor.py
└── resources/
    └── template.xls
```

在 SKILL.md 中，你需要描述该技能的功能：

- 输入类型（例如，CSV、JSON）
- 输出类型（Excel、PDF 等）
- 要遵循的逻辑（例如，应用公司颜色、计算利润。

下次当你用该技能调用 Claude 时，它​​已经知道该做什么了——无需重复你的所有指令。

这就像是给 Claude 开了一条通往你大脑的捷径。

## 7、我学到的一些实用技巧

- 不要一次性加载所有内容。使用渐进式加载功能，这样 Claude 只会加载它需要的技能。
- 批量任务。你可以让 Claude 在一次运行中处理多个数据集。
- 重复使用容器。创建会话时，重复使用它，而不是每次都从头开始。这样可以节省时间和令牌。
- 保持输出整洁。你生成的所有内容都保存在 outputs/ 文件夹中。如果你重新运行一个单元，它会覆盖文件——这没问题，只是需要注意一下。

## 8、小问题

你可能会在早期遇到一两个小问题。以下是我遇到的问题：

| Problem                                   | What It Means          | How I Fixed It                   |
| ----------------------------------------- | ---------------------- | -------------------------------- |
| ValueError: ANTHROPIC\_API\_KEY not found | Forgot to update .env  | Added my key manually            |
| Skills feature requires beta header       | Missing the new header | Double-checked my API config     |
| Request exceeds token limit               | Prompt too large       | Broke my task into smaller steps |

## 9、为什么这实际上感觉不同

如果您以前使用过 GPT、插件或 RAG 风格的工作流程，那么这感觉就不一样了。Claude 的技能系统更像是为模型提供了记忆和工具包。它理解您的目标，并拥有根据目标采取行动的上下文——无需不断提示。

您可以：

- 在 Excel 中构建仪表板
- 从中自动生成 PowerPoint
- 将摘要导出为品牌 PDF 一次性完成所有操作。

这不仅仅是一个提高效率的技巧——而是 AI 如何逐渐融入实际的业务工作流程。

## 10、结束语

老实说，这个技能系统是聊天机器人和真正的自动化。Claude 终于可以有条理地做事了，而不仅仅是空谈。

如果你想探索这个世界，这本指南是一个很好的起点。它有详尽的文档，示例随时可用——虽然侧重于财务，但易于调整。

如果你是开发人员、分析师或负责每周报表的人员，值得在周末尝试一下。你会忍不住想：“等等，Claude 是不是把我的工作自动化了？”

---

原文链接：[The Claude Skills Cookbook: Anthropic's New Context Engine Outperforms MCP??](https://medium.com/coding-nexus/the-claude-skills-cookbook-anthropics-new-context-engine-outperforms-mcp-92249dae37d3?ref=hubwiz.com)

汇智网翻译整理，转载请标明出处