Superpowers Skills#

Superpowers Skills 是一个智能开发工作流系统，它通过一系列可组合的"技能"（Skills）来指导 AI 助手更系统化、更高效地完成开发任务。

📚 项目地址：https://github.com/obra/superpowers

核心理念#

理念	描述
测试驱动开发 (TDD)	始终先写测试，再写实现代码
系统化方法	流程优先于猜测，遵循既定步骤
复杂度降低	简单性为主要目标，避免过度设计
证据优先	在声明成功之前先验证结果

基础工作流程 (The Basic Workflow)#

Superpowers 定义了一个标准的开发流程，每个阶段都有对应的 Skill 自动激活：

1. brainstorming 💡#

激活时机：编写代码之前

通过提问细化模糊的想法
探索替代方案
分阶段展示设计以获取验证
保存设计文档供后续参考

2. using-git-worktrees 🌿#

激活时机：设计获批后

在新分支上创建隔离的工作空间
运行项目设置命令
验证干净的测试基线

3. writing-plans 📋#

激活时机：设计获批后

将工作分解为小块任务（每个 2-5 分钟）
每个任务包含：
- 精确的文件路径
- 完整的代码示例
- 明确的验证步骤

4. subagent-driven-development / executing-plans 🤖#

激活时机：计划就绪后

选项 A - Subagent 驱动： - 为每个任务分派全新的子代理 - 两阶段审查：规范合规性 → 代码质量

选项 B - 批量执行： - 按批次执行任务 - 设置人工检查点

5. test-driven-development ✅#

激活时机：实现过程中

强制执行 RED-GREEN-REFACTOR 循环： 1. 编写失败的测试（RED） 2. 观察测试失败 3. 编写最小实现代码 4. 观察测试通过（GREEN） 5. 重构代码 6. 提交更改

⚠️ 注意：删除在测试之前编写的代码

6. requesting-code-review 🔍#

激活时机：任务之间

根据计划审查代码
按严重程度报告问题
关键问题阻止进度继续

7. finishing-a-development-branch 🏁#

激活时机：所有任务完成后

验证所有测试通过
提供处理选项：合并/PR/保留/丢弃
清理 worktree

Skills 库#

🧪 测试类 (Testing)#

Skill	描述
`test-driven-development`	RED-GREEN-REFACTOR 循环（包含测试反模式参考）

🐛 调试类 (Debugging)#

Skill	描述
`systematic-debugging`	四阶段根本原因分析流程
`verification-before-completion`	确保问题真正被修复

systematic-debugging 包含的技术： - root-cause-tracing - 根本原因追踪 - defense-in-depth - 纵深防御 - condition-based-waiting - 基于条件的等待

🤝 协作文档类 (Collaboration)#

Skill	描述
`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`	快速迭代 + 两阶段审查

📐 元技能类 (Meta)#

Skill	描述
`writing-skills`	创建新技能（遵循最佳实践）
`using-superpowers`	Skills 系统入门指南

快速参考表#

技能选择指南#

根据任务类型选择合适的 Skills 组合：

任务类型	Skills 使用顺序
创建新功能	`brainstorming` → `writing-plans` → `executing-plans` → `test-driven-development`
修复 Bug	`systematic-debugging` → `test-driven-development`
重构代码	`brainstorming` → `writing-plans` → `test-driven-development`
代码审查	`requesting-code-review`
并行开发	`using-git-worktrees` → (其他 Skills) → `finishing-a-development-branch`

工作流程图示#

┌─────────────────────────────────────────────────────────────────────────┐
│                        Superpowers 开发流程                              │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  💡 brainstorming ──→ 📋 writing-plans ──→ 🤖 executing-plans          │
│         │                                         │                     │
│         ▼                                         ▼                     │
│  🌿 using-git-worktrees                    ✅ test-driven-development   │
│                                                 │                       │
│                                                 ▼                       │
│                                          🔍 requesting-code-review      │
│                                                 │                       │
│                                                 ▼                       │
│                                          🏁 finishing-branch            │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

关键原则#

Agent 在执行任何任务前都会检查相关 Skills

这些是强制性工作流，而非建议。遵循这些 Skills 可以确保：

一致性 - 所有开发工作遵循相同的标准
可追溯性 - 每个决策都有文档记录
质量保证 - 测试和审查内置于流程中
效率 - 并行处理和子代理分工