dispatching-parallel-agents

并行调度 Agent

概述

当遇到多个互不相关的问题（不同的测试文件、不同的子系统、不同的错误）时，按顺序逐一调查会浪费时间。每项调查都是独立的，可以并行进行。

核心原则： 为每个独立的问题领域调度一个 Agent，让它们并行工作。

适用场景

digraph when_to_use {
    "Multiple failures?" [shape=diamond];
    "Are they independent?" [shape=diamond];
    "Single agent investigates all" [shape=box];
    "One agent per problem domain" [shape=box];
    "Can they work in parallel?" [shape=diamond];
    "Sequential agents" [shape=box];
    "Parallel dispatch" [shape=box];

    "Multiple failures?" -> "Are they independent?" [label="yes"];
    "Are they independent?" -> "Single agent investigates all" [label="no - related"];
    "Are they independent?" -> "Can they work in parallel?" [label="yes"];
    "Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
    "Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
}

适用情况： 有 3 个或更多根因不同的问题、多个互相独立的子系统发生故障，且各项调查之间没有共享状态。

不适用情况： 问题彼此相关、需要了解整个系统的上下文，或 Agent 可能相互干扰（编辑同一文件）。

操作模式

1. 找出独立的问题领域

根据故障内容对问题分组。每个领域都是独立的——修复一个不会影响其他领域。

2. 创建目标明确的 Agent 任务

为每个 Agent 提供：明确的范围（一个文件或子系统）、清晰的目标、约束（不要更改其他代码）、预期输出（调查结果和修复内容摘要）。同时注明返回格式要求：令牌预算（例如“少于 1000 个令牌”）和结构（例如“先给结论，再列详情”）。

模型选择： 实施任务使用 Opus，审查或分析任务使用 Sonnet，简单的验证或格式整理任务使用 Haiku。

请使用调度提示词模板，遵循规范的 6 部分提示词结构。

3. 并行调度

Task("Fix agent-tool-abort.test.ts failures")
Task("Fix batch-completion-behavior.test.ts failures")
Task("Fix tool-approval-race-conditions.test.ts failures")

4. 审查并整合

阅读每份摘要，确认修复之间没有冲突，运行完整测试套件，然后整合所有更改。

不适用场景

• 相关问题： 修复一个问题可能会同时解决其他问题——先一起调查
• 需要完整上下文： 理解问题需要查看整个系统
• 探索性调试： 尚不清楚具体哪里出了问题
• 共享状态： Agent 可能相互干扰（如果并行处理在其他方面有益，可考虑使用 git worktree 进行隔离）

验证

Agent 返回结果后：

1. 审阅每份摘要——了解发生了哪些更改
2. 检查冲突——Agent 是否编辑了相同的代码？
3. 运行完整测试套件——验证所有修复能否协同工作
4. 抽查——Agent 可能会犯系统性错误

关于 Agent 提示词结构、常见错误和实际示例演练，请参阅references/agent-prompts-and-examples.md。