安装命令
npx skills add https://github.com/0x2e/superpowers --skill dispatching-parallel-agents🇨🇳中文介绍
并行调度代理
概述
当您遇到多个不相关的故障（不同的测试文件、不同的子系统、不同的错误）时，按顺序调查会浪费时间。每个调查都是独立的，可以并行进行。
核心原则： 为每个独立的问题域调度一个代理。让它们并发工作。
何时使用
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 个以上测试文件因不同根本原因而失败
- 多个子系统独立损坏
- 每个问题无需其他问题的上下文即可理解
- 调查之间没有共享状态
不要在以下情况使用：
- 故障是相关的（修复一个可能修复其他）
- 需要了解完整的系统状态
- 代理会相互干扰
模式
1. 识别独立域
根据损坏内容对故障进行分组：
- 文件 A 测试：工具审批流程
- 文件 B 测试：批量完成行为
- 文件 C 测试：中止功能
每个域都是独立的——修复工具审批不会影响中止测试。
2. 创建聚焦的代理任务
每个代理获得：
- 特定范围： 一个测试文件或子系统
- 明确目标： 使这些测试通过
- 约束： 不要更改其他代码
- 预期输出： 您发现和修复的内容摘要
3. 并行调度
// In Claude Code / AI environment
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")
// 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.
常见错误
❌ 范围太广： "修复所有测试" - 代理会迷失方向 ✅ 具体： "修复 agent-tool-abort.test.ts" - 聚焦的范围
❌ 无上下文： "修复竞态条件" - 代理不知道在哪里 ✅ 有上下文： 粘贴错误信息和测试名称
❌ 无约束： 代理可能会重构所有内容 ✅ 有约束： "不要更改生产代码" 或 "仅修复测试"
❌ 输出模糊： "修复它" - 您不知道更改了什么 ✅ 具体： "返回根本原因和更改的摘要"
何时不使用
相关故障： 修复一个可能修复其他 - 先一起调查 需要完整上下文： 理解需要查看整个系统 探索性调试： 您还不知道哪里坏了 共享状态： 代理会相互干扰（编辑相同文件，使用相同资源）
会话中的真实示例
场景： 重大重构后，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
结果：
- 代理 1：用时序事件等待替换了超时
- 代理 2：修复了事件结构错误（threadId 位置错误）
- 代理 3：添加了等待异步工具执行完成的逻辑
集成： 所有修复独立，无冲突，完整套件通过
节省时间： 并行解决 3 个问题 vs 顺序解决
主要优势
- 并行化 - 多个调查同时进行
- 聚焦 - 每个代理范围狭窄，需要跟踪的上下文更少
- 独立性 - 代理互不干扰
- 速度 - 解决 3 个问题的时间相当于解决 1 个
验证
代理返回后：
- 审查每个摘要 - 了解更改了什么
- 检查冲突 - 代理是否编辑了相同的代码？
- 运行完整套件 - 验证所有修复协同工作
- 抽查 - 代理可能会犯系统性错误
实际影响
来自调试会话 (2025-10-03)：
- 3 个文件出现 6 个故障
- 并行调度了 3 个代理
- 所有调查并发完成
- 所有修复成功集成
- 代理更改之间零冲突
每周安装数
2
仓库
首次出现
2 天前
安全审计
Gen Agent Trust HubPassSocketFailSnykPass
安装于
amp2
cline2
opencode2
cursor2
kimi-cli2
codex2
🇺🇸English
Dispatching Parallel Agents
Overview
When you have multiple unrelated failures (different test files, different subsystems, different bugs), investigating them sequentially wastes time. Each investigation is independent and can happen in parallel.
Core principle: Dispatch one agent per independent problem domain. Let them work concurrently.
When to Use
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"];
}
Use when:
- 3+ test files failing with different root causes
- Multiple subsystems broken independently
- Each problem can be understood without context from others
- No shared state between investigations
Don't use when:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
