Skip to content

Superpowers 系列(一):行为控制面

只把 Superpowers 看成一组 Skills,很容易误判它的价值。真正关键的不是它有 brainstorming、TDD、debugging、code review 这些技能,而是它把这些技能组织成了一套“行为控制面”:Agent 在什么时候能行动、什么时候必须暂停、什么时候需要证据、什么时候不能自己做决定。

总览已经说明了 Superpowers 的整体目标和阅读路线;本篇只收窄到第一个问题:为什么这些 Skills 组合起来,会形成一个行为控制面。

Agent 默认行为的问题不是不会做,而是太会做

编码 Agent 的失败经常不是能力不足。相反,很多失败来自它太快进入“我可以做”的状态。

典型动作链是:

text
收到目标 -> 自行解释目标 -> 快速读代码 -> 直接实现 -> 事后补测试和解释

这条链路在人类看来很积极,但对协作系统来说有几个风险:

  • 目标解释没有外化,用户不知道 Agent 实际理解了什么。
  • 实现前没有硬门禁,简单任务会绕过确认,复杂任务会带着假设推进。
  • 验证动作发生太晚,测试容易服务于既有实现,而不是约束预期行为。
  • 完成声明过早,Agent 会把“改了代码”“子代理说成功”“局部命令通过”包装成整体完成。
  • 多 Agent 参与后,上下文和责任边界容易混在一起。

Superpowers 的控制面,就是围绕这些风险建立的一组拦截点。

控制面由四类机制组成

Superpowers 的机制可以抽象成四层。

控制层解决的问题典型机制
入口控制Agent 在没有方法约束时先行动会话启动注入 using-superpowers,要求任何动作前先检查 Skill
意图控制Agent 把自己的理解当成用户确认brainstorming 的分级路径、设计展示、批准门禁
执行控制Agent 按模糊计划自由发挥spec、plan、task brief、worktree、ledger、subagent review
证据控制Agent 用语言声明替代验证TDD、系统调试、完成前验证、代码审查和分支收尾

这四层不是平铺的工具箱,而是一条逐步收紧的链路。入口控制先阻止无约束起手;意图控制把目标外化;执行控制把目标转成低上下文任务;证据控制防止“看起来完成”冒充“可证明完成”。

它不是普通提示词增强

这里要区分两个概念:提示词增强和行为控制面。

提示词增强通常告诉 Agent “你应该认真、谨慎、先计划”。这类提示有帮助,但它没有把行为拆成可触发、可检查、可恢复的动作。Superpowers 管的是具体工程行为,例如:

  • 先找 Skill 再行动。
  • 先设计再实现。
  • 先写失败测试再写生产代码。
  • 先查根因再修 bug。
  • 先验证再声明完成。
  • 先审查再推进。

这些动作分散在不同 Skill 中,但它们围绕同一个目标:不要让 Agent 只靠自觉维持工程纪律。触发条件、硬门禁、反模式表格和验证命令共同组成了控制面。

稳定性来自“反默认行为”设计

Superpowers 的很多规则看起来很硬,比如“实现前必须先得到批准”“没有失败测试就不能写生产代码”“没有新鲜验证就不能声明完成”。这些规则不是为了制造仪式,而是为了反制 Agent 的默认倾向。

Agent 会倾向于:

  • 用推理替代确认;
  • 用上下文记忆替代持久记录;
  • 用局部验证替代完整证据;
  • 用自我审查替代独立审查;
  • 用顺手修复替代根因调查。

Superpowers 的 Skill 不是普通建议,而是把这些倾向变成 Red Flags、Iron Law、Gate Function、Common Rationalizations。更值得注意的是,它不只是说“应该怎么做”,还预判了 Agent 会怎样说服自己跳过规则。

行为控制面的判断方法

判断一组 Skill 是否只是工具箱,还是已经形成控制面,可以看五个问题:

  • 它是否改变 Agent 的起手动作,而不只是增加一个可选能力。
  • 它是否把用户意图、计划、验证和交付决策外化成可检查对象。
  • 它是否为常见绕过理由设计了拦截规则。
  • 它是否能在长任务中恢复,而不是只依赖当前上下文窗口。
  • 它是否把“完成”绑定到证据,而不是绑定到实现者叙事。

按这个标准看 Superpowers,它的重点不是 Skill 数量,而是控制点之间的组合关系。using-superpowers 管起手,brainstorming 管意图,writing-plans 管执行契约,subagent-driven-development 管上下文和审查,TDD 与 verification 类 Skill 管证据。README 的 Basic Workflow 只是表层顺序,真正的控制面来自这些节点对 Agent 默认行为的连续改写。

如果要用一句话概括:Superpowers 不是把 Agent 变聪明,而是把 Agent 的聪明放进一套不会轻易漂移的工程动作里。


参考资料

下面的源码链接固定到同一提交版本,避免后续仓库变化影响阅读和复核。

系列导航