Claude 技能手册

技能(Skill)就像为 Claude 提供了一套工具和一些肌肉记忆。它们将它从一个喋喋不休的助手转变为一个能够真正做事的实践者。

Claude 技能手册

Anthropic 在 GitHub 上悄悄发布了 Claude 技能手册。起初,我以为这只是一份枯燥的 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??

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