AI Coding Workflow System

Superpowers

为 AI 编码代理赋予超能力的完整软件开发工作流系统。从头脑风暴到代码审查,让你的 AI 助手遵循专业的开发规范,自主工作数小时而不偏离计划。

14+ 专业技能
TDD 测试驱动
MIT 开源协议

它是如何工作的?

Superpowers 从你启动编码代理的那一刻就开始工作,引导 AI 遵循专业的软件开发流程

🧠

先理解,再编码

当 AI 看到你在构建某些东西时,它不会急于写代码。相反,它会退后一步,询问你真正想要实现什么,通过对话提炼出完整的规格说明。

📝

分块展示设计

在提取出规格后,AI 会将设计分成足够短的片段展示给你,让你能够真正阅读和消化,而不是一次性输出大量内容。

📋

清晰的实施计划

AI 会制定一个足够清晰的实施计划,即使是一个没有项目背景、不爱写测试的热情初级工程师也能遵循。强调 TDD、YAGNI 和 DRY。

🤖

子代理驱动开发

一旦你说"开始",AI 就会启动子代理驱动开发流程,让子代理完成每个工程任务,检查和审查他们的工作,然后继续前进。

完整工作流程

从用户需求到代码交付的全流程可视化

🗺
Superpowers 完整工作流程图

这张图展示了 Superpowers 的完整工作流程:从头脑风暴开始,经过 Git Worktrees 隔离、计划编写、子代理开发、TDD 循环、代码审查、系统化调试,最终完成分支合并。每个步骤都有专门的技能支持,确保 AI 代理遵循最佳实践。

Superpowers 完整工作流程图
核心技能

测试驱动开发 (TDD)

Superpowers 强制执行严格的 TDD 流程。核心原则是:如果你没有看到测试失败,你就不知道它是否测试了正确的东西。

违反规则的字面意思就是违反规则的精神。在测试之前写的代码?删除它,从头开始。

  • RED - 写一个失败的测试,观察它失败
  • GREEN - 写最小代码让测试通过
  • REFACTOR - 保持测试绿色的同时优化代码
  • 测试必须是最小的、清晰的、展示意图的
  • 不要过度工程化,只写通过测试所需的代码
TDD RED-GREEN-REFACTOR 循环
子代理驱动开发流程
v4.0 新特性

子代理驱动开发 + 两阶段审查

v4.0 引入了革命性的两阶段代码审查系统。每个任务完成后,会进行两轮独立审查:

  • 规格合规审查 - 怀疑性审查员验证实现是否完全匹配规格
  • 代码质量审查 - 只有在规格审查通过后才进行
  • 审查是循环的:发现问题 → 修复 → 再审查
  • 每个任务派遣新的子代理,避免上下文污染
  • 子代理可以在工作前和工作中提问

这解决了常见的失败模式:代码写得很好,但不符合需求。

系统化方法

系统化调试:4阶段流程

随机修复浪费时间并创造新的 bug。Superpowers 强制执行系统化的调试流程:

铁律:没有根因调查,不能修复!

  • Phase 1 - 根因调查:读错误、复现、检查改动、收集证据
  • Phase 2 - 模式分析:找工作例子、对比参考、识别差异
  • Phase 3 - 假设测试:形成假设、最小测试、一次一变量
  • Phase 4 - 实施:写失败测试、单一修复、验证
方法 时间 首次修复率
系统化调试 15-30 分钟 95%
随机修复 2-3 小时 40%
系统化调试4阶段流程

基本工作流

技能会自动触发,无需特殊操作。你的编码代理就有了超能力。

1

Brainstorming 头脑风暴

在写代码之前激活。通过问题提炼粗略想法,探索替代方案,分段展示设计供验证。保存设计文档。

2

Git Worktrees 工作树

设计批准后激活。在新分支上创建隔离的工作空间,运行项目设置,验证干净的测试基线。

3

Writing Plans 编写计划

有了批准的设计后激活。将工作分解为小任务(每个2-5分钟)。每个任务都有精确的文件路径、完整代码和验证步骤。

4

Subagent Development 子代理开发

有了计划后激活。为每个任务派遣新的子代理,进行两阶段审查(规格合规性,然后代码质量),或带人工检查点的批量执行。

5

Test-Driven Development 测试驱动开发

实施期间激活。强制执行 RED-GREEN-REFACTOR:先写失败的测试,看它失败,写最小代码,看它通过,提交。在测试之前写的代码会被删除。

6

Code Review 代码审查

任务之间激活。根据计划进行审查,按严重性报告问题。关键问题会阻止进度。

7

Finishing Branch 完成分支

任务完成后激活。验证测试,提供选项(合并/PR/保留/丢弃),清理工作树。

内置技能

Superpowers 包含一套完整的可组合技能,覆盖软件开发的各个方面

🧪

测试

test-driven-development
RED-GREEN-REFACTOR 循环,包含测试反模式参考
🐛

调试

systematic-debugging
4阶段根本原因分析流程,包含根因追踪、纵深防御、条件等待技术
verification-before-completion
确保问题真正修复后再声明完成
🤝

协作

brainstorming
苏格拉底式设计精炼
writing-plans
详细的实施计划编写
executing-plans
带检查点的批量执行
dispatching-parallel-agents
并发子代理工作流
requesting-code-review
预审查检查清单
receiving-code-review
响应反馈的流程
using-git-worktrees
并行开发分支管理
finishing-a-development-branch
合并/PR 决策工作流
subagent-driven-development
快速迭代与两阶段审查(规格合规+代码质量)
📚

元技能

writing-skills
按最佳实践创建新技能,包含测试方法论
using-superpowers
技能系统入门介绍

核心原则

Superpowers 建立在这些经过时间验证的软件工程原则之上

🧪

测试驱动开发

始终先写测试。没有看到测试失败,你就不知道它是否测试了正确的东西。

📊

系统化优于临时

过程优于猜测。随机修复浪费时间并创造新的 bug。

复杂度削减

简单性是首要目标。YAGNI - 你不会需要它。

🔍

证据优于声明

在声明成功之前验证。症状修复是失败。

安装指南

选择适合你的平台进行安装

1 注册市场

Claude Code
/plugin marketplace add obra/superpowers-marketplace

2 安装插件

Claude Code
/plugin install superpowers@superpowers-marketplace

3 验证安装

Claude Code
/help

# 应该看到:
# /superpowers:brainstorm - Interactive design refinement
# /superpowers:write-plan - Create implementation plan
# /superpowers:execute-plan - Execute plan in batches

1 告诉 Codex

Codex
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
📖

详细文档请查看:docs/README.codex.md

1 告诉 OpenCode

OpenCode
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
📖

详细文档请查看:docs/README.opencode.md

🔄

更新插件

技能会在更新插件时自动更新

Claude Code
/plugin update superpowers

关于作者

👨‍💻

Jesse Vincent

开源软件开发者,Superpowers 项目创始人。如果 Superpowers 帮助你做了赚钱的事情,欢迎考虑赞助我的开源工作。