SillySpec

Appearance

Superpowers 使用手册 ​

版本: v5.0.5 (2026-03-17) GitHub: https://github.com/obra/superpowersStars: ~99.6K ⭐ 作者: Jesse Vincent (obra) 协议: MIT

一、简介 ​

Superpowers 是一个代理技能框架和软件开发方法论，专门为 AI 编码助手（如 Claude Code、Cursor 等）设计。它通过可组合的 "skills" 强制 AI 遵循高级工程实践，包括需求梳理、TDD、子代理协作等。

核心理念：不让 AI 当"热血实习生"，强制它像高级工程师一样工作——先思考、先规划、先测试，再写代码。

二、核心架构 ​

Superpowers 由 6 个可组合的技能组成：

技能功能
brainstorming需求梳理，不急着写代码，先问清楚要做什么
creating-worktrees创建隔离的 git worktree 开发环境
writing-plans编写详细实现计划
test-driven-development强制 TDD 纪律
subagent-development子代理驱动的开发流程
reviewing代码审查

三、安装 ​

bash
# 方法一：通过 skills CLI 安装
npx skills add obra/superpowers@superpowers -g -y

# 方法二：手动克隆
git clone https://github.com/obra/superpowers.git
# 将 skills/ 目录链接到你的 AI 工具的 skills 目录

四、工作流详解 ​

4.1 阶段一：Brainstorming（需求梳理） ​

当 AI 检测到你在构建某个功能时，它不会直接开始写代码，而是：

  1. 询问你到底想做什么
  2. 提出澄清问题（边界情况、用户场景）
  3. 将讨论内容拆分成足够短的块，让你确认

示例对话：

你：我想给网站加个深色模式
AI：好的，让我问几个问题——
    - 深色模式是用户手动切换还是跟随系统？
    - 需要记住用户偏好吗？
    - 所有页面都要支持还是只有部分？
    - 跟现有的主题系统怎么集成？

4.2 阶段二：创建 Worktree（隔离环境） ​

bash
# Superpowers 自动创建 git worktree
# 在隔离分支上开发，不影响主分支
git worktree add ../project-dark-mode feature/dark-mode

4.3 阶段三：Writing Plans（编写计划） ​

AI 编写实现计划，假设执行者是：

  • 熟练的开发者
  • 但对你的项目零上下文
  • 品味存疑
  • 不爱写测试

计划包含：

  • 每个任务要改哪些文件
  • 具体代码思路
  • 测试策略
  • 依赖关系

计划保存到：docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md

4.4 阶段四：TDD 执行（严格纪律） ​

铁律：没有失败测试，不写一行代码。

RED（红）   → 写测试，看它失败
GREEN（绿） → 写最少代码让它通过
REFACTOR    → 清理代码

违反规则？删代码，从头来。不能保留为"参考"。

4.5 阶段五：Subagent Development（子代理开发） ​

AI 派出子代理逐个完成任务：

  • 每个任务有独立上下文
  • 完成后自动审查
  • 可以自主工作数小时不跑偏

4.6 阶段六：Review（代码审查） ​

所有任务完成后，进行最终审查：

  • 代码质量检查
  • 测试覆盖率确认
  • 与原始规范对照

五、最佳实践 ​

  1. 模型选择：推荐高推理能力模型（Claude Opus 4.5、GPT 5.2）
  2. 上下文管理：每个新功能开始前清空上下文
  3. 不要跳过步骤：即使觉得需求很简单，也走完 brainstorming
  4. 小改动可以简化：修 typo 等可以跳过完整流程
  5. 频繁提交：每个任务完成后 commit

六、与其他工具的区别 ​

维度Superpowers普通提示词
TDD强制执行靠自觉
计划自动生成手动写
上下文隔离worktree 自动隔离容易污染
自主性可自主工作数小时容易跑偏
代码质量有审查机制无保障

七、常见问题 ​

Q: Superpowers 只能用于 Claude Code 吗？ A: 不是，它支持 20+ AI 编码工具，包括 Cursor、Copilot、Gemini CLI 等。

Q: 会拖慢开发速度吗？ A: 短期会多花时间在规划上，但长期减少了返工和调试时间，整体更快。

Q: 小项目需要吗？ A: 小修小改可以跳过。但如果你发现 AI 经常写出需要大量返工的代码，建议使用。

八、参考资料 ​

文档整理时间：2026-03-20 | 基于 Superpowers v5.0.5