mcpField
A
agent-sdk-development

agent-sdk-development

github.com/melodic-softwareAgent 工作流2837 次安装今天更新
代码仓库

关于 agent-sdk-development

面向 TypeScript 和 Python 版 Claude Agent SDK 的文档委派技能。它通过 docs-management 将问题导向官方文档，涵盖安装、会话、工具、权限、输出和部署等主题。

主要功能

  1. 01将查询转交官方文档
  2. 02按 SDK 主题组织关键词
  3. 03涵盖 TypeScript 和 Python SDK
  4. 04提供会话与自定义工具相关指引
  5. 05收录 MCP、插件和托管主题

适用场景

  1. 01查找官方 SDK 安装指引
  2. 02查询会话管理和权限主题
  3. 03规划自定义工具与结构化输出
  4. 04了解 MCP 集成或生产环境托管

MCP 相关

该技能指向 Claude Agent SDK 官方文档中的 MCP 服务集成内容；它本身不提供 MCP 工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/melodic-software/claude-code-plugins --skill agent-sdk-development

安装后在 Claude Code 中输入/agent-sdk-development确认已加载。

附带文件references/testing-and-notes.md

详细介绍

Agent SDK 元技能

🚨 强制要求：先调用 docs-management

停止——在回答任何有关 Claude Agent SDK 的问题之前：

  1. 调用 docs-management 技能
  2. 使用以下关键词查询：Agent SDK、TypeScript SDK、Python SDK、会话、自定义工具、权限或相关主题
  3. 所有回答只能以加载的官方文档为依据

跳过此步骤会导致信息过时或不准确。

验证检查点

回答前，请确认：

  • 我是否调用了 docs-management 技能？
  • 是否加载了官方文档？
  • 我的回答是否完全基于官方文档？

如果有任何一项未勾选，请停止并先调用 docs-management。

概述

Claude Agent SDK（TypeScript 和 Python SDK）的权威信息来源。此技能完全委托给 docs-management，其中不包含任何重复的官方文档。

**架构：**通过关键词注册表进行纯委托。所有官方文档均通过 docs-management 技能查询获取。

参考资料加载指南

此技能采用纯委托架构，分为三个加载层：

第 1 层：始终处于上下文中
  • SKILL.md（此文件）——关键词注册表、决策树和委托模式
第 2 层：通过 docs-management 按需加载

所有官方 Agent SDK 文档均通过 docs-management 查询获取：

doc_id主题
platform-claude-com-docs-en-agent-sdk-overviewSDK 概述和入门
platform-claude-com-docs-en-agent-sdk-typescriptTypeScript SDK API 参考
platform-claude-com-docs-en-agent-sdk-pythonPython 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-trackingTodo 列表集成
platform-claude-com-docs-en-agent-sdk-structured-outputs结构化输出功能
platform-claude-com-docs-en-agent-sdk-hosting生产环境托管模式
platform-claude-com-docs-en-agent-sdk-mcpMCP 服务集成
platform-claude-com-docs-en-agent-sdk-plugins插件加载
platform-claude-com-docs-en-agent-sdk-subagents子 Agent 用法
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
加载策略

**此技能没有本地参考文件。**所有文档均通过以下关键词注册表中的关键词，使用 docs-management 查询获取。这可确保：

  • 官方文档零重复
  • 始终从规范来源获取最新信息
  • 文档同步零维护开销

何时使用此技能

关键词： Agent SDK、Claude Agent SDK、TypeScript SDK、Python SDK、npm install claude-agent-sdk、pip install claude-agent-sdk、会话、会话恢复、会话分叉、流式模式、单次模式、自定义工具、allowedTools、disallowedTools、permissionMode、系统提示词、appendSystemPrompt、outputStyle、CLAUDE.md、settingSources、成本跟踪、待办事项跟踪、结构化输出、托管、plugins SDK、MCP SDK、Agent 品牌规范

在以下情况下使用此技能：

  • 安装或配置 Claude Agent SDK
  • 设置身份验证（API 密钥、Bedrock、Vertex）
  • 管理会话和恢复会话
  • 在流式和单次输入模式之间进行选择
  • 创建自定义工具
  • 配置权限（allowedTools、disallowedTools）
  • 修改系统提示词
  • 跟踪成本和用量
  • 使用 Agent 中的待办事项列表
  • 获取结构化输出
  • 在生产环境中托管 Agent
  • 将 MCP 与 SDK 集成
  • 了解 SDK 品牌规范要求

用于 docs-management 查询的关键词注册表

查询官方文档时，在 docs-management 技能中使用以下关键词：

