parallel-agent-dispatchlisted
Install: claude install-skill findscripter/everything-skills
## 何时使用
当你手上有多个**彼此无关**的问题（不同测试文件、不同子系统、不同 Bug），逐个串行排查纯属浪费时间。核心原则：**一个独立问题域派一个子 Agent，让它们并发干活。**
判定路径（源自原 SKILL 的决策图）：
1. 有多处失败吗？→ 没有则单 Agent 处理。
2. 它们彼此独立吗？→ 相关联（修一个可能连带修好其他）则让单 Agent 一起查。
3. 能并行吗？→ 有共享状态（会改同一文件、抢同一资源）则改为串行 Agent；否则并行分派。
**该用：**
- 3+ 个测试文件因不同根因失败
- 多个子系统各自独立损坏
- 每个问题不依赖其他上下文即可理解
- 各排查之间无共享状态
**不该用（负边界）：**
- 失败相互关联——先合并排查，修一个可能修好一片
- 需要通览整个系统状态才能理解
- 探索性排障——你还不知道哪里坏了
- 共享状态——Agent 之间会互相干扰（编辑同一文件、争用同一资源）
## 步骤 / 指令
**1. 划分独立问题域**
按"坏了什么"对失败分组，例如：文件 A=工具审批流程、文件 B=批量完成行为、文件 C=中止功能。确认彼此独立——修工具审批不会影响中止测试。
**2. 编写聚焦的 Agent 任务**
每个子 Agent 必须拿到四件套：
- **明确范围**：单个测试文件或子系统
- **清晰目标**：让这些测试通过
- **约束**：不要改动其他代码
- **预期产出**：定位与修复的摘要
**3. 并行分派**（Claude Code / AI 环境）
```typescript
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 可能犯系统性错误，确认无误后整合
## 示例
好的子 Agent prompt 应满足：**聚焦**（单一问题域）、**自包含**（含理解问题所需的全部上下文）、**产出明确**（说清要返回什么）。
```markdown
修复 src/agents/agent-tool-abort.test.ts 中 3 个失败的测试：
1. "should abort tool with partial output capture" - 期望消息含 'interrupted at'
2. "should handle mixed completed and aborted tools" - 快速工具被中止而非完成
3. "should properly track pendingToolCount" - 期望 3 个结果但得到 0
这些是计时/竞态问题。你的任务：
1. 读测试文件，理解每个测试在验证什么
2. 定位根因——计时问题还是真实 Bug？
3. 修复方式：
- 用基于事件的等待替换任意 timeout
- 若发现中止实现有 Bug 则修掉
- 若被测行为已变更则调整测试期望
不要只是加大 timeout——找到真正的问题。
返回：你定位到什么、修了什么的摘要。
``