Superpowers 工作流是一个从想法到合并的完整开发流程,6个环节环环相扣,每个环节都有明确的产出和门禁。

1. brainstorming — 需求设计

干什么:在写任何代码之前,先把需求想清楚。

  • 探索项目上下文(现有代码、技术栈、约定)
  • 一个一个问题澄清需求(每次只问一个,避免信息过载)
  • 提出 2-3 种方案,说明优劣和推荐
  • 分段展示设计,逐段获取用户确认

 

门禁:用户批准设计后才进入下一步。绝不跳过,哪怕需求"很简单"。

产出:
docs/superpowers/specs/YYYY-MM-DD-xxx-design.md

2. writing-plans — 实现计划

干什么:把设计文档变成可执行的、逐步骤的实现计划。

  • 定义文件结构和每个文件的职责
  • 拆成 2-5 分钟一个的微小步骤
  • 每步包含完整代码(不是"TODO"或"稍后实现")
  • 假设执行者零上下文,必须自包含

 

门禁:自审通过(无占位符、无矛盾、全覆盖 spec)。

产出:
docs/superpowers/plans/YYYY-MM-DD-xxx.md

3. using-git-worktrees — 隔离工作区

干什么:创建独立分支的工作区,保护主分支不受影响。

  • 检测是否已在隔离环境中
  • 优先使用平台原生工具,回退到 git worktree add
  • 验证 .worktrees/ 已被 .gitignore 忽略
  • 安装依赖,确保基线测试通过

产出:.worktrees//

4. subagent-driven-development — 逐任务实现

干什么:按计划逐任务执行,每个任务经过两级审查。

 

每任务流程:

  • 派发实现子代理 — 独立上下文,只接收任务文本和必要上下文
  • Spec 合规审查 — 逐行对照 spec,检查缺失/多余/误解
  • 代码质量审查 — 检查逻辑正确性、风格一致性、命名质量
  • 审查不通过 → 修复 → 重新审查,直到通过
  • Commit,进入下一任务

5. verification-before-completion — 完成前验证

干什么:在声称"完成"之前,拿出证据。

  • 运行测试命令,读取完整输出,确认退出码
  • JS 语法检查、DOM 引用完整性、构建产物
  • 铁律:没有新鲜验证证据 = 不能声称完成

 

反例:"应该好了"、"看起来没问题"、"上次跑过了" — 全部无效。

6. finishing-a-development-branch — 收尾

干什么:决定代码的去向。

  • 4 个选项:合并回主分支 / 创建 PR / 保留不动 / 丢弃
  • 选择合并或丢弃时自动清理 worktree 和分支
  • 选择 PR 时保留 worktree 以便迭代反馈

 

门禁:丢弃操作需要用户输入 discard 确认。

流程总览

想法 → 设计文档 → 实现计划 → 隔离工作区 → 逐任务实现+审查 → 验证 → 合并/PR

核心原则:先想清楚再动手、每步可验证、绝不跳过审查、证据先于断言。

点赞(0)

评论列表 共有 0 条评论

暂无评论
立即
投稿
发表
评论
返回
顶部