Superpowers 从你启动编码代理的那一刻就开始工作,引导 AI 遵循专业的软件开发流程
当 AI 看到你在构建某些东西时,它不会急于写代码。相反,它会退后一步,询问你真正想要实现什么,通过对话提炼出完整的规格说明。
在提取出规格后,AI 会将设计分成足够短的片段展示给你,让你能够真正阅读和消化,而不是一次性输出大量内容。
AI 会制定一个足够清晰的实施计划,即使是一个没有项目背景、不爱写测试的热情初级工程师也能遵循。强调 TDD、YAGNI 和 DRY。
一旦你说"开始",AI 就会启动子代理驱动开发流程,让子代理完成每个工程任务,检查和审查他们的工作,然后继续前进。
从用户需求到代码交付的全流程可视化
这张图展示了 Superpowers 的完整工作流程:从头脑风暴开始,经过 Git Worktrees 隔离、计划编写、子代理开发、TDD 循环、代码审查、系统化调试,最终完成分支合并。每个步骤都有专门的技能支持,确保 AI 代理遵循最佳实践。
Superpowers 强制执行严格的 TDD 流程。核心原则是:如果你没有看到测试失败,你就不知道它是否测试了正确的东西。
违反规则的字面意思就是违反规则的精神。在测试之前写的代码?删除它,从头开始。
v4.0 引入了革命性的两阶段代码审查系统。每个任务完成后,会进行两轮独立审查:
这解决了常见的失败模式:代码写得很好,但不符合需求。
随机修复浪费时间并创造新的 bug。Superpowers 强制执行系统化的调试流程:
铁律:没有根因调查,不能修复!
| 方法 | 时间 | 首次修复率 |
|---|---|---|
| 系统化调试 | 15-30 分钟 | 95% |
| 随机修复 | 2-3 小时 | 40% |
技能会自动触发,无需特殊操作。你的编码代理就有了超能力。
在写代码之前激活。通过问题提炼粗略想法,探索替代方案,分段展示设计供验证。保存设计文档。
设计批准后激活。在新分支上创建隔离的工作空间,运行项目设置,验证干净的测试基线。
有了批准的设计后激活。将工作分解为小任务(每个2-5分钟)。每个任务都有精确的文件路径、完整代码和验证步骤。
有了计划后激活。为每个任务派遣新的子代理,进行两阶段审查(规格合规性,然后代码质量),或带人工检查点的批量执行。
实施期间激活。强制执行 RED-GREEN-REFACTOR:先写失败的测试,看它失败,写最小代码,看它通过,提交。在测试之前写的代码会被删除。
任务之间激活。根据计划进行审查,按严重性报告问题。关键问题会阻止进度。
任务完成后激活。验证测试,提供选项(合并/PR/保留/丢弃),清理工作树。
Superpowers 包含一套完整的可组合技能,覆盖软件开发的各个方面
Superpowers 建立在这些经过时间验证的软件工程原则之上
始终先写测试。没有看到测试失败,你就不知道它是否测试了正确的东西。
过程优于猜测。随机修复浪费时间并创造新的 bug。
简单性是首要目标。YAGNI - 你不会需要它。
在声明成功之前验证。症状修复是失败。
选择适合你的平台进行安装
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/help
# 应该看到:
# /superpowers:brainstorm - Interactive design refinement
# /superpowers:write-plan - Create implementation plan
# /superpowers:execute-plan - Execute plan in batches
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
详细文档请查看:docs/README.codex.md
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
详细文档请查看:docs/README.opencode.md
技能会在更新插件时自动更新
/plugin update superpowers