SDK 基础知识
主题关键词
概览"Agent SDK", "Claude Agent SDK overview", "why use Agent SDK"
安装"Agent SDK installation", "npm install claude-agent-sdk", "pip install claude-agent-sdk"
SDK 选项"SDK options", "TypeScript SDK", "Python SDK"
迁移"Claude Code SDK migration", "migration guide"
身份验证
主题关键词
API 密钥"Agent SDK authentication", "ANTHROPIC_API_KEY"
Bedrock"CLAUDE_CODE_USE_BEDROCK", "Bedrock SDK"
Vertex"CLAUDE_CODE_USE_VERTEX", "Vertex SDK"
会话
主题关键词
会话管理"session management SDK", "session ID", "getting session ID"
恢复"session resumption", "resume option", "continuing sessions"
分叉"forking sessions", "forkSession", "session branching"
输入模式
主题关键词
概览"streaming vs single mode", "input modes SDK"
流式模式"streaming input mode", "recommended mode"
单次模式"single input mode", "non-streaming"
自定义工具
主题关键词
创建工具"custom tools SDK", "creating custom tools"
工具架构"tool schema", "tool definition SDK"
工具处理程序"tool handlers", "tool execution SDK"
权限
主题关键词
工具权限"allowedTools", "disallowedTools", "tool permissions SDK"
权限模式"permissionMode SDK", "permission strategy"
权限处理"handling permissions SDK", "permission callbacks"
系统提示词
主题关键词
概览"modifying system prompts", "system prompts SDK"
CLAUDE.md"CLAUDE.md SDK", "settingSources", "project instructions"
附加系统提示词"appendSystemPrompt", "custom instructions"
输出风格"outputStyle SDK", "agent persona"
成本与跟踪
主题关键词
成本跟踪"cost tracking SDK", "token usage", "billing SDK"
待办事项跟踪"todo tracking SDK", "todo lists SDK", "task management"
结构化输出
主题关键词
结构化输出"structured outputs SDK", "JSON results", "validated outputs"
架构定义"output schema SDK", "result validation"
托管与部署
主题关键词
托管概览"hosting Agent SDK", "production deployment"
临时会话"ephemeral sessions", "pattern 1 hosting"
持久会话"persistent sessions", "pattern 2 hosting"
插件与 MCP
主题关键词
插件"plugins SDK", "loading plugins", "programmatic plugins"
MCP 集成"MCP SDK", "MCP servers SDK", "extending with MCP"
品牌
主题关键词
品牌指南"agent branding", "Claude Agent naming", "SDK branding"
SDK 功能集成
主题关键词
子 Agent"subagents SDK", "SDK subagents", "subagent integration"
技能"skills SDK", "SDK skills", "agent skills SDK"
API 参考
主题关键词
TypeScript 参考"TypeScript SDK reference", "TypeScript API"
Python 参考"Python SDK reference", "Python API"
更新日志"SDK changelog", "SDK updates"

快速决策树

你想做什么？

  1. 安装 SDK -> 查询 docs-management："Agent SDK installation"
  2. 设置身份验证 -> 查询 docs-management："Agent SDK authentication"
  3. 管理会话 -> 查询 docs-management："session management SDK", "resume option"
  4. 分叉会话 -> 查询 docs-management："forking sessions", "forkSession"
  5. 选择输入模式 -> 查询 docs-management："streaming vs single mode"
  6. 创建自定义工具 -> 查询 docs-management："custom tools SDK"
  7. 配置权限 -> 查询 docs-management："allowedTools", "permissionMode SDK"
  8. 修改系统提示词 -> 查询 docs-management："modifying system prompts"
  9. 使用 CLAUDE.md 文件 -> 查询 docs-management："CLAUDE.md SDK", "settingSources"
  10. 跟踪成本 -> 查询 docs-management："cost tracking SDK"
  11. 添加待办事项跟踪 -> 查询 docs-management："todo tracking SDK"
  12. 获取结构化输出 -> 查询 docs-management："structured outputs SDK"
  13. 在生产环境中托管 -> 查询 docs-management："hosting Agent SDK"
  14. 使用子 Agent -> 查询 docs-management："subagents SDK"
  15. 集成技能 -> 查询 docs-management："skills SDK", "agent skills SDK"
  16. 添加技能（命令） -> 查询 docs-management："skills SDK", "SDK commands"
  17. 加载插件 -> 查询 docs-management："plugins 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）
  • 第三方提供商配置
会话管理功能
  • 自动创建会话
  • 从 init 消息中获取会话 ID
  • 使用 resume 选项恢复会话
  • 分叉会话（forkSession/fork_session）
  • 用于实验的会话分支
  • 跨会话保留上下文
输入模式配置
  • 流式输入模式（推荐）
  • 单次输入模式
  • 模式选择标准
  • 性能注意事项
自定义工具开发
  • 工具架构定义
  • 工具处理程序实现
  • 使用 SDK 注册工具
  • 工具执行模式
权限配置
  • allowedTools 列表
  • disallowedTools 列表
  • permissionMode 设置
  • 权限回调和处理
系统提示词自定义
  • 加载 CLAUDE.md 文件（settingSources）
  • appendSystemPrompt 选项
  • 用于 Agent 人设的 outputStyle
  • 项目级与用户级指令
成本和用量跟踪
  • 令牌用量监控
  • 计费集成模式
  • 用量报告
  • 成本估算
待办事项列表集成
  • 待办事项跟踪 API
  • 任务显示和管理
  • 进度监控
  • 待办事项状态持久化
结构化输出功能
  • 输出架构定义
  • JSON 结果验证
  • 类型安全的结果
  • TODO 跟踪 Agent 示例
托管模式
  • 临时会话模式
  • 持久会话模式
  • 生产部署策略
  • 扩展注意事项
完整的 Claude Code 功能
  • 子 Agent（./.claude/agents/）
  • Agent 技能（./.claude/skills/）
  • Hooks（./.claude/settings.json）
  • 插件（以编程方式加载）
  • 记忆（CLAUDE.md 文件）
品牌要求
  • 允许使用的名称（Claude Agent、Claude）
  • 不允许使用的名称（Claude Code）
  • 产品品牌指南

委派模式

标准查询模式
User asks: "How do I create a custom tool in the Agent SDK?"

1. Invoke docs-management skill
2. Use keywords: "custom tools SDK", "creating custom tools"
3. Load official documentation
4. Provide guidance based EXCLUSIVELY on official docs
多主题查询模式
User asks: "I want to build an agent with sessions, custom tools, and cost tracking"

1. Invoke docs-management skill with multiple queries:
   - "session management SDK", "session resumption"
   - "custom tools SDK", "creating custom tools"
   - "cost tracking SDK", "token usage"
2. Synthesize guidance from official documentation
故障排除模式
User reports: "My session resumption isn't working"

1. Invoke docs-management skill
2. Use keywords: "session management SDK", "resume option", "session ID"
3. Check official docs for session patterns
4. Guide user through proper session handling

故障排除快速参考

问题docs-management 的关键词
身份验证失败"Agent SDK authentication", "ANTHROPIC_API_KEY"
会话无法恢复"session resumption", "resume option"
自定义工具无法使用"custom tools SDK", "tool handlers"
权限阻止操作"allowedTools", "permissionMode SDK"
系统提示词未加载"CLAUDE.md SDK", "settingSources"
成本跟踪问题"cost tracking SDK", "token usage"
结构化输出无效"structured outputs SDK", "schema definition"
流式传输无法使用"streaming input mode", "streaming vs single"

相关技能

与 agent-sdk-development 配合良好的技能：

  • docs-management - 主要委派目标；提供所有官方 Agent SDK 文档
  • mcp-integration - MCP 服务配置；Agent SDK 可以与 MCP 服务集成
  • settings-management - 设置配置；SDK 遵循 Claude Code 设置
  • hook-management - Hook 配置；SDK 支持通过编程方式加载 Hook
  • current-date - 获取当前 UTC 日期，用于版本历史记录和审计时间戳

委派示例：

When working with Agent SDK + MCP integration:
1. Use agent-sdk-development for SDK-specific guidance
2. Use mcp-integration for MCP server configuration
3. Both skills delegate to docs-management for official documentation

其他资源

有关测试场景、多模型测试说明、特定代码库的指南和外部参考资料，请参阅：

版本历史

  • v1.1.0 (2025-11-27)：全面审计和增强

    • 添加参考文档加载指南，其中包含所有 17 篇官方 Agent SDK 文档的明确 doc_id 表
    • 添加测试场景部分，介绍 5 种常见用例场景
    • 添加相关技能部分，记录技能组合模式
    • 添加多模型测试说明部分
    • 增强最后验证部分，加入 Type B 审计元数据
    • 验证关键词注册表涵盖所有官方 SDK 文档

  • v1.0.0 (2025-11-26)：首次发布

    • 纯委派架构
    • 全面的关键词注册表
    • 快速决策树
    • 涵盖所有 Agent SDK 功能的主题
    • 故障排除快速参考

最后更新

日期： 2025-11-28 模型： claude-opus-4-5-20251101

评论

支持 Markdown