用途
Dispatching Parallel Agents 用于处理多个相互独立、互不依赖的问题。当你面对 2 个以上可以在没有共享状态或顺序依赖的情况下并行推进的任务时，可以一次派出多个子智能体同时工作。它的核心是：把任务委派给拥有隔离上下文的专用智能体，通过精确构造它们的指令和上下文，确保每个智能体都能保持专注并完成任务。子智能体不应继承你当前会话的上下文或历史——你需要为它们构建恰好需要的信息，这同时也能为你自己的协调工作保留上下文。
当存在多个不相关的失败（不同测试文件、不同子系统、不同 bug）时，逐个串行调查会浪费时间。每次调查都是独立的，可以并行进行。核心原则是：每个独立问题域分派一个智能体，让它们并发工作。
何时使用
资料给出的判断流程为：
- 有多个失败？
- 否：由单个智能体调查全部
- 是：它们是否独立？
- 否（相关）：由单个智能体调查全部
- 是：它们能否并行？
- 否（共享状态）：顺序分派智能体
- 是：并行分派
适用情形包括：
- 3 个以上测试文件以不同根因失败
- 多个子系统各自独立损坏
- 每个问题无需借助其他问题的上下文就能理解
- 各调查之间没有共享状态
不适用情形包括：
- 失败彼此相关（修好一个可能修好其他）
- 需要理解整个系统状态
- 智能体之间会相互干扰
模式
1. 识别独立域
按“坏在哪里”对失败分组，例如：
- 文件 A 测试：工具批准流程
- 文件 B 测试：批处理完成行为
- 文件 C 测试：中止功能
每个域相互独立——修复工具批准不会影响中止测试。
2. 创建聚焦的智能体任务
每个智能体获得：
- 明确范围：一个测试文件或子系统
- 清晰目标：让这些测试通过
- 约束条件：不要改动其他代码
- 预期输出：你发现并修复了什么的总结
3. 并行分派
在同一个响应中发出全部三个子智能体分派——它们会并行运行：
Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures" Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures" Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
All three run concurrently.
同一响应中多个分派调用 = 并行执行。一个响应一个调用 = 顺序执行。
4. 审查与整合
智能体返回时：
- 阅读每个总结
- 验证修复之间不冲突
- 运行完整测试套件
- 整合全部变更
智能体提示结构
好的智能体提示应当：
- 聚焦——一个清晰的问题域
- 自包含——包含理解问题所需的全部上下文
- 对输出有明确要求——智能体应该返回什么？
资料给出的示例提示：
Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:
- "should abort tool with partial output capture" - expects 'interrupted at' in message
- "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
- "should properly track pendingToolCount" - expects 3 results but gets 0
These are timing/race condition issues. Your task:
- Read the test file and understand what each test verifies
- Identify root cause - timing issues or actual bugs?
- Fix by:
- Replacing arbitrary timeouts with event-based waiting
- Fixing bugs in abort implementation if found
- Adjusting test expectations if testing changed behavior
Do NOT just increase timeouts - find the real issue.
Return: Summary of what you found and what you fixed.
常见错误
- 太宽泛：“Fix all the tests”——智能体会迷失
- 具体：“Fix agent-tool-abort.test.ts”——范围聚焦
- 无上下文：“Fix the race condition”——智能体不知道在哪里
- 有上下文：粘贴错误信息和测试名称
- 无约束：智能体可能重构一切
- 有约束：“Do NOT change production code”或“Fix tests only”
- 输出含糊：“Fix it”——你不知道改了什么
- 输出具体：“Return summary of root cause and changes”
何时不要使用
- 相关失败：修好一个可能修好其他——应一起调查
- 需要完整上下文：理解问题必须看到整个系统
- 探索性调试：你还不知道坏在哪里
- 共享状态：智能体会相互干扰（编辑同一文件、使用同一资源）
实际会话示例
场景：一次大重构后，3 个文件中出现 6 个测试失败
失败情况：
- agent-tool-abort.test.ts：3 个失败（时序问题）
- batch-completion-behavior.test.ts：2 个失败（工具未执行）
- tool-approval-race-conditions.test.ts：1 个失败（执行计数为 0）
判断：这些是独立域——中止逻辑、批处理完成、竞态条件彼此分离
分派：
- Agent 1 → Fix agent-tool-abort.test.ts
- Agent 2 → Fix batch-completion-behavior.test.ts
- Agent 3 → Fix tool-approval-race-conditions.test.ts
结果：
- Agent 1：用基于事件的等待替换超时
- Agent 2：修复事件结构 bug（threadId 位置错误）
- Agent 3：增加等待异步工具执行完成
整合：所有修复相互独立、无冲突，完整测试套件通过
验证
智能体返回后：
- 审查每个总结——理解改了什么
- 检查冲突——智能体是否编辑了同一处代码？
- 运行完整套件——验证所有修复能协同工作
- 抽查——智能体可能犯系统性错误
限制
使用方法以资料所述判断流程为准；不适用于相关失败、需要完整系统上下文、探索性调试以及存在共享状态的场景。关于适用平台、具体运行环境、收费方式等信息，资料暂未提供。