Superpowers Subagent 开发（OpenClaw 适配版）

概述

通过为每个任务 dispatch 独立 subagent 来执行计划，每个任务后进行两阶段审查：先审查规格合规，再审查代码质量。

为什么用 subagent： 将任务委托给专门 agent，隔离上下文。通过精确构造指令和上下文，确保它们专注并成功完成。Subagent 不应继承 session 历史——精确构造它们需要的上下文。

核心原则： 每个任务新鲜 subagent + 两阶段审查（规格合规 → 代码质量）

OpenClaw 适配说明

Superpowers 原版设计基于 Claude Code 的 Task/subagent 级联模型。OpenClaw 使用 sessions_spawn 创建独立 session，无法做到原生级联。

OpenClaw 适配方案：

• 主 agent 作为 controller，协调所有工作
• 用 sessions_spawn(mode="run") dispatch 一次性任务 subagent
• Subagent 结果通过 session 历史或文件系统传递
• 审查在主 session 内 inline 执行（或 spawn 独立审查 session）
• 复杂审查任务用 sessions_spawn

使用条件

有实现计划？
  → 任务大多独立？
    → 在本 session 内工作？
      → 用 subagent-dev（这个技能）
    → 并行独立 session？
      → 用 sessions_spawn 并行 dispatch
  → 手动执行或先 brainstorming

流程

每次任务

1. 读取计划，提取所有任务

   • 读取计划文件一次
   • 提取所有任务及其完整文本和上下文
   • 创建任务列表

2. Dispatch 实现者 subagent

   code

   使用 sessions_spawn:
   - mode: "run"（一次性任务）
   - task: 完整任务文本 + 上下文
   - cwd: 项目目录
   

3. Subagent 提问处理

   • 如果 subagent 提问 → 回答问题，提供上下文
   • 重新 dispatch 或继续

4. Subagent 实现、测试、commit、自审

   • 实现者完成工作
   • 运行测试
   • Commit
   • 自审

5. 规格合规审查（主 session inline 或 spawn）

   • 检查实现是否满足计划中的规格
   • 发现问题 → 反馈给实现者修复 → 重新审查
   • 通过 → 继续

6. 代码质量审查

   • 检查代码质量：DRY、命名、测试设计
   • 发现问题 → 修复
   • 通过 → 继续

7. 标记任务完成，继续下一个

任务后

所有任务完成后：

• 做最终代码审查
• 调用 superpowers-finishing-branch 完成工作

模型选择

用能处理任务的最弱模型，节省成本增加速度：

处理 Subagent 状态

Subagent 报告四种状态之一。适当处理：

DONE： 继续规格合规审查。

DONE_WITH_CONCERNS： 实现者完成但标记了疑虑。先读关注点再继续。如果关注点涉及正确性或范围，先解决再审查。

NEEDS_CONTEXT： 实现者需要未提供的信息。提供缺失上下文并重新 dispatch。

BLOCKED： 实现者无法完成任务。评估阻塞：

1. 如果是上下文问题，提供更多上下文并用相同模型重新 dispatch
2. 如果任务需要更多推理，用更强模型重新 dispatch
3. 如果任务太大，拆成更小的块
4. 如果计划本身有问题，上报给主人

永远不要忽略升级或强制相同模型重试而不做变更。

Red Flags

永远不要：

• 在 main/master 分支上开始实现（没有主人明确同意）
• 跳过审查（规格合规或代码质量）
• 有未修复问题时继续
• 同时 dispatch 多个实现 subagent（冲突）
• 让 subagent 读计划文件（直接提供完整文本）
• 跳过场景设置上下文（subagent 需要理解任务在哪里_fit）
• 忽略 subagent 的提问（先回答再让他们继续）
• 接受"差不多"的规格合规（审查发现问题 = 没完成）
• 跳过审查循环（审查发现问题 = 实现者修复 = 重新审查）
• 让实现者自审替代实际审查（两者都需要）
• 在规格合规通过前开始代码质量审查（顺序错误）
• 有公开问题时继续下一个任务

集成

必需的工作流技能：

• superpowers-writing-plans — 创建这个技能执行的计划
• superpowers-finishing-branch — 所有任务完成后的收尾
• superpowers-tdd — Subagent 每个任务遵循 TDD

替代工作流：

• sessions_spawn 并行 dispatch — 用于独立问题的并行调查
• 顺序执行 — 在主 session 内按批次执行