Superpowers Parallel Agents（OpenClaw 适配版）

---

name: superpowers-parallel-agents

description: Use when facing 2 or more independent tasks that can be worked on without shared state - dispatches parallel subagents using sessions_spawn for concurrent investigation and execution, adapted for OpenClaw

---

# Superpowers Parallel Agents（OpenClaw 适配版）

概述

当面临 2+ 个独立任务时，将它们分配给专门的并行 subagent，同时工作。OpenClaw 用 `sessions_spawn` 创建独立 session 实现并行分发。

**核心原则：** 每个独立问题域分配一个 agent，让它们并发工作。

OpenClaw 适配

Superpowers 原版用 Claude Code 的 `Task` 工具并发派发。OpenClaw 用 `sessions_spawn`：

使用条件

有多个失败/独立任务？
  → 它们独立？（不同根因、无共享状态）？
    → 可以并行工作？
      → 用 parallel-agents（这个技能）✅
    → 顺序更合适？
      → 用 systematic-debugging 单独处理
  → 需要全面上下文理解？
    → 单一 agent 处理

**适用场景：**

**不适用：**

流程

1. 识别独立问题域

按问题分组：

每个问题域独立——修工具审批不影响中止测试。

2. 为每个 Agent 创建专注任务

每个 agent 获得：

3. 并行 dispatch

用 `sessions_spawn` 同时派发所有 agent：

// OpenClaw: sessions_spawn 并行派发
sessions_spawn({
  task: "修复 src/agents/agent-tool-abort.test.ts 的 3 个失败测试...",
  runtime: "subagent",
  mode: "run",
  cwd: "/path/to/project"
})
sessions_spawn({
  task: "修复 src/batch/completion.test.ts 的 2 个失败测试...",
  runtime: "subagent",
  mode: "run",
  cwd: "/path/to/project"
})
sessions_spawn({
  task: "修复 src/tools/race-conditions.test.ts 的 1 个失败测试...",
  runtime: "subagent",
  mode: "run",
  cwd: "/path/to/project"
})

4. 审查和整合

当 agents 返回：

Agent 提示词结构

好的 agent 提示词：

1. **专注** — 一个清晰的问题域

2. **自包含** — 理解问题所需的全部上下文

3. **输出具体** — agent 应该返回什么？

修复 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 则修复 abort 实现
   - 如测试的是变化的行为则调整测试期望

不要只加 timeout——找真正的问题。

返回：你发现了什么，修复了什么。

常见错误

**❌ 范围太广：** "修所有测试" — agent 会迷失

**✅ 具体：** "修 agent-tool-abort.test.ts" — 专注范围

**❌ 无上下文：** "修竞态条件" — agent 不知道在哪里

**✅ 有上下文：** 粘贴错误信息和测试名

**❌ 无约束：** Agent 可能重构一切

**✅ 有约束：** "不要改其他代码" 或 "只修测试"

**❌ 输出模糊：** "修好了" — 不知道改了啥

**✅ 输出具体：** "返回根因和变更摘要"

何时不用

**相关失败：** 修一个可能修其他——先一起调查

**需要完整上下文：** 理解需要看到整个系统

**探索性调试：** 还不知道哪里坏了

**共享状态：** Agents 会互相干扰（编辑同一文件、用同一资源）

关键优势

1. **并行化** — 多个调查同时进行

2. **专注** — 每个 agent 范围窄，跟踪的上下文少

3. **独立性** — Agents 不互相干扰

4. **速度** — 3 个问题用 1 个问题的时间解决

验证

Agents 返回后：

1. **审查每个摘要** — 理解改了什么

2. **检查冲突** — Agents 编辑了同一代码吗？

3. **运行完整套件** — 验证所有修复一起工作

4. **抽查** — Agents 可能犯系统性错误