Claude Agent SDK技能

该技能教授如何使用Claude Agent SDK构建应用程序,涵盖查询选项、钩子、MCP服务器、多轮对话、流式传输、权限、结构化输出和会话管理等核心功能。

  • by foksa
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 foksa/claude-agent-sdk-skill

使用说明

Claude代理SDK技能

A. Claude代码技能 它教Claude如何使用Claude Agent SDK构建应用程序(@anthropic-ai/claude-agent-sdk 或 open-claude-agent-sdk).

涵盖整个API表面:查询选项、挂钩、MCP服务器、多回合对话、流、权限、结构化输出和会话管理。

安装

克隆或符号链接到项目的 .claude/skills/ 目录:

# Option 1: Clone directly
git clone https://github.com/foksa/claude-agent-sdk-skill.git .claude/skills/claude-agent-sdk

# Option 2: Add as git submodule
git submodule add https://github.com/foksa/claude-agent-sdk-skill.git .claude/skills/claude-agent-sdk

Claude Code将自动从以下位置发现技能 .claude/skills/claude-agent-sdk/SKILL.md.

结构

SKILL.md                        # Core workflow + quick reference (~100 lines)
references/
├── query-options.md            # All 35+ options with types/defaults
├── hooks.md                    # 15 hook events, matchers, callbacks
├── mcp-servers.md              # stdio/HTTP/SDK servers, tool() helper
└── patterns.md                 # Multi-turn, streaming, sessions, gotchas

该技能使用渐进式披露: SKILL.md 提供基本信息,当需要更深入的细节时,Claude会按需加载参考文件。

覆盖范围

  • 查询选项 --所有具有类型、默认值和示例的配置字段
  • 钩子 --PreToolUse、PostToolUse、停止、通知和其他11个事件
  • MCP服务器 --stdio、HTTP/SSE和进程内SDK服务器 tool() + createSdkMcpServer()
  • 模式 --多转弯 streamInput() 并且是异步的, canUseTool 审批流、Zod的结构化输出、会话恢复/分叉、AbortController、令牌流
  • 陷阱 --空系统提示令牌保存、钩子返回值语义、仅声明性钩子等

许可证

麻省理工学院