07 | 多任务并行探索与流水线编排：Claude Code 工程化实战

07 | 多任务并行探索与流水线编排：Claude Code 工程化实战声明：📝 作者：甜城瑞庄的核桃（ZMJ）原创学习笔记，欢迎分享，但请保留作者信息及原文链接哦～本文深入探讨子代理的两个高级应用模式——并行探索和流水线编排，掌握多任务协同处理的工程方法论。一、引言：两种高级应用场景1.1 应用场景定位模式适用场景核心价值并行探索需要同时从多个角度理解或处理一件事速度 + 独立性流水线编排复杂任务可拆成多个连续阶段清晰度 + 可控性1.2 学习目标本文将帮助你掌握：✅ 并行探索和流水线编排的基本使用✅ 两种模式的差异和适用场景✅ "独立→并行，依赖→流水线"的判断标准✅ 设计阶段间"交接契约"的方法✅ 混合模式的编排策略✅ 主对话作为"编排者"的角色定位二、场景分析：真实工程痛点2.1 场景一：新接手大型项目传统串行探索的问题1. 看 auth 模块 → 花 3 小时 2. 看 database 模块 → 花 5 小时 3. 看 api 模块 → 花 40 分钟 4. 综合理解 → ???问题：❌ 串行探索效率低❌ 容易在中途忘记前面看到的细节❌ 总耗时长达 8+ 小时并行探索的优势┌─────────────┐ │ 主对话 │ └─────┬───────┘ │ 同时启动 ├────────┬────────┬────────┐ ↓ ↓ ↓ ↓ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ auth │ │ database │ │ api │ │ explorer │ │ explorer │ │ explorer │ └──────────┘ └──────────┘ └──────────┘ │ │ │ └────────┴────────┴────────┐ ↓ ┌──────────────┐ │ 综合报告 │ └──────────────┘优势：✅ 三个子代理同时工作✅ 各自探索自己的领域✅ 最后汇总成综合报告✅ 耗时仅需最长的一个（约 5 小时）2.2 场景二：修复复杂 Bug问题描述“用户登录后偶尔 token 验证失败” —— 这种间歇性问题最难调试。主对话直接处理的问题搜索相关代码 → 200 行输出 分析可能原因 → 又是 200 行 修复 → 100 行 验证 → 测试输出...结果：主对话上下文被迅速塞满，质量下降。流水线方式的优势┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Locator │──→│ Analyzer │──→│ Fixer │──→│ Verifier │ │ (定位) │ │ (分析) │ │ (修复) │ │ (验证) │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ ↓ ↓ ↓ ↓ 简洁摘要 简洁摘要 简洁摘要 简洁摘要 ↓ 主对话保持清洁优势：✅ 每个阶段只返回摘要✅ 主对话始终保持清洁✅ 可以随时介入做决策✅ 职责清晰，易于追踪三、并行探索：实战项目3.1 项目结构04-parallel-explore/ ├── src/ │ ├── auth/ # 认证模块 │ │ ├── index.js │ │ ├── jwt.js │ │ └── session.js │ ├── database/ # 数据库模块 │ │ ├── index.js │ │ ├── models.js │ │ └── migrations.js │ └── api/ # API 模块 │ ├── index.js │ ├── routes.js │ └── middleware.js └── .claude/agents/ ├── auth-explorer.md ├── db-explorer.md └── api-explorer.md3.2 创建专门的探索子代理auth-explorer 配置--- name: auth-explorer description: Explore and analyze authentication-related code. Use when investigating auth flows, session management, or security. tools: Read, Grep, Glob model: haiku --- You are an authentication specialist focused on exploring auth-related code. ## Your Domain Focus ONLY on authentication-related concerns: - Login/logout flows - Token generation and validation (JWT, sessions) - Password handling - Permission and role systems - Session management ## When Invoked 1. **Locate Auth Code**: Use Glob to find auth-related files - Patterns: `**/auth/**`, `**/*auth*`, `**/*login*`, `**/*session*`, `**/*jwt*` 2. **Analyze Structure**: Read key files and understand: - How users authenticate - How tokens are generated/validated - How sessions are managed - How permissions are checked 3. **Report Findings** ## Output Format \```markdown ## Auth Module Analysis ### Overview [1-2 sentence summary] ### Authentication Flow 1. [Step 1] 2. [Step 2] ... ### Key Components | Component | File | Purpose | |-----------|------|---------| | ... | ... | ... | ### Token Strategy - Type: [JWT/Session/etc] - Expiry: [duration] - Storage: [where stored] ### Security Notes - [Observations about security posture] \``` ## Guidelines - Stay within auth domain - don't analyze unrelated code - Note any security concerns you observe - Be concise - main conversation will synthesize关键设计点设计点值说明toolsRead, Grep, Glob全部只读，探索不需修改modelhaiku探索任务简单，追求速度Stay within auth domain明确职责边界防止越界分析不相关代码3.3 创建其他探索子代理使用同样的模式创建db-explorer和api-explorer，只需修改：name 和 descriptionYour Domain 部分的关注点Output Format 中的报告结构3.4 使用并行探索触发命令同时让 auth-explorer、db-explorer、api-explorer 探索各自模块， 然后汇总给我一个整体架构理解执行流程1. 并行启动三个子代理 ↓ 2. 各自独立执行探索任务 ↓ 3. 收集三份报告 ↓ 4. 综合成一份整体架构理解3.5 性能对比执行方式