logo
37

Claude Skill Codebook 简明教程

⏱️ 12分钟

Claude Skill Codebook 简明教程

image

Anthropic 在 GitHub 上发布了 Claude Skill Codebook（技能手册）。这不是一份枯燥的 API 文档，而是一套「可落地的技能工作流」：让 Claude 真正能生成文件、跑代码、做报表，把“会说”变成“会做”。

1、技能（Skill）到底是什么？

把 Skill 理解成「Claude 的微型工具包」：

  • 指令：告诉 Claude 该做什么、输出什么。
  • 代码：让它能实际执行（如生成文件）。
  • 资源：模板、数据集、品牌素材等（可选）。

它的关键不是“多学点知识”，而是变成一个能走完整流程的执行者。

2、技能手册内容结构

Codebook 分成三个笔记本（Notebooks）：

  • 技能简介：从 0 到 1 生成 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

3、快速开始（实际跑起来）

准备：

  • Python 3.8+
  • Anthropic API Key
  • 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

打开 01_skills_introduction.ipynb 即可跑第一个样例。

4、技能是如何被“激活”的？

关键是 beta header + container + tool：

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"
    }
)

然后在请求里声明使用技能：

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 budget file"}]
)

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"
    }]
)
file_id = extract_file_id(response)
file_content = client.beta.files.download(file_id=file_id)
with open("outputs/budget.xlsx", "wb") as f:
    f.write(file_content.read())

Claude 会直接返回文件，基本无需你再写 Pandas 或 OpenPyXL。

6、自定义技能（才是真正的杀手锏）

最小结构：

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

SKILL.md 里重点写清楚：

  • 输入格式（CSV/JSON/Markdown）
  • 输出类型（Excel/PDF/PPT）
  • 核心逻辑（计算、排版、模板规则）

这让 Claude 在下次使用时自动复用你的流程。

7、实战技巧（踩坑少一半）

  • 按需加载：Skills 不要一次全开，避免 token 烧太快。
  • 批处理：一次跑多个数据集，省请求次数。
  • 文件整理：默认输出在 outputs/，注意命名和覆盖。
  • 模板优先：复杂排版请用模板 + 规则，稳定性更高。

8、常见问题速查

ProblemWhat It MeansHow I Fixed It
ValueError: ANTHROPIC_API_KEY not found.env 未更新手动填 API Key
Skills feature requires beta headerHeader 缺失检查 anthropic-beta
Request exceeds token limit输入过大拆分任务

9、你可以用 Skills 做什么？

  • 财务月报：CSV → Excel → PDF → PPT
  • 运营周报：数据汇总 + 自动图表
  • 投资分析：组合收益、可视化、批量输出
  • 教学资料：Markdown → 演示稿 + PDF 讲义

这类流程最适合 Skills：输入结构化 + 输出文件化。

10、总结

Skill Codebook 的价值不是“多学一个新 API”，而是建立可复制的自动化产出体系。如果你需要稳定地产出 Excel/PPT/PDF，这套技能体系能显著减少你的手工步骤。

原文链接：Claude 技能手册 - 汇智网

来源：今日头条原文整理

📚 相关资源