第九章：基于 Claude Agent SDK 开发技能: 构建实战级研究智能体
第九节课的核心任务，是将前八节课所学的技能和工具进行实战整合。
模拟一个高效的工程团队，构建一个能根据开源工具的文档自动生成学习指南的实战级研究智能体。
50%
50%
🧩 核心架构：指挥官与专家团队 (The Architecture)
这个系统的精髓在于责任分离，我们可以通过一个“企业团队”的类比来直观理解：
#JzyETzQXDwFp text { white-space: pre; }#JzyETzQXDwFp .fb0 { stroke: var(--N900-FG, 0.15); }#JzyETzQXDwFp .fb0 {stroke: rgba(31,35,41, 0.15)}#JzyETzQXDwFp .fx0 { stroke-miterlimit: 10; }#JzyETzQXDwFp .fx0 {stroke-miterlimit: 10}#JzyETzQXDwFp .fa1 { fill: rgb(187, 191, 196); }#JzyETzQXDwFp .fa1 {fill: rgb(187, 191, 196)}#JzyETzQXDwFp .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#JzyETzQXDwFp .fx1 {font-style: normal}#JzyETzQXDwFp .fx2 { text-anchor: middle; }#JzyETzQXDwFp .fx2 {text-anchor: middle}#JzyETzQXDwFp .fx3 { dominant-baseline: central; }#JzyETzQXDwFp .fx3 {dominant-baseline: central}#JzyETzQXDwFp .fx4 { stroke: none; }#JzyETzQXDwFp .fx4 {stroke: none}#JzyETzQXDwFp .fc0 { fill: var(--text-caption); }#JzyETzQXDwFp .fc0 {fill: #646a73}#JzyETzQXDwFp .fa2 { fill: var(--text-link-disabled); }#JzyETzQXDwFp .fa2 {fill: rgb(187, 191, 196)}#JzyETzQXDwFp .fa3 { fill: rgb(222, 224, 227); }#JzyETzQXDwFp .fa3 {fill: rgb(222, 224, 227)}#JzyETzQXDwFp .fa4 { fill: rgb(255, 255, 255); }#JzyETzQXDwFp .fa4 {fill: rgb(255, 255, 255)}#JzyETzQXDwFp .fx5 { font: 700 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#JzyETzQXDwFp .fx5 {font-style: normal}#JzyETzQXDwFp .fx6 { text-anchor: start; }#JzyETzQXDwFp .fx6 {text-anchor: start}#JzyETzQXDwFp .fx7 { dominant-baseline: alphabetic; }#JzyETzQXDwFp .fx7 {dominant-baseline: alphabetic}#JzyETzQXDwFp .fc1 { fill: rgb(0, 0, 0); }#JzyETzQXDwFp .fc1 {fill: rgb(0, 0, 0)}#JzyETzQXDwFp .fx8 { font: 700 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#JzyETzQXDwFp .fx8 {font-style: normal}#JzyETzQXDwFp .fx9 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#JzyETzQXDwFp .fx9 {font-style: normal}#JzyETzQXDwFp .fb1 { fill: var(--N900-FG, 0.15); }#JzyETzQXDwFp .fb1 {fill: rgba(31,35,41, 0.15)}#JzyETzQXDwFp .fb2 { fill: rgba(255, 255, 255, 0.16); }#JzyETzQXDwFp .fb2 {fill: rgba(255, 255, 255, 0.16)}#JzyETzQXDwFp .fb3 { fill: rgba(255, 255, 255, 0.12); }#JzyETzQXDwFp .fb3 {fill: rgba(255, 255, 255, 0.12)}#JzyETzQXDwFp .fa5 { fill: var(--bg-body); }#JzyETzQXDwFp .fa5 {fill: #fff}ABC12345🏢 团队角色⚙️ 代码中的组件📝 本课案例中的职责项目总监 (The Brain)外聘专家 (The Arms)公司SOP (Process)跨部门对接人 (Connectivity)Main Agent + TaskToolAgentDefinition (Sub-agents)SkillToolMCP Server理解你的需求，依据标准流程（Skills） 制定整体研究计划，分解并并行调度“专家”任务，最后将所有成果合成为一份完整的学习指南。系统并行调度了三位专家协作：1. 📚 Docs Researcher (文档研究员)：查找并分析开源工具的官方文档。2. 📁 Repo Analyzer (代码库分析员)：从GitHub下载、分析代码库的结构与关键文件。3. 🌐 Web Researcher (网页研究员)：搜索相关的博客文章、视频和社区内容。本案例中的learning-a-tool技能，就是一本定义了“如何系统性地学习一个新工具”的标准作业程序。它只被 “项目总监” 使用，以指导其按完美的工作流规划和调度任务。充当“对外联络官”。在本案例中，最终通过 Notion MCP，将报告直接、格式规范地输出到云端Notion知识库，完成成果的最终交付。
🤔 Subagents 与 Skills 的分工
•
Subagents (专家)：负责执行“做什么”，团队中的外聘专家，专注于特定任务领域（如爬取文档、分析代码库）并独立完成。
•
Skills (SOP)：负责指导“怎么做”，公司内部沉淀的SOP，抽象为包含工作流与最佳实践的“指导手册”，可被任何专家（Agent）参考或使用。本案例中learning-a-tool技能专门为主Agent提供规划指导。
🛠️ 实战拆解：研究智能体的内部运转
主智能体接到"学习一个开源工具"的指令后，会加载learning-a-tool技能（SOP），将任务分解并并行指派给三位专家：
🌐
内容并行搜集：
•
文档研究员：获取并分析官方文档，总结核心概念与使用方式。
•
代码库分析员：克隆代码库，阅读关键源码模块，理解实现原理。
•
网页研究员：搜索社区资源，收集博客、视频等实践内容。
成果异步合成：待三位专家完成并返回结果后，主智能体根据SOP，将所有信息整合成一份结构化的学习指南。
📦 工程落地：环境、结构与交付
要成功运行此“团队”，需确保工程基础：
•
环境搭建：使用pip install claude-agent-sdk安装SDK，并确保已设置好ANTHROPIC_API_KEY。
•
文件结构：严格遵循SDK规范组织项目文件夹，确保代码能正确加载技能与子智能体定义。
•
成果交付：最终的学习指南不仅能在终端查看，更能通过Notion MCP 直接写入您的云端知识库，完成智能化成果归档，形成从指令输入到报告输出的完整闭环。