name: dispatching-parallel-agents description: > dispatching-parallel-agents — 并行派发子 Agent。 当有 2+ 个独立任务且无共享状态时可以并行执行。

Dispatching Parallel Agents（完全版）

核心原则

每个独立问题域派发一个 Agent，让他们并行工作。

何时使用

有多个失败？
    ↓
它们是否独立？（不同根因）
    ↓
是 → 可以并行派发
    ↓
    ↓
    ├─→ 独立问题域 A → Agent-A
    ├─→ 独立问题域 B → Agent-B
    └─→ 独立问题域 C → Agent-C

否 → 单个 Agent 按顺序处理

使用场景：

• 3+ 个测试文件失败，根因不同
• 多个子系统独立出问题
• 每个问题可以独立理解
• 调查之间无共享状态

不使用场景：

• 失败相关（修一个可能修全部）
• 需要理解完整系统状态
• Agent 会互相干扰

并行派发流程

第一步：识别独立问题域

按问题域分组失败：

问题域 A：
- File A tests: 功能 A

问题域 B：
- File B tests: 功能 B

问题域 C：
- File C tests: 功能 C

第二步：创建专注的 Agent 任务

每个 Agent 收到：

• 具体范围：一个文件或子系统
• 明确目标：让这些测试通过
• 约束：不修改其他代码
• 预期输出：发现什么，修复什么

第三步：并行派发

// 派发多个 Agent 同时执行
Task("Agent-A: 修复功能 A 的测试")
Task("Agent-B: 修复功能 B 的测试")
Task("Agent-C: 修复功能 C 的测试")
// 三个同时运行

第四步：审查和整合

Agent 返回后：

1. 阅读每个总结
2. 验证修复不冲突
3. 运行完整测试套件
4. 整合所有变更

Agent Prompt 结构

好的 Agent Prompt 包含：

1. 专注 - 一个清晰的问题域
2. 自包含 - 理解问题所需的所有上下文
3. 输出明确 - Agent 应该返回什么

Prompt 模板

# Agent 任务：[问题域描述]

## 问题描述
[具体描述需要修复什么]

## 约束
- 只修复这个文件/子系统
- 不修改其他代码
- 如果需要改其他文件，报告问题

## 预期输出
修复后返回：
1. 发现的问题
2. 实施的修复
3. 验证结果

## 执行步骤
1. 阅读测试文件，理解每个测试验证什么
2. 运行测试，确认失败
3. 分析根因
4. 修复代码
5. 运行测试，确认通过
6. 提交修复

小溪的并行规则

1. 最多同时 3 个 Agent - 避免资源竞争
2. 问题必须真正独立 - 不能有依赖关系
3. 结果不冲突 - 修复不会互相影响
4. 状态透明 - 更新 ACTIVE-TASK.md

ACTIVE-TASK.md（并行版本）

# Active Task: [项目名] - 并行执行

## 状态
- 状态: 并行执行中
- 开始时间: YYYY-MM-DD HH:mm
- 并行数: 3

## Agent 分配

| Agent | 问题域 | 状态 | 结果 |
|-------|--------|------|------|
| Agent-A | 功能 A | ✅ 完成 | 3 测试修复 |
| Agent-B | 功能 B | 🔄 执行中 | - |
| Agent-C | 功能 C | ⏳ 等待 | - |

## 整合结果
[所有 Agent 完成后汇总]

完成后

1. 运行完整测试套件确认全部通过
2. 整合所有修复
3. 如果有冲突，单独处理
4. 继续下一步骤