Subagents

全面介绍Claude Code Subagents（子代理）系统的核心概念、设计目的与工作原理，涵盖子代理的定义、与主代理的关系、Team协作模型、任务委派机制、子代理生命周期以及子代理在复杂任务并行处理中的战略价值。

全面学习如何创建和管理Claude Code子代理的生命周期，涵盖使用Agent工具创建子代理、子代理的状态（运行中/空闲/已完成/错误）、子代理的生命周期阶段（创建→工作→完成→关闭）、子代理的启动/暂停/停止操作以及子代理的资源清理。

深入解析Claude Code子代理之间的通信机制SendMessage，涵盖SendMessage的语法和参数（to/summary/message）、消息类型（文本消息/JSON协议消息）、子代理间一对一/一对多通信、消息的路由和投递机

全面学习如何使用Task系统分配和协调子代理的工作，涵盖TaskCreate创建任务、TaskList查看所有任务、TaskUpdate更新任务状态和所有者、任务的依赖关系和优先级管理、以及任务队列和调度策略。

全面介绍Claude Code子代理的不同类型和角色分工，涵盖subagent_type参数的作用、各类子代理的特点（Explore/Plan/General-purpose等）、子代理的模型选择（sonnet/opus/haiku）、角色

深入讲解子代理之间的同步和异步通信模式，涵盖同步通信（等待子代理完成后再继续）、异步通信（发送消息后继续其他工作不等待）、消息的队列和投递机制、超时和轮询策略以及不同通信模式的适用场景选择。

深入讲解子代理中最常用的主从协调模式，涵盖主代理（Master）的职责（任务分解/分配/协调/结果汇集）、工作子代理（Worker）的职责（执行/报告）、任务队列和调度管理、Worker故障检测和恢复、以及主从模式的扩展性和适用场景。

学习如何使用子代理协调多服务的并行部署，涵盖部署任务分解（按服务/环境分割）、各服务的构建和部署并行执行、部署依赖管理（服务启动顺序/数据库迁移）、部署状态监控和回滚协调。

全面学习如何配置和管理Claude Code子代理的Team，涵盖TeamCreate创建团队、team_name和description配置、Team配置文件（~/.claude/teams/）的结构、Task目录的管理、团队成员发现（读

全面学习Claude Code子代理的权限管理和安全模型，涵盖子代理的权限模式（auto/acceptEdits/bypassPermissions/plan）、权限的作用范围、不同类型子代理的权限差异、敏感操作的安全管控以及权限策略的最佳

全面学习子代理的worktree隔离模式，让子代理在隔离的Git工作树中独立工作互不干扰，涵盖worktree的创建（EnterWorktree）、worktree的清理（ExitWorktree）、隔离模式下子代理的工作目录、worktr

深入讲解如何利用子代理实现任务的并行执行，涵盖创建多个子代理并行处理、任务分割策略（水平分割/垂直分割）、并行执行的同步与汇集、并行执行的数量限制和资源管理、以及并行性能优化和监控。

全面学习如何监控Claude Code子代理的运行状态和查看日志，涵盖子代理的状态查询（运行中/空闲/已完成）、Output文件查看、TaskOutput获取子代理执行结果、子代理的消息通知和错误报告、以及多子代理的进度跟踪仪表盘。

全面学习如何监控子代理集群和实现可观测性，涵盖日志收集（Output文件/消息记录）、状态监控（TaskList/通知）、性能指标（任务完成时间/成功率）、可视化仪表盘设计、以及告警配置（异常检测/超时告警）。

全面学习子代理之间如何共享数据和传递信息，涵盖通过文件系统共享数据、通过Task系统传递任务结果、使用SendMessage传递结构化数据、共享内存和状态管理、以及数据共享的安全性和冲突解决策略。

全面学习子代理消息的路由和分发策略，涵盖基于名称的精确路由、广播消息（向所有子代理发送）、Topic/Subject路由模式、消息分发的工作窃取（work stealing）机制、以及消息路由的配置和管理。

全面学习如何在子代理之间传递和共享上下文信息，涵盖上下文传递的内容（项目信息/任务目标/约束条件）、通过Task描述传递上下文、通过文件共享项目上下文、子代理上下文的隔离和独立性、以及上下文大小管理和优化。

深入讲解子代理之间的协议消息处理机制，涵盖shutdown_request/shutdown_response关闭协议、plan_approval_request/response审批协议、协议消息的JSON格式定义、协议处理的错误处理和超

深入讲解子代理之间的对等协作模式，涵盖Peer之间直接通信、无中心的协作方式、Peer之间的任务协商和分工、Peer间数据共享和同步、对等模式下的冲突解决和共识机制、以及对等模式与主从模式的对比与选择。

深入讲解如何使用子代理实现工作流编排，涵盖Pipeline模式的阶段划分（输入→处理1→处理2→...→输出）、子代理作为Pipeline中的处理节点、阶段之间的数据传递和转换、Pipeline的并行和条件分支以及完整的Pipeline编排

深入讲解子代理的扇出/扇入并行处理模式，涵盖Fan-out（将一个任务分解为多个并行子任务分配给多个子代理）、Fan-in（将多个子任务的结果汇集整合）、扇出策略（按数据量/按功能/按维度）、结果汇集策略（合并/投票/加权）以及扇出扇入的完

深入讲解子代理的监督树层次化组织模式，涵盖监督树的结构（顶层监督者→中层管理者→底层执行者）、任务的分级委派和监督、错误传播和隔离（子代理错误不影响同级）、监督树模式的扩展性、以及与其他协调模式的组合使用。

全面学习子代理错误传播机制和恢复策略，涵盖错误类型分类（可恢复/不可恢复）、错误传播路径（子→主）、错误隔离（不影响其他子代理）、自动重试和降级策略

全面学习子代理的超时控制机制，涵盖TaskOutput的timeout参数设置、不同任务类型的超时策略（快速/慢速/未知）、超时后的默认行为（终止/重试/降级）、长任务的心跳和进度报告机制

深入讲解子代理的递归嵌套和树状组织结构，涵盖子代理创建子代理的多级层次结构、递归任务分解策略（大任务→子任务→子子任务）、树状结构的优点（模块化/可扩展/错误隔离）、递归深度的控制和管理

全面学习如何管理子代理的上下文窗口（Context Window），避免超出token限制，涵盖上下文窗口的组成（系统提示/对话历史/工具结果）、上下文压缩和摘要技术、上下文分段处理、以及多轮对话中的上下文窗口维护策略。

全面学习子代理如何发现团队中的其他成员并进行注册通信，涵盖通过config.json发现团队成员、读取队友的agentId和agentType、根据角色类型选择合适的通信对象、动态注册新成员到团队、以及团队解散时的成员注销。

深入讲解子代理任务优先级和调度策略，涵盖优先级的定义和分类（P0-P3）、基于优先级的任务队列调度、优先级反转的处理、动态优先级调整、以及结合工作窃取的混合调度策略。

学习如何使用多个子代理并行执行代码审查，大幅提升审查效率，涵盖任务分解策略（按文件/模块/类型分组）、每个子代理的审查职责、审查标准的统一传递、结果汇总和冲突处理、以及审查报告的自动生成。

学习如何使用多个子代理并行执行测试，涵盖测试任务的分割策略（按测试文件/类型/模块分割）、Worker职责（运行测试+分析结果）、测试失败的分析和归因、以及测试报告的自动生成和汇总。

学习如何使用多个子代理组成翻译团队，并行处理多语言翻译任务，涵盖翻译任务分割（按语言/文件/段落分割）、翻译质量控制（校对/一致性检查）、术语管理、以及翻译结果的汇集和格式化。

学习如何使用多个子代理并行执行代码重构，涵盖重构任务的分解（按文件/模块/模式分组）、worktree隔离避免冲突、重构前后一致性检查、以及重构结果验证和合并。

学习如何使用多个子代理并行生成项目文档，涵盖文档任务分解（按模块/文档类型分割）、API文档自动生成、使用教程和示例编写、文档风格一致性检查、以及文档的自动发布和更新。

学习如何使用子代理集群进行大规模数据采集和处理，涵盖数据源分配（每个子代理负责不同数据源）、并行数据抓取和解析、数据清洗和标准化、数据汇总和关联分析以及结果的统一输出。

学习如何使用子代理团队进行分布式知识库查询和信息汇总，涵盖多来源知识搜索（每个子代理搜索不同来源）、信息提取和摘要、跨来源知识关联、汇总报告的自动生成以及知识更新的协同维护。

全面总结子代理开发和使用中的安全最佳实践，涵盖权限最小化（仅授予必要权限）、隔离执行（worktree/沙箱）、敏感信息保护（不在prompt中包含密钥）、子代理行为审计、多子代理环境下的安全风险防范。

全面学习子代理系统的测试方法，涵盖单元测试（单个子代理功能/通信/任务处理）、集成测试（多子代理协作/Team工作流）、模拟测试（模拟子代理通信/模拟错误场景）以及端到端测试。

系统总结子代理的常用设计模式，涵盖Master-Worker模式、Peer-to-Peer模式、Pipeline模式、Fan-out/Fan-in模式、Supervisor Tree模式的适用场景、优缺点对比以及模式选择指南。

全面总结子代理错误处理的最佳实践，涵盖防御性prompt设计、错误传播的合理控制、自动重试和降级策略、错误日志和审计、以及子代理错误的用户通知和反馈机制。

全面学习子代理系统的性能优化方法，涵盖任务粒度优化（任务太大等待久/任务太小通信开销高）、并行度控制（合适的子代理数量）、上下文优化（减少token消耗）、通信优化（减少消息频率/批量化）以及资源管理优化。