claude-agent-sdk-skill：让 Claude 自己学会用 Agent SDK 的完整 API

写 Claude Agent SDK 应用，还在啃官方文档？

Claude Agent SDK 是 Anthropic 官方推出的编程式 Agent 开发工具，支持 TypeScript 和 Python，能让你在代码里直接调用 Claude Code 的 Agent 能力。功能很强大，但 API 表面也不小——光是 query() 的配置选项就 35+ 个，Hooks 事件 15 个，再加 MCP 服务器、Streaming、会话管理……官方文档散落在各处，真要用起来，光找某个选项叫什么、怎么传就得折腾半天。

今天发现一个开源 Skill，帮你把这些问题全解决了。

一个 Skill，完整吃透 SDK

claude-agent-sdk-skill 是一个专门给 Claude Code 用的技能包，作者是 GitHub 用户 foksa。它把 Claude Agent SDK 的整个 API 表面整理成了一套渐进式Disclosure 结构：

• SKILL.md — 核心工作流 + 速查表，100 行左右，Claude 每次加载 Skill 时自动读取
• references/query-options.md — 35+ 个配置选项，含每个字段的类型、默认值和使用示例
• references/hooks.md — 15 个 Hook 事件（PreToolUse、PostToolUse、Stop、Notification 等），含匹配器和回调函数的写法
• references/mcp-servers.md — stdio/HTTP/SDK 服务器接入方式，tool() 和 createSdkMcpServer() 怎么用
• references/patterns.md — 多轮对话、Streaming、会话 fork/恢复、Zod 结构化输出、AbortController 等高级模式的实战代码

用的时候，Claude 会自动从 SKILL.md 加载核心信息，碰到具体问题（比如”这个 Hook 怎么写返回值”）再去对应的 reference 文件里查——不用每次都把整包文档塞进上下文。

覆盖了哪些场景

根据 Skill 描述，它主要覆盖以下几类开发场景：

• Query 选项：所有 query() 配置字段的完整参考，含类型和默认值
• Hooks 系统：PreToolUse、PostToolUse、Stop、Notification 等 15 个事件，以及 matchers 和 callbacks 的写法
• MCP 服务器：stdio 模式、HTTP/SSE 模式、进程内 SDK 服务器三种接入方案
• 高级模式：多轮对话用 streamInput() + AsyncIterable、canUseTool 审批流、Zod 做结构化输出、会话 fork/恢复、AbortController 取消、Token 流式输出
• 避坑指南：空 systemPrompt 能省 Token、Hook 返回值语义、声明式 Hook 的限制条件等

怎么安装

直接在项目里克隆即可：

git clone https://github.com/foksa/claude-agent-sdk-skill.git 
  .claude/skills/claude-agent-sdk

或者加为 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，在涉及 Agent SDK 开发的对话中自动激活。

适合谁用

如果你正在用 TypeScript 或 Python 写基于 Claude Agent SDK 的应用，需要：

• 查某个配置选项怎么传
• 写 Hook 拦截工具调用
• 接入 MCP 服务器
• 实现多轮对话或 Streaming

这个 Skill 值得装上。不用再在官方文档和 SDK 源码之间反复横跳，Claude 自己在对话中就能查。

GitHub 链接：https://github.com/foksa/claude-agent-sdk-skill

GitHub: https://github.com/foksa/claude-agent-sdk-skill