核心用法
Superpowers Subagent 开发技能专为 OpenClaw 平台适配,采用"主代理控制器 + 独立子代理执行"的架构模式。核心流程包括:读取实现计划并提取任务清单 → 使用 sessions_spawn(mode="run") 分派一次性任务子代理 → 处理子代理提问并提供上下文 → 子代理完成实现、测试、提交与自审 → 主会话执行两阶段审查(先规格合规,后代码质量)→ 标记完成并迭代下一任务。所有任务结束后执行最终代码审查并调用收尾技能。
显著优点
隔离性与可靠性:每个任务使用全新子代理,上下文精确控制,避免会话历史污染和跨任务干扰。两阶段审查机制:规格合规审查确保实现符合计划要求,代码质量审查保障 DRY、命名规范与测试设计,形成双重质量闸门。成本优化策略:根据任务复杂度选择最弱可用模型(机械实现用快速便宜模型、架构设计用最强模型),显著降低推理成本。状态机驱动的异常处理:DONE、DONE_WITH_CONCERNS、NEEDS_CONTEXT、BLOCKED 四种状态定义清晰,配套针对性升级策略,避免无效重试。
潜在缺点与局限性
平台依赖性:核心机制依赖 OpenClaw 的 sessions_spawn 实现,迁移至原生 Claude Code 级联模型时需重新适配。串行执行瓶颈:明确禁止同时分派多个实现子代理(避免冲突),强制顺序执行限制了并行吞吐量。审查成本隐性累积:两阶段审查均在主会话或额外子代理中执行,复杂项目可能产生显著的审查开销。上下文传递复杂度:子代理不继承会话历史,主代理需精确构造上下文,对使用者的任务拆解能力要求较高。
适合人群
适用于需要严格执行实现计划、对代码质量有高标准要求、且能接受串行执行以换取可靠性的开发场景。特别适合中小型模块化任务、TDD 驱动开发、以及需要与 superpowers-writing-plans、superpowers-tdd、superpowers-finishing-branch 形成工作流闭环的团队。
常规风险
分支风险:技能明确警示绝不在 main/master 分支直接开发。审查顺序风险:规格合规未通过前启动代码质量审查属于"Red Flag"级错误。近似合规陷阱:审查发现问题必须进入修复-重审循环,不可接受"差不多"状态。子代理升级失败风险:BLOCKED 状态下若忽略模型升级或任务拆分建议,将导致无限重试循环。