How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers:dispatching-parallel-agentsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
你将 task 委派给具有隔离上下文的专业 agent。通过精心设计它们的指令和上下文,确保它们专注于自己的 task 并成功完成。它们不应继承你会话的上下文或历史——你需要精确构建它们所需的内容。这也为你自己的协调工作保留了上下文空间。
你将 task 委派给具有隔离上下文的专业 agent。通过精心设计它们的指令和上下文,确保它们专注于自己的 task 并成功完成。它们不应继承你会话的上下文或历史——你需要精确构建它们所需的内容。这也为你自己的协调工作保留了上下文空间。
当你遇到多个不相关的失败(不同的测试文件、不同的子系统、不同的 bug)时,按顺序调查会浪费时间。每次调查都是独立的,可以并行进行。
核心原则: 每个独立问题域调度一个 agent。让它们并发工作。
digraph when_to_use {
"多个失败?" [shape=diamond];
"它们是否独立?" [shape=diamond];
"单个 agent 调查所有" [shape=box];
"每个问题域一个 agent" [shape=box];
"能否并行工作?" [shape=diamond];
"顺序 agent" [shape=box];
"并行调度" [shape=box];
"多个失败?" -> "它们是否独立?" [label="是"];
"它们是否独立?" -> "单个 agent 调查所有" [label="否 - 相关"];
"它们是否独立?" -> "能否并行工作?" [label="是"];
"能否并行工作?" -> "并行调度" [label="是"];
"能否并行工作?" -> "顺序 agent" [label="否 - 共享状态"];
}
使用场景:
不使用场景:
按出错内容分组:
每个域都是独立的——修复 tool 审批不会影响中止测试。
每个 agent 获得:
// 在 Claude Code / AI 环境中
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")
// 三个同时并发运行
当 agent 返回时:
好的 agent prompt 应该:
修复 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" - 快速 tool 被中止而非完成
3. "should properly track pendingToolCount" - 期望 3 个结果但得到 0 个
这些是时序/竞态条件问题。你的 task:
1. 阅读测试文件,理解每个测试验证什么
2. 找到根因——是时序问题还是实际 bug?
3. 通过以下方式修复:
- 用基于事件的等待替换武断的超时
- 如果发现中止实现中的 bug 则修复
- 如果被测行为已变更则调整测试期望
不要只是增加超时时间——找到真正的问题。
返回:你发现了什么以及你修复了什么的摘要。
❌ 太宽泛: "修复所有测试" - agent 会迷失方向 ✅ 具体: "修复 agent-tool-abort.test.ts" - 聚焦的范围
❌ 无上下文: "修复竞态条件" - agent 不知道在哪里 ✅ 有上下文: 粘贴错误消息和测试名称
❌ 无约束: Agent 可能重构所有内容 ✅ 有约束: "不要修改生产代码" 或 "只修复测试"
❌ 模糊输出: "修好它" - 你不知道改了什么 ✅ 具体: "返回根因和变更的摘要"
相关失败: 修复一个可能修复其他——先一起调查 需要完整上下文: 理解需要查看整个系统 探索性调试: 你还不知道哪里出了问题 共享状态: Agent 会相互干扰(编辑相同文件、使用相同资源)
场景: 大型重构后 3 个文件共 6 个测试失败
失败:
决策: 独立域——中止逻辑与批量完成与竞态条件各自独立
调度:
Agent 1 → 修复 agent-tool-abort.test.ts
Agent 2 → 修复 batch-completion-behavior.test.ts
Agent 3 → 修复 tool-approval-race-conditions.test.ts
结果:
整合: 所有修复独立,无冲突,完整套件通过
节省时间: 3 个问题并行解决 vs 按顺序
Agent 返回后:
来自调试会话(2025-10-03):
npx claudepluginhub huaka1/oh-my-harness --plugin superpowersGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.