04-Claude code Sub Agent 任务分发

04-Sub Agent 任务分发使用 Claude Code 的 Agent 工具实现多任务并行处理大幅提升复杂项目的开发效率。一、Sub Agent 基础概念1.1 什么是 Sub AgentSub Agent 是 Claude Code 的任务分发机制允许并行执行多个独立的子任务。工作流程:主任务 ├── 子任务1并行执行 ├── 子任务2并行执行 ├── 子任务3并行执行 └── 子任务4并行执行 ↓ 结果汇总 ↓ 主任务继续1.2 Claude Code 的并行机制Claude Code 有两种并行执行方式方式触发条件适用场景自动并行独立的简单任务文件创建、读取、简单修改Agent 工具复杂多步骤任务代码探索、深度分析、大型重构自动并行示例# Claude Code 会自动并行执行这些独立任务生成 test.py打印test生成 hello_world.py打印 hello world# Claude 在一条消息中并行调用多个 Write 工具Agent 工具示例# 复杂任务需要使用 Agent探索项目的数据库架构找出所有使用外键的表# Claude 会启动 Explore Agent 进行深度搜索1.3 与 Cursor 的区别特性Claude CodeCursor调用方式自动判断或显式 Agent隐式自动并行控制粒度可精确控制每个子任务系统自动管理可见性显示每个工具调用内部处理适用场景复杂任务拆分、代码探索编辑器内自动优化二、Agent 工具详解2.1 可用的 Agent 类型Claude Code 提供多种专用 AgentAgent 类型用途典型场景general-purpose通用任务复杂多步骤任务Explore代码库探索查找文件、搜索代码、理解架构Plan实现规划设计实现方案、架构决策code-improvement-advisor代码质量分析代码审查、改进建议2.2 Agent 工具参数{subagent_type:Explore,// Agent 类型description:搜索认证代码,// 简短描述3-5词prompt:在项目中查找所有与用户认证相关的代码包括登录、注册、JWT 处理,model:sonnet,// 可选指定模型run_in_background:true// 可选后台运行}2.3 使用场景对比任务复杂度推荐方式示例简单直接自动并行创建文件、读取内容、简单修改中等复杂自动判断批量重命名、多文件修改高度复杂使用 Agent代码库探索、架构分析、大型重构三、任务管理工具3.1 Task 系列工具Claude Code 提供任务管理工具用于跟踪进度工具功能使用场景TaskCreate创建任务开始复杂任务前TaskList列出所有任务查看进度TaskGet获取任务详情了解任务依赖TaskUpdate更新任务状态标记完成/进行中3.2 任务管理示例# 创建复杂任务列表帮我实现用户认证系统# Claude 会自动创建任务1. 设计 User 数据模型2. 实现密码加密3. 创建登录 API4. 实现 JWT 验证5. 编写测试3.3 任务依赖关系任务1: 数据模型设计 ↓ (blocks) 任务2: 数据库迁移 ──→ 任务3: API 实现 ↓ 任务4: 测试编写四、实战应用场景场景1并行生成 CRUD# 简单任务Claude 自动并行创建以下文件 - src/models/user.pyUser Pydantic 模型 - src/services/user_service.pyUserService 类 - tests/test_user.py用户测试# Claude 在一条消息中并行创建三个文件场景2复杂代码探索# 复杂任务使用 Agent分析项目的整体架构找出1. 所有 API 端点2. 数据库模型关系3. 服务层依赖关系4. 潜在的性能瓶颈# Claude 启动 Explore Agent 进行深度分析场景3批量代码审查# 中等任务自动并行 汇总审查 src/services/ 下所有服务类检查 - 代码规范性 - 错误处理 - 安全漏洞# Claude 并行读取文件汇总审查报告五、任务拆分原则5.1 何时需要显式拆分不需要显式拆分简单的文件操作明确的小范围修改Claude 能自动判断的任务需要显式拆分大型功能开发有依赖关系的多步骤任务需要用户确认关键节点5.2 任务拆分示例好的拆分任务开发完整的用户系统 第一批并行无依赖 1. 创建 User 数据模型 2. 创建 UserService 骨架 3. 创建 API 路由骨架 第二批顺序有依赖 4. 实现数据库迁移依赖任务1 5. 实现服务层逻辑依赖任务1、2 6. 编写集成测试依赖任务3、5不好的拆分❌ 并行执行有依赖的任务 任务1读取配置并解析 任务2基于配置生成代码 任务2依赖任务1结果不应并行5.3 任务描述规范每个子任务应包含 - 任务名称 - 具体目标 - 输出要求 - 输入依赖如果有六、后台任务6.1 后台运行 Agent对于耗时的探索任务可以后台运行# 后台运行代码分析在后台分析整个项目的依赖关系完成后告诉我# Claude 设置 run_in_background: true# 完成后会自动通知6.2 检查后台任务# 查看后台任务状态/tasks# 输出# Task ID: abc123# Status: running# Description: 分析项目依赖七、最佳实践7.1 选择正确的执行方式场景推荐方式原因创建 2-3 个简单文件自动并行无需额外开销探索代码库结构Explore Agent需要多轮搜索设计实现方案Plan Agent需要架构思考代码质量分析code-improvement-advisor专用优化建议大型重构分批 Agent需要协调管理7.2 效率优化建议建议说明信任自动并行简单任务无需手动指定使用专用 Agent复杂任务用专用类型更高效合理分批大任务分批处理中间验证后台运行耗时探索任务后台执行八、常见问题Q1: 任务执行顺序不对原因任务之间可能有隐式依赖解决# 明确说明依赖关系先创建模型然后基于模型创建服务最后写测试Q2: Agent 执行太慢原因复杂任务需要多轮探索解决# 缩小范围只在 src/api/ 目录下搜索认证相关代码Q3: 结果不符合预期解决提供更明确的任务描述指定具体的文件路径分步骤执行并验证九、下一步学习完成本指南后建议学习05-Hooks自动化.md - 自动化工作流09-实战PythonWebAPI开发.md - Sub Agent 实战应用