名称: 代理SDK开发 描述: Claude代理SDK（TypeScript和Python SDK）的中枢权威。涵盖SDK安装、认证（Anthropic密钥、Bedrock、Vertex）、会话和恢复、分支会话、流式与单次模式、自定义工具、权限（allowedTools、disallowedTools、permissionMode）、MCP集成、系统提示（CLAUDE.md、appendSystemPrompt、outputStyle）、成本跟踪、待办事项跟踪、结构化输出、托管模式、插件和SDK品牌指南。协助构建自定义代理、配置SDK选项和故障排除。100%委托给文档管理技能获取官方文档。 用户可调用: false 允许工具: 读取、全局搜索、文本搜索、技能
代理SDK元技能
🚨 强制要求：首先调用文档管理技能
停止 - 在提供任何关于Claude代理SDK的响应之前：
- 调用
docs-management技能- 查询 使用关键词：代理SDK、TypeScript SDK、Python SDK、会话、自定义工具、权限或相关主题
- 基础 所有响应完全基于加载的官方文档
跳过此步骤将导致过时或错误的信息。
验证检查点
在响应之前，验证：
- [ ] 我是否调用了文档管理技能？
- [ ] 官方文档是否已加载？
- [ ] 我的响应是否完全基于官方文档？
如果任何复选框未勾选，停止并首先调用文档管理。
概述
Claude代理SDK（TypeScript和Python SDK）的中枢权威。此技能使用100%委托给文档管理——不包含任何重复的官方文档。
架构： 纯委托架构，带关键词注册表。所有官方文档通过文档管理技能查询访问。
参考加载指南
此技能遵循纯委托架构，有三个加载层：
层1：始终在上下文中
- SKILL.md（此文件）- 关键词注册表、决策树、委托模式
层2：按需通过文档管理
所有官方代理SDK文档通过文档管理查询访问：
| 文档ID | 主题 |
|---|---|
| platform-claude-com-docs-en-agent-sdk-overview | SDK概述和入门 |
| platform-claude-com-docs-en-agent-sdk-typescript | TypeScript SDK API参考 |
| platform-claude-com-docs-en-agent-sdk-python | Python SDK API参考 |
| platform-claude-com-docs-en-agent-sdk-sessions | 会话管理和恢复 |
| platform-claude-com-docs-en-agent-sdk-streaming-vs-single-mode | 输入模式选择 |
| platform-claude-com-docs-en-agent-sdk-custom-tools | 创建自定义工具 |
| platform-claude-com-docs-en-agent-sdk-permissions | 权限配置 |
| platform-claude-com-docs-en-agent-sdk-modifying-system-prompts | 系统提示自定义 |
| platform-claude-com-docs-en-agent-sdk-cost-tracking | 成本和使用跟踪 |
| platform-claude-com-docs-en-agent-sdk-todo-tracking | 待办事项列表集成 |
| platform-claude-com-docs-en-agent-sdk-structured-outputs | 结构化输出功能 |
| platform-claude-com-docs-en-agent-sdk-hosting | 生产托管模式 |
| platform-claude-com-docs-en-agent-sdk-mcp | MCP服务器集成 |
| platform-claude-com-docs-en-agent-sdk-plugins | 插件加载 |
| platform-claude-com-docs-en-agent-sdk-subagents | 子代理使用 |
| platform-claude-com-docs-en-agent-sdk-skills | 技能集成 |
| platform-claude-com-docs-en-agent-sdk-slash-commands | 斜杠命令使用 |
层3：外部资源（GitHub）
- TypeScript SDK: anthropics/claude-agent-sdk-typescript
- Python SDK: anthropics/claude-agent-sdk-python
加载策略
此技能没有本地参考文件。 所有文档通过文档管理查询使用关键词注册表访问。这确保：
- 无官方文档重复
- 始终从规范来源获取最新信息
- 文档同步零维护开销
何时使用此技能
关键词： 代理SDK、Claude代理SDK、TypeScript SDK、Python SDK、npm install claude-agent-sdk、pip install claude-agent-sdk、会话、会话恢复、分支会话、流式模式、单次模式、自定义工具、allowedTools、disallowedTools、permissionMode、系统提示、appendSystemPrompt、outputStyle、CLAUDE.md、settingSources、成本跟踪、待办事项跟踪、结构化输出、托管、插件SDK、MCP SDK、代理品牌
使用此技能当：
- 安装或配置Claude代理SDK
- 设置认证（API密钥、Bedrock、Vertex）
- 管理会话和恢复
- 选择流式和单次输入模式
- 创建自定义工具
- 配置权限（allowedTools、disallowedTools）
- 修改系统提示
- 跟踪成本和使用
- 在代理中使用待办事项列表
- 获取结构化输出
- 在生产中托管代理
- 集成MCP与SDK
- 理解SDK品牌要求
文档管理查询关键词注册表
使用这些关键词查询文档管理技能以获取官方文档：
SDK基础
| 主题 | 关键词 |
|---|---|
| 概述 | “代理SDK”、“Claude代理SDK概述”、“为什么使用代理SDK” |
| 安装 | “代理SDK安装”、“npm install claude-agent-sdk”、“pip install claude-agent-sdk” |
| SDK选项 | “SDK选项”、“TypeScript SDK”、“Python SDK” |
| 迁移 | “Claude Code SDK迁移”、“迁移指南” |
认证
| 主题 | 关键词 |
|---|---|
| API密钥 | “代理SDK认证”、“ANTHROPIC_API_KEY” |
| Bedrock | “CLAUDE_CODE_USE_BEDROCK”、“Bedrock SDK” |
| Vertex | “CLAUDE_CODE_USE_VERTEX”、“Vertex SDK” |
会话
| 主题 | 关键词 |
|---|---|
| 会话管理 | “会话管理SDK”、“会话ID”、“获取会话ID” |
| 恢复 | “会话恢复”、“恢复选项”、“继续会话” |
| 分支 | “分支会话”、“forkSession”、“会话分支” |
输入模式
| 主题 | 关键词 |
|---|---|
| 概述 | “流式vs单次模式”、“输入模式SDK” |
| 流式模式 | “流式输入模式”、“推荐模式” |
| 单次模式 | “单次输入模式”、“非流式” |
自定义工具
| 主题 | 关键词 |
|---|---|
| 创建工具 | “自定义工具SDK”、“创建自定义工具” |
| 工具模式 | “工具模式”、“工具定义SDK” |
| 工具处理程序 | “工具处理程序”、“工具执行SDK” |
权限
| 主题 | 关键词 |
|---|---|
| 工具权限 | “allowedTools”、“disallowedTools”、“工具权限SDK” |
| 权限模式 | “permissionMode SDK”、“权限策略” |
| 处理权限 | “处理权限SDK”、“权限回调” |
系统提示
| 主题 | 关键词 |
|---|---|
| 概述 | “修改系统提示”、“系统提示SDK” |
| CLAUDE.md | “CLAUDE.md SDK”、“settingSources”、“项目指令” |
| 附加系统提示 | “appendSystemPrompt”、“自定义指令” |
| 输出风格 | “outputStyle SDK”、“代理角色” |
成本和跟踪
| 主题 | 关键词 |
|---|---|
| 成本跟踪 | “成本跟踪SDK”、“令牌使用”、“计费SDK” |
| 待办事项跟踪 | “待办事项跟踪SDK”、“待办事项列表SDK”、“任务管理” |
结构化输出
| 主题 | 关键词 |
|---|---|
| 结构化输出 | “结构化输出SDK”、“JSON结果”、“验证输出” |
| 模式定义 | “输出模式SDK”、“结果验证” |
托管和部署
| 主题 | 关键词 |
|---|---|
| 托管概述 | “托管代理SDK”、“生产部署” |
| 临时会话 | “临时会话”、“模式1托管” |
| 持久会话 | “持久会话”、“模式2托管” |
插件和MCP
| 主题 | 关键词 |
|---|---|
| 插件 | “插件SDK”、“加载插件”、“程序化插件” |
| MCP集成 | “MCP SDK”、“MCP服务器SDK”、“使用MCP扩展” |
品牌
| 主题 | 关键词 |
|---|---|
| 品牌指南 | “代理品牌”、“Claude代理命名”、“SDK品牌” |
SDK功能集成
| 主题 | 关键词 |
|---|---|
| 子代理 | “子代理SDK”、“SDK子代理”、“子代理集成” |
| 技能 | “技能SDK”、“SDK技能”、“代理技能SDK” |
API参考
| 主题 | 关键词 |
|---|---|
| TypeScript参考 | “TypeScript SDK参考”、“TypeScript API” |
| Python参考 | “Python SDK参考”、“Python API” |
| 变更日志 | “SDK变更日志”、“SDK更新” |
快速决策树
你想做什么？
- 安装SDK -> 查询文档管理：“代理SDK安装”
- 设置认证 -> 查询文档管理：“代理SDK认证”
- 管理会话 -> 查询文档管理：“会话管理SDK”、“恢复选项”
- 分支会话 -> 查询文档管理：“分支会话”、“forkSession”
- 选择输入模式 -> 查询文档管理：“流式vs单次模式”
- 创建自定义工具 -> 查询文档管理：“自定义工具SDK”
- 配置权限 -> 查询文档管理：“allowedTools”、“permissionMode SDK”
- 修改系统提示 -> 查询文档管理：“修改系统提示”
- 使用CLAUDE.md文件 -> 查询文档管理：“CLAUDE.md SDK”、“settingSources”
- 跟踪成本 -> 查询文档管理：“成本跟踪SDK”
- 添加待办事项跟踪 -> 查询文档管理：“待办事项跟踪SDK”
- 获取结构化输出 -> 查询文档管理：“结构化输出SDK”
- 在生产中托管 -> 查询文档管理：“托管代理SDK”
- 使用子代理 -> 查询文档管理：“子代理SDK”
- 集成技能 -> 查询文档管理：“技能SDK”、“代理技能SDK”
- 添加技能（命令） -> 查询文档管理：“技能SDK”、“SDK命令”
- 加载插件 -> 查询文档管理：“插件SDK”
主题覆盖
SDK安装和设置
- npm包: @anthropic-ai/claude-agent-sdk
- pip包: claude-agent-sdk
- TypeScript和Python SDK选项
- 从Claude Code SDK迁移
认证方法
- ANTHROPIC_API_KEY环境变量
- Amazon Bedrock集成（CLAUDE_CODE_USE_BEDROCK）
- Google Vertex AI集成（CLAUDE_CODE_USE_VERTEX）
- 第三方提供商配置
会话管理功能
- 自动会话创建
- 从初始消息捕获会话ID
- 会话恢复带恢复选项
- 分支会话（forkSession/fork_session）
- 实验性会话分支
- 跨会话上下文保存
输入模式配置
- 流式输入模式（推荐）
- 单次输入模式
- 模式选择标准
- 性能考虑
自定义工具开发
- 工具模式定义
- 工具处理程序实现
- 工具注册与SDK
- 工具执行模式
权限配置
- allowedTools列表
- disallowedTools列表
- permissionMode设置
- 权限回调和处理
系统提示自定义
- CLAUDE.md文件加载（settingSources）
- appendSystemPrompt选项
- outputStyle用于代理角色
- 项目级vs用户级指令
成本和使用跟踪
- 令牌使用监控
- 计费集成模式
- 使用报告
- 成本估算
待办事项列表集成
- 待办事项跟踪API
- 任务显示和管理
- 进度监控
- 待办事项状态持久化
结构化输出功能
- 输出模式定义
- JSON结果验证
- 类型安全结果
- 待办事项跟踪代理示例
托管模式
- 临时会话模式
- 持久会话模式
- 生产部署策略
- 扩展考虑
完整Claude Code功能
- 子代理（./.claude/agents/）
- 代理技能（./.claude/skills/）
- 钩子（./.claude/settings.json）
- 插件（程序化加载）
- 记忆（CLAUDE.md文件）
品牌要求
- 允许命名（Claude代理、Claude）
- 不允许命名（Claude Code）
- 产品品牌指南
委托模式
标准查询模式
用户问："如何在代理SDK中创建自定义工具？"
1. 调用文档管理技能
2. 使用关键词："自定义工具SDK"、"创建自定义工具"
3. 加载官方文档
4. 基于官方文档提供指导
多主题查询模式
用户问："我想构建一个带会话、自定义工具和成本跟踪的代理"
1. 调用文档管理技能带多个查询：
- "会话管理SDK"、"会话恢复"
- "自定义工具SDK"、"创建自定义工具"
- "成本跟踪SDK"、"令牌使用"
2. 从官方文档合成指导
故障排除模式
用户报告："我的会话恢复不工作"
1. 调用文档管理技能
2. 使用关键词："会话管理SDK"、"恢复选项"、"会话ID"
3. 检查官方文档中的会话模式
4. 指导用户进行正确的会话处理
故障排除快速参考
| 问题 | 文档管理关键词 |
|---|---|
| 认证失败 | “代理SDK认证”、“ANTHROPIC_API_KEY” |
| 会话未恢复 | “会话恢复”、“恢复选项” |
| 自定义工具不工作 | “自定义工具SDK”、“工具处理程序” |
| 权限阻止 | “allowedTools”、“permissionMode SDK” |
| 系统提示未加载 | “CLAUDE.md SDK”、“settingSources” |
| 成本跟踪问题 | “成本跟踪SDK”、“令牌使用” |
| 结构化输出无效 | “结构化输出SDK”、“模式定义” |
| 流式不工作 | “流式输入模式”、“流式vs单次” |
相关技能
与代理SDK开发配合良好的技能：
- 文档管理 - 主要委托目标；提供所有官方代理SDK文档
- MCP集成 - MCP服务器配置；代理SDK可以与MCP服务器集成
- 设置管理 - 设置配置；SDK尊重Claude Code设置
- 钩子管理 - 钩子配置；SDK支持通过程序化加载钩子
- 当前日期 - 获取当前UTC日期用于版本历史和审计时间戳
委托示例：
当使用代理SDK + MCP集成时：
1. 使用代理SDK开发进行SDK特定指导
2. 使用MCP集成进行MCP服务器配置
3. 两者都委托给文档管理以获取官方文档
额外资源
对于测试场景、多模型测试笔记、仓库特定指导和外部参考，见：
- references/testing-and-notes.md - 测试场景、多模型测试、仓库笔记、外部链接
版本历史
-
v1.1.0 (2025-11-27): 全面审核和增强
- 添加参考加载指南，包含所有17个官方代理SDK文档的显式文档ID表
- 添加测试场景部分，带5个常见用例场景
- 添加相关技能部分，记录技能组合模式
- 添加多模型测试笔记部分
- 增强最后验证部分，带类型B审核元数据
- 验证关键词注册表覆盖所有官方SDK文档
-
v1.0.0 (2025-11-26): 初始发布
- 纯委托架构
- 全面关键词注册表
- 快速决策树
- 所有代理SDK功能的主题覆盖
- 故障排除快速参考
最后更新
日期： 2025-11-28 模型： claude-opus-4-5-20251101