Subagent Dev

Use when executing implementation plans with independent tasks - coordinates task execution by dispatching subagents per task with verification checkpoints, adapted for OpenClaw's isolated session model

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

使用条件

text

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

流程

每次任务

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

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

2. Dispatch 实现者 subagent

   text

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

3. Subagent 提问处理

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

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

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

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

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

6. 代码质量审查

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

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

任务后

所有任务完成后：

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

模型选择

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

任务类型	示例	模型
机械实现任务	孤立函数、清晰规格、1-2 文件	快速便宜模型
集成和判断任务	多文件协调、模式匹配、调试	标准模型
架构设计和审查任务	需要设计判断或广泛代码库理解	最强模型

处理 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 内按批次执行