系列前言
如果你正在使用 Claude Code、Cursor 或其他 AI 编程助手,那么 Superpowers 可能会彻底改变你的开发方式。这是一个由 @obra 创建的开源项目,目前已有 65k+ stars,提供了一套完整的 AI 代理技能框架和软件开发方法论。
为什么需要 Superpowers?
大多数 AI 编程助手的问题是:它们太急于写代码了。当你提出一个需求时,AI 往往会立即开始生成代码,而不去深入理解你真正想要什么,也不考虑设计的合理性或测试覆盖。
Superpowers 的核心理念是:在写代码之前,先思考。
它通过 14 个可组合的"技能"(Skills) 来规范 AI 的行为,确保:
- 设计优先 - 在实现之前充分探索需求和设计方案
- 测试驱动 - 严格遵循 RED-GREEN-REFACTOR 的 TDD 流程
- 系统化调试 - 在修复之前必须找到根本原因
- 验证先行 - 用证据而非断言证明成功
- 隔离工作 - 使用 Git Worktrees 保持工作区干净
- 频繁审查 - 早期和持续的代码审查
14 个核心技能概览
| 技能名称 | 触发时机 | 核心作用 |
|---|---|---|
using-superpowers |
开始任何对话时 | 建立技能使用规范 |
brainstorming |
写代码前 | 将模糊想法转化为设计规范 |
writing-plans |
设计确认后 | 创建详细的实现计划 |
subagent-driven-development |
执行计划时 | 使用子代理并行执行任务 |
executing-plans |
有书面计划时 | 在独立会话中执行计划 |
dispatching-parallel-agents |
多个独立任务时 | 分发并行子代理任务 |
test-driven-development |
实现任何功能时 | 强制执行 TDD 流程 |
systematic-debugging |
遇到 bug 时 | 系统化定位根本原因 |
verification-before-completion |
声称完成前 | 验证而非断言成功 |
requesting-code-review |
完成任务时 | 请求代码审查 |
receiving-code-review |
收到审查反馈时 | 技术严谨地处理反馈 |
using-git-worktrees |
开始新功能时 | 创建隔离开发环境 |
finishing-a-development-branch |
完成开发分支时 | 合并/PR/清理决策 |
writing-skills |
创建新技能时 | 编写和测试技能文档 |
本系列教程结构
本系列共 10 篇 详细教程,涵盖从入门到高级的全部内容:
入门篇
- Superpowers 入门与安装 - 在各平台安装配置 Superpowers
- brainstorming:设计优先的开发流程 - 如何将模糊想法转化为清晰设计
- writing-plans:编写可实现的技术方案 - 创建原子化实现计划
核心技能篇
- test-driven-development:TDD 实战指南 - 严格遵循 RED-GREEN-REFACTOR
- systematic-debugging:系统化调试方法 - 四阶段根因追踪流程
- using-git-worktrees:隔离开发工作流 - 并行开发不冲突
协作与审查篇
- 代码审查技能完全指南 - requesting 与 receiving 最佳实践
- subagent-driven-development 与并行任务 - 多代理协作开发
进阶篇
- verification-before-completion 与 finishing-a-branch - 验证与分支管理
- writing-skills:创建你自己的技能 - 扩展技能库完整指南
谁适合学习 Superpowers?
- ✅ AI 编程新手 - 建立正确的 AI 协作习惯
- ✅ 经验丰富的开发者 - 提升 AI 工作流效率
- ✅ 团队技术负责人 - 规范化团队的 AI 使用方式
- ✅ 开源贡献者 - 理解大型项目的 AI 协作模式
前置要求
- 熟练使用至少一个支持 Superpowers 的平台(Claude Code、Cursor、Codex、OpenCode)
- 基本的 Git 操作知识
- 对测试驱动开发有基本了解(不了解也没关系,教程 4 会详细讲解)
如何使用本系列
- 按顺序阅读 - 技能之间有依赖关系,建议按顺序学习
- 实践为主 - 每篇教程都包含实际操作示例
- 循序渐进 - 先掌握核心技能(TDD、调试、规划),再学习高级用法
系列更新计划
- 教程 1-3(入门篇):本周发布
- 教程 4-6(核心技能篇):下周发布
- 教程 7-10(协作与进阶篇):后续两周发布
系列导航:
- → 下一篇:教程 1:Superpowers 入门与安装
仓库地址:github.com/obra/superpowers
讨论区:欢迎在评论区分享你的 Superpowers 使用经验或提出问题!