claude-agent-sdk-expert

用途：该技能面向使用 Claude Agent SDK（TypeScript 或 Python）开发 AI 智能体的场景，帮助在代码审查、调试与构建阶段发现常见故障模式，例如工具调用幻觉、上下文丢失、错误被吞掉导致无限重试、输出看似正确但缺乏工具结果支撑等。核心原则是：智能体的质量取决于其工具与指令，SDK 负责循环，开发者负责提供清晰的工具、提示词与边界。\n\n主要能力与工作流程：采用分步流程，第 0 步始终加载，用于扫描最常见的十类智能体错误；其余步骤按需加载对应参考文件。审查模式下可先运行静态分析脚本 bash scripts/scan-agent-patterns.sh <target-directory>，以发现缺少 maxIterations、tool_choice: "any"、静默 catch 块、缺少 additionalProperties: false 等机械性反模式，再进行人工审查。步骤覆盖：智能体循环架构与停止条件、工具设计与作用域、面向智能体的提示词工程、结构化输出与模式设计、上下文管理、MCP 集成、错误处理与可靠性、Hooks 与生命周期（PreToolCall、PostToolCall、StopHook）、多智能体模式。\n\n使用方式：提供审查与构建双模式。审查模式对现有智能体代码输出按严重程度排序的发现（CRITICAL、HIGH、MEDIUM、LOW），每项包含问题、影响、位置与修复前后代码；构建模式按架构决策、实现、检查清单组织输出。要求只报告真实问题、按影响排序、跳过不相关章节（如不使用 MCP 则跳过第 6 步，单智能体则跳过第 9 步）、每个结论都给出具体代码示例、引用真实 SDK API（query()、tool_use、stop_reason、hooks 等），不得杜撰不存在的 API。\n\n记录与会话延续：完成审查或构建后，向 data/review-log.jsonl 追加一行 JSON 记录，字段包含日期、模式、项目名、SDK 语言、发现列表与严重程度计数；会话开始时若该文件存在，则读取并留意过往会话中的重复模式。\n\n适用场景：审查或构建生产级 Claude 智能体、排查工具调用与上下文问题、设计 MCP 集成或多智能体协作架构。限制：资料未提供安装命令、收费与许可信息、支持平台范围，这些内容暂未提供。