超级能力 — OpenClaw版本

改编自obra/superpowers。强制性工作流程 — 非建议。

流水线

Idea → Brainstorm → Plan → Subagent-Driven Build (TDD) → Code Review → Finish Branch

每个编码任务都遵循此流水线。“太简单而不需要设计”永远是错误的。

阶段一：头脑风暴

触发条件：用户想要构建某些东西。在接触任何代码之前激活。

参见： references/brainstorming.md

概要：

1. 探索项目背景（文件、文档、近期提交）
2. 提出澄清性问题 —一次一个，优先使用多项选择
3. 提出2-3种方法，包含权衡利弊 + 推荐方案
4. 分部分呈现设计，每部分后获取批准
5. 撰写设计文档 →docs/plans/YYYY-MM-DD-<主题>-design.md→ 提交
6. 转交至第二阶段：编写计划

硬性要求：在用户批准设计前，请勿编写任何代码。

第二阶段：编写计划

触发条件：设计已获批准。由头脑风暴阶段激活。

参见： 参考资料/编写计划.md

概要：

• 编写一份详细的任务分解实施计划
• 每个任务 = 2-5分钟：编写测试 → 观察失败 → 实施 → 观察通过 → 提交
• 保存至文档/计划/YYYY-MM-DD-<功能>.md
• 宣布："我正在使用编写计划技能来创建实施计划。"
• 保存后，提供两种执行模式：
  • 子代理驱动（当前会话）： 为每个任务启动会话并进行两阶段审查
  • 手动执行：用户自行运行任务

第三阶段：子代理驱动开发

触发条件：计划已存在，用户选择子代理驱动执行。

参见： references/subagent-development.md

每任务循环（OpenClaw）：

1. sessions_spawn一个实现者子代理，包含任务及完整计划上下文
2. 等待完成通知
3. sessions_spawn一个规格审查员子代理 → 必须确认代码符合规格
4. sessions_spawn一个代码质量审查员子代理 → 必须批准质量
5. 修复任何问题，必要时重新审查
6. 标记任务完成，移至下一个
7. 最终：派遣整体代码审查员 → 移交至第五阶段

每个任务中测试驱动开发（TDD）是强制性的。参见references/tdd.md。

阶段四：系统性调试

触发条件：程序错误、测试失败、意外行为——任何技术问题。

参见： references/systematic-debugging.md

硬性要求：未经根本原因调查，不得进行修复。

四个阶段：

1. 根本原因调查（阅读错误信息、复现问题、检查近期变更、追踪数据流）
2. 模式分析（寻找成功案例、进行对比、识别差异）
3. 假设与测试（每次仅验证一个假设，通过测试证实或证伪）
4. 修复与验证（从根源修复而非表象；验证修复不会引发新问题）

阶段五：完成分支开发

触发条件：所有任务完成，全部测试通过。

参见： references/finishing-branch.md

概要：

1. 确认所有测试通过
2. 确定基准分支
3. 提供四个选项：本地合并 / 推送+拉取请求 / 保留 / 丢弃
4. 执行选择
5. 清理

OpenClaw 子代理调度模式

当调度执行者或审查者子代理时，使用sessions_spawn：

Goal: [one sentence]
Context: [why it matters, which plan file]
Files: [exact paths]
Constraints: [what NOT to do — no scope creep, TDD only]
Verify: [how to confirm success — tests pass, specific command]
Task text: [paste full task from plan]

运行sessions_spawn并将任务作为详细提示。子代理会自动宣布结果。

核心原则

• 一次只处理一个问题在头脑风暴期间
• 始终坚持测试驱动开发——先写失败的测试，删除在测试之前编写的代码
• 你不会需要它——从所有设计中移除不必要的功能
• 不要重复自己——杜绝重复
• 系统化优于临时方案——遵循流程，尤其是在时间压力下
• 证据优于断言— 在宣布成功前先验证
• 频繁提交— 每次测试通过后