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
核心原则:先想清楚再动手、每步可验证、绝不跳过审查、证据先于断言。
发表评论 取消回复