用途
Claude Cookbooks 技能用于在开发过程中提供 Claude AI 的代码示例、教程和最佳实践，资料来源于 Anthropic 官方 cookbooks 仓库。当需要学习 Claude API 用法、实现 Claude 集成、构建 Claude 应用、使用工具调用与函数调用、实现多模态功能（视觉、图像分析）、搭建 RAG（检索增强生成）、集成第三方服务、构建 AI 智能体或优化 Claude 提示词时，可以触发该技能。
主要能力
技能覆盖以下核心能力：
- 分类（Classification）：文本分类、情感分析、内容归类、多标签分类。
- 检索增强生成（RAG）：向量数据库集成、语义搜索、上下文检索、知识库查询。
- 摘要（Summarization）：文档摘要、会议记录、文章压缩、多文档综合。
- 文本转 SQL（Text-to-SQL）：自然语言转 SQL 查询、数据库模式理解、查询优化、结果解读。
- 工具调用与函数调用（Tool Use & Function Calling）：工具定义与 schema、参数校验、多工具工作流、错误处理。
- 多模态（Multimodal）：图像分析与 OCR、图表解读、视觉问答、图像生成集成。
- 高级模式（Advanced Patterns）：智能体架构、子智能体委派、提示词优化、基于缓存的成本优化。
使用方式
技能提供快速参考代码片段，涵盖基础 API 用法、工具调用、视觉分析和提示缓存等。例如基础 API 调用使用 anthropic 客户端创建消息；工具调用通过定义 tools 数组并传入 messages.create；视觉分析通过 content 数组传入 base64 图像和文本；提示缓存通过 system 字段的 cache_control 实现。
仓库结构按以下目录组织：
- capabilities/：核心 AI 能力（分类、RAG、摘要、文本转 SQL）
- tool_use/：函数调用与工具集成示例
- multimodal/：视觉与图像相关示例
- patterns/：智能体与工作流等高级模式
- third_party/：与外部服务集成（Pinecone、LlamaIndex 等）
- claude_agent_sdk/：Agent SDK 示例与模板
- misc/：其他工具（PDF 上传、JSON 模式、评估等）
技能在 references/ 目录中包含完整文档：main_readme.md（仓库概览）、capabilities.md（核心能力文档）、tool_use.md（工具使用与函数调用指南）、multimodal.md（视觉与多模态能力）、third_party.md（第三方集成）、patterns.md（高级模式与智能体）、index.md（完整参考索引）。
适用场景
常见用例包括：
- 构建客服智能体：定义 CRM 访问、工单创建、知识库搜索等工具，使用工具调用 API 处理函数调用，实现对话记忆并添加回退机制。
- 实现 RAG：为文档创建嵌入，存入向量数据库（如 Pinecone），查询时检索相关上下文，用上下文增强 Claude 响应。
- 使用视觉处理文档：将文档转为图像或 PDF，使用视觉 API 提取内容，结构化提取数据并校验后处理。
- 构建多智能体系统：为不同任务定义专用智能体，实现路由逻辑，使用子智能体委派并汇总结果。
技能包含 50 多个实用示例，如带工具调用的客服聊天机器人、Pinecone 向量数据库 RAG、文档摘要、图像分析与 OCR、图表解读、自然语言转 SQL、内容审核过滤器、自动化评估、多智能体系统、提示缓存优化等。
最佳实践
API 使用方面：根据任务选择合适模型（Sonnet 平衡、Haiku 速度、Opus 复杂任务），实现带指数退避的重试逻辑，优雅处理速率限制，监控 token 用量以优化成本。
提示工程方面：指令具体清晰，必要时提供示例，使用系统提示保持行为一致，需要时用 JSON 模式结构化输出。
工具使用方面：定义清晰具体的工具 schema，校验输入输出，优雅处理错误，工具描述简洁但信息充分。
多模态方面：使用高质量图像（分辨率越高效果越好），明确要提取或分析的内容，遵守大小限制（每张图像 5MB），使用合适图像格式（JPEG、PNG、GIF、WebP）。
性能优化方面：缓存大型系统提示和频繁使用的上下文，监控缓存命中率，平衡缓存与新鲜内容；简单任务使用 Haiku，对重复上下文实现提示缓存，设置合适的 max_tokens，批量处理相似请求；长响应使用流式传输，减少消息历史，优化图像大小，使用合适的超时值。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。所有示例使用官方 Anthropic Python SDK，代码具备错误处理并遵循当前 API 最佳实践。技能来源于官方 Anthropic Claude Cookbooks 仓库（https://github.com/anthropics/claude-cookbooks），仓库克隆与处理时间为 2025-10-29。