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、令牌流
• 陷阱 --空系统提示令牌保存、钩子返回值语义、仅声明性钩子等

许可证

麻省理工学院