Subagent 子代理完整指南：官方 Subagents、Task 委派与社区代理资源
Subagent 子代理完整指南：官方 Subagents、Task 委派与社区代理资源
Subagent 子代理完整指南：官方 Subagents、Task 委派与社区代理资源 Subagent 子代理完整指南：官方 Subagents、Task 委派与社区代理资源 Modified June 10 6. 开发者体验 (Developer Experience) ⠀ 插件包： voltagent dev exp — 提升开发效率、工具链和文档。 ⠀ 7. 专业领域 (Specialized Domains) ⠀ 插件包： voltagent domains — 特定垂直领域技术专家。 ⠀ 8. 业务与产品 (Business & Product) ⠀ 插件包： voltagent biz — 产品管理、业务分析和敏捷流程。 ⠀ 代理 说明 product manager 产品战略专家 business analyst 需求专家 project manager 项目管理专家 scrum master 敏捷方法论专家 technical writer 技术文档专家 ux researcher 用户研究专家 customer success manager 客户成功专家 sales engineer 技术销售专家 legal advisor 法律和合规专家 content marketing specialist 内容营销专家 9. 元数据与编排 (Meta & Orchestration) ⠀ 插件包： voltagent meta — 负责代理之间的协调、任务分配和管理。 ⠀ 代理 说明 multi agent coordinator 高级多智能体编排 workflow orchestrator 复杂工作流自动化 agent organizer 多代理协调器 agent installer 通过 GitHub 浏览并安装代理程序 context manager 上下文优化专家 task dispatcher 任务分配专家 error coordinator 错误处理和恢复专家 performance monitor 代理性能优化 knowledge synthesizer 知识聚合专家 it ops orchestrator IT 运维工作流编排专家 pied piper SDLC 工作流 AI 子代理团队协调 10. 研究与分析 (Research & Analysis) ⠀ 插件包： voltagent research — 负责搜索、市场调研和数据分析。 ⠀ 代理 说明 research analyst 综合研究专家 competitive analyst 竞争情报专家 market researcher 市场分析和消费者洞察 search expert 高级信息检索专家 trend analyst 新兴趋势和预测专家 data researcher 数据发现与分析专家 第四部分：Agent Teams 多代理团队协作 🆕 ⠀ 实验性功能：Agent Teams 当前仍需显式开启实验开关后再使用，不应默认视为稳定主路径。 ⠀ 开启方式：设置环境变量 CLAUDE CODE EXPERIMENTAL AGENT TEAMS=1，然后再进入相关工作流。 ⠀ 一句话理解：如果说普通 Subagent 是"你指派一个助手去干活"，那 Agent Teams 就是"你组建一个项目组，分工合作"。 ⠀ 核心概念 ⠀ v2.1.139→v2.1.158 关键更新：claude agents Agent View 已成为管理运行中、等待输入和已完成会话的重要入口；claude agents json 可用于脚本化查看后台会话； cwd、 add dir、 settings、 mcp config、 plugin dir、 permission mode、 model、 effort 等参数让后台会话更容易复用当前项目配置。v2.1.154 起还可以在 Agent View 输入 ! <command 或用 claude bg exec '<command ' 跑可附着的后台 shell。v2.1.157 起 claude agents 会尊重 settings.json 里的 agent 字段，并可用 agent <name 覆盖；EnterWorktree 可以在会话中切换 Claude 管理的 worktree，完成后的 Claude worktree 也会保持解锁，方便 git worktree remove / prune 清理。Windows、worktree、stale daemon、pinned session、resume 后台子代理和 subagent 隔离场景也有多轮修复，团队教程里不要再默认把后台 agent 当成会写共享 checkout 的普通子进程。 ⠀ 概念 说明 类比 Team Lead 团队领导代理，负责分配任务和协调进度 项目经理 Teammate 团队成员代理，执行具体任务并汇报 开发工程师 TaskList 共享任务列表，所有成员可见进度和状态 看板 / Trello SendMessage 代理间通信机制，支持直接消息和广播 团队群聊 ⠀ 与普通 Subagent/Task 的区别 ⠀ 特性 普通 Subagent/Task Agent Teams 协作模式 一对一（主代理 → 子代理） 多对多（团队协作） 任务管理 各自独立，互不感知 共享任务列表，实时同步 通信方式 子代理返回结果给主代理 团队成员间可互相通信 生命周期 任务完成即退出 持续运行直到团队解散 适用场景 独立子任务 复杂项目分工 ⠀ 典型使用场景 ⠀ • 并行开发：前端、后端、测试代理同时工作，通过 TaskList 共享进度 • 代码审查分工：安全审查、性能审查、风格审查代理并行检查，汇总结果 • 大型重构：多个模块同时修改，团队成员间协调接口变更 ⠀ 快速示例 ⠀ Code block Plain Text 在 Claude Code 中，使用自然语言请求创建团队 You: 帮我组建一个团队，并行处理以下任务： 1. 重构用户认证模块 2. 编写 API 集成测试 3. 更新相关文档 ⠀ Team Lead 会自动将任务分配给不同的 Teammate，各成员独立工作并通过 SendMessage 同步关键信息。 ⠀ 💡 何时用哪个？ • 简单独立任务（翻译文件、生成测试）→ 普通 Subagent/Task，更轻量 • 复杂协作项目（多模块重构、全栈开发）→ Agent Teams，但前提是你愿意接受实验性行为和额外编排成本 v2.1.133→v2.1.158 重要变更：worktree、Agent View 和子代理环境 ⠀ worktree.baseRef（v2.1.133） ⠀ 当 Claude Code 为子代理或并行任务创建 git worktree 时，新 worktree 从哪里分叉？这个行为现在可以通过 worktree.baseRef 设置控制： ⠀ 值 分叉来源 适用场景 fresh（默认） origin/<default branch 确保从远程最新代码开始，适合协作项目 head 本地 HEAD 基于你当前工作状态继续，适合单人项目 ⠀ Code block Plain Text // .claude/settings.json { "worktree.baseRef": "head" } https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/data analyst.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/database optimizer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/postgres pro.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/mlops engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/nlp engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/05 data ai/prompt engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/refactoring expert.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/documentation engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/git workflow manager.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/legacy code modernizer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/mcp developer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/build engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/cli developer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/dependency manager.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/dx optimizer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/tooling engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/slack expert.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/powershell ui architect.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/06 dev experience/powershell module architect.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/blockchain developer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/game developer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/fintech engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/iot engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/embedded systems engineer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/api documenter.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/seo specialist.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/mobile app developer.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/payment integration specialist.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/quantitative analyst.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/risk manager.md https://github.com/VoltAgent/awesome claude code subagents/blob/main/categories/07 specialized domains/m365 admin.md product manager business analyst project manager scrum master technical writer ux researcher customer success manager sales engineer legal advisor content marketing specialist multi agent coordinator workflow orchestrator agent organizer agent installer context manager task dispatcher error coordinator performance monitor knowledge synthesizer it ops orchestrator pied piper research analyst competitive analyst market researcher search expert trend analyst data researcher 6. 开发者体验 (Developer Experience) ⠀ 插件包： voltagent dev exp — 提升开发效率、工具链和文档。 ⠀ 7. 专业领域 (Specialized Domains) ⠀ 插件包： voltagent domains — 特定垂直领域技术专家。 ⠀ 8. 业务与产品 (Business & Product) ⠀ 插件包： voltagent biz — 产品管理、业务分析和敏捷流程。 ⠀ 代理 说明 product manager 产品战略专家 business analyst 需求专家 project manager 项目管理专家 scrum master 敏捷方法论专家 technical writer 技术文档专家 ux researcher 用户研究专家 customer success manager 客户成功专家 sales engineer 技术销售专家 legal advisor 法律和合规专家 content marketing specialist 内容营销专家 product manager business analyst project manager scrum master technical writer ux researcher customer success manager sales engineer legal advisor content marketing specialist 代理 代理 说明 说明 product manager product manager product manager product manager 产品战略专家 产品战略专家 business analyst business analyst business analyst business analyst 需求专家 需求专家 project manager project manager project manager project manager 项目管理专家 项目管理专家 scrum master scrum master scrum master scrum master 敏捷方法论专家 敏捷方法论专家 technical writer technical writer technical writer technical writer 技术文档专家 技术文档专家 ux researcher ux researcher ux researcher ux researcher 用户研究专家 用户研究专家 customer success manager customer success manager customer success manager customer success manager 客户成功专家 客户成功专家 sales engineer sales engineer sales engineer sales engineer 技术销售专家 技术销售专家 legal advisor legal advisor legal advisor legal advisor 法律和合规专家 法律和合规专家 content marketing specialist content marketing specialist content marketing specialist content marketing specialist 内容营销专家 内容营销专家 9. 元数据与编排 (Meta & Orchestration) ⠀ 插件包： voltagent meta — 负责代理之间的协调、任务分配和管理。 ⠀ 代理 说明 multi agent coordinator 高级多智能体编排 workflow orchestrator 复杂工作流自动化 agent organizer 多代理协调器 agent installer 通过 GitHub 浏览并安装代理程序 context manager 上下文优化专家 task dispatcher 任务分配专家 error coordinator 错误处理和恢复专家 performance monitor 代理性能优化 knowledge synthesizer 知识聚合专家 it ops orchestrator IT 运维工作流编排专家 pied piper SDLC 工作流 AI 子代理团队协调 multi agent coordinator workflow orchestrator agent organizer agent installer context manager task dispatcher error coordinator performance monitor knowledge synthesizer it ops orchestrator pied piper 代理 代理 说明 说明 multi agent coordinator multi agent coordinator multi agent coordinator multi agent coordinator 高级多智能体编排 高级多智能体编排 workflow orchestrator workflow orchestrator workflow orchestrator workflow orchestrator 复杂工作流自动化 复杂工作流自动化 agent organizer agent organizer agent organizer agent organizer 多代理协调器 多代理协调器 agent installer agent installer agent installer agent installer 通过 GitHub 浏览并安装代理程序 通过 GitHub 浏览并安装代理程序 context manager context manager context manager context manager 上下文优化专家 上下文优化专家 task dispatcher task dispatcher task dispatcher task dispatcher 任务分配专家 任务分配专家 error coordinator error coordinator error coordinator error coordinator 错误处理和恢复专家 错误处理和恢复专家 performance monitor performance monitor performance monitor performance monitor 代理性能优化 代理性能优化 knowledge synthesizer knowledge synthesizer knowledge synthesizer knowledge synthesizer 知识聚合专家 知识聚合专家 it ops orchestrator it ops orchestrator it ops orchestrator it ops orchestrator IT 运维工作流编排专家 IT 运维工作流编排专家 pied piper pied piper pied piper pied piper SDLC 工作流 AI 子代理团队协调 SDLC 工作流 AI 子代理团队协调 10. 研究与分析 (Research & Analysis) ⠀ 插件包： voltagent research — 负责搜索、市场调研和数据分析。 ⠀ 代理 说明 research analyst 综合研究专家 competitive analyst 竞争情报专家 market researcher 市场分析和消费者洞察 search expert 高级信息检索专家 trend analyst 新兴趋势和预测专家 data researcher 数据发现与分析专家 research analyst competitive analyst market researcher search expert trend analyst data researcher 代理 代理 说明 说明 research analyst research analyst research analyst research analyst 综合研究专家 综合研究专家 competitive analyst competitive analyst competitive analyst competitive analyst 竞争情报专家 竞争情报专家 market researcher market researcher market researcher market researcher 市场分析和消费者洞察 市场分析和消费者洞察 search expert search expert search expert search expert 高级信息检索专家 高级信息检索专家 trend analyst trend analyst trend analyst trend analyst 新兴趋势和预测专家 新兴趋势和预测专家 data researcher data researcher data researcher data researcher 数据发现与分析专家 数据发现与分析专家 第四部分：Agent Teams 多代理团队协作 🆕 ⠀ 实验性功能：Agent Teams 当前仍需显式开启实验开关后再使用，不应默认视为稳定主路径。 实验性功能：Agent Teams 当前仍需显式开启实验开关后再使用，不应默认视为稳定主路径。 ⠀ 开启方式：设置环境变量 CLAUDE CODE EXPERIMENTAL AGENT TEAMS=1，然后再进入相关工作流。 开启方式：设置环境变量 CLAUDE CODE EXPERIMENTAL AGENT TEAMS=1，然后再进入相关工作流。 ⠀ 一句话理解：如果说普通 Subagent 是"你指派一个助手去干活"，那 Agent Teams 就是"你组建一个项目组，分工合作"。 ⠀ 核心概念 ⠀ v2.1.139→v2.1.158 关键更新：claude agents Agent View 已成为管理运行中、等待输入和已完成会话的重要入口；claude agents json 可用于脚本化查看后台会话； cwd、 add dir、 settings、 mcp config、 plugin dir、 permission mode、 model、 effort 等参数让后台会话更容易复用当前项目配置。v2.1.154 起还可以在 Agent View 输入 ! <command 或用 claude bg exec '<command ' 跑可附着的后台 shell。v2.1.157 起 claude agents 会尊重 settings.json 里的 agent 字段，并可用 agent <nam