用途:本技能是一份用 TypeScript 构建生产级 Claude Agent SDK 智能体的综合指南,适用于业务自动化、工作流编排与 AI 驱动运营等场景,围绕 @anthropic-ai/claude-agent-sdk npm 包展开。
主要能力:覆盖 SDK API 参考(安装配置、query() 与 V2 API、tool() 与 createSdkMcpServer()、配置项、消息类型、错误处理、上下文管理与云服务商);自定义工具开发(单一职责设计、数据检索/API 网关/文件处理/状态管理等模式、可恢复与致命错误区分、Zod 类型安全、缓存与批处理、安全与测试);测试与评估(单元、集成、评估集三层策略,成功率、语义相似度、延迟、token 用量等指标,黄金数据集回归与 CI/CD 持续评估);生产监控(性能、token、质量指标,可观测性封装、结构化日志、分布式追踪、告警阈值与仪表盘);多智能体编排(顺序、管理者-工作者、并行、分层、反思等策略与状态管理);以及业务受理、代码审查、数据分析、API 集成、多智能体系统等真实示例。
使用方式:安装依赖 npm install @anthropic-ai/claude-agent-sdk zod 与 npm install --save-dev typescript @types/node;用 query() 传入 prompt 与 options(如 allowedTools、permissionMode)并遍历返回消息;用 tool() 与 createSdkMcpServer() 定义自定义工具,通过 mcpServers 与 allowedTools 挂载;可复制 assets/agent-template/ 模板后执行 npm install、npm start、npm test。
适用场景与限制:适合需要生产级可靠性、可观测性与多智能体协作的 TypeScript 项目。文档提示使用 MCP 时 prompt 需为异步生成器,否则自定义工具可能不被调用;高 token 成本、执行缓慢、结果不一致等问题需通过更明确的系统提示、工具输出控制、缓存与评估集来缓解。具体收费、价格与平台支持情况暂未提供。