Superpowers 工作流全景图

14 个技能 · 7 步核心流程 · 结构化开发

🎯 入口

Using Superpowers

调度器：检查每条消息是否有匹配技能

哪怕只有 1% 的可能性，也必须调用技能

方式 A：执行计划

Executing Plans

独立会话

• 批量执行（每批 3 个任务）
• 批间暂停等待反馈
• 人工检查点

适合：需要人工介入的场景

🔍 系统化调试

Systematic Debugging

4 阶段循环：

1. 观察 — 收集症状和证据
2. 假设 — 基于证据推断根因
3. 验证 — 设计实验验证假设
4. 修复 — TDD 修复 + 回归测试

触发：遇到 bug、测试失败、异常行为

⚡ 并行代理调度

Dispatching Parallel Agents

• 识别独立问题域
• 每个问题派一个代理
• 并行执行，互不干扰
• 汇总结果，检查冲突

触发：2+ 个独立任务/故障 禁用：问题相关、共享状态

✍️ 编写技能

Writing Skills

用 TDD 方法创建新技能：

• 先写技能的验证标准
• 再写技能内容
• 测试技能是否按预期工作

触发：创建/编辑自定义技能

📋 技能使用原则

Using Superpowers

• 刚性技能（TDD、调试）：严格遵循
• 弹性技能（模式）：适应上下文
• 优先级：流程技能 > 实现技能
• 有 checklist → 创建 Todo 逐项完成

1% 可能适用 = 必须调用

2️⃣ 隔离工作区

Git Worktrees

• 检测/创建工作树目录
• 验证 .gitignore
• 安装依赖
• 跑基线测试

原则：不影响主分支

3️⃣ 编写计划

Writing Plans

• 拆成 2-5 分钟小任务
• 每个任务完整 TDD 循环
• 精确文件路径
• 完整代码片段

原则：DRY · YAGNI · TDD

方式 B：子代理驱动

Subagent-Driven Dev

同一会话

• 每任务派独立子代理
• 双重审查：
  • ① 规格合规审查
  • ② 代码质量审查
• 审查不过 → 修复 → 重审

适合：快速迭代

5️⃣ 测试驱动开发

TDD

铁律：没有失败测试就不写代码

🔴 RED → 写失败测试 🟢 GREEN → 最小代码通过 🔵 REFACTOR → 清理

违反？删除代码，重来。

请求审查

Requesting Code Review

• 获取 git diff
• 派发审查子代理
• 审查规格合规 + 代码质量
• 按严重度分级： Critical / Important / Minor

接收审查

Receiving Code Review

禁止： ❌ "你说得对！" ❌ "好建议！"

正确做法： ✅ 技术验证后直接修 ✅ 不对就推回（附理由） ✅ 不确定就问

原则：技术正确 > 社交客套

✅ 完成前验证

Verification

铁律：没跑验证就不能说完成

• 跑测试 → 看输出
• 跑构建 → 看退出码
• 逐项核对需求

❌ "应该没问题" ✅ 证据 → 结论

7️⃣ 完成分支

Finishing Branch

4 个选项：

1. 合并到 main
2. 创建 PR
3. 保持现状
4. 丢弃

清理工作树

1️⃣ 头脑风暴

Brainstorming

• 逐个提问理解需求
• 提出 2-3 种方案
• 获得用户批准
• 写入设计文档

硬门禁：设计未批准前不写代码

搜索