与SpecKit、OpenSpec的对比

https://github.com/obra/superpowers

  • Superpowers：给 AI 代理定 “干活的规矩与技能”（怎么干），偏执行层 / 工作流强制框架。
  • SpecKit：GitHub 官方的 “重型规范驱动框架”（按什么规矩干），强流程、强文档、适合大型 / 从零开始项目。
  • OpenSpec：社区驱动的 “轻量规范驱动框架”（改了什么、如何共识），灵活、适合存量 / 快速迭代项目。

OpenSpec和SpecKit作为SDD开发范式，目的是让模型在执行任务的时候，有据可依，从而有效避免产生幻觉。

Superpowers是一个全自动开发工作流，其运行逻辑，和传统的SDD完全不同。

SDD趋向于将创意或者对话，转化为结构化的技术规范，以及供AI编程Agent执行的任务清单。

Superpowers的功能更进一步，它为AI提供了一套完整的开发工作流。它能自动引导AI完成头脑风暴、设计，并生成技术规范，制定详细的实施计划。

安装Superpowers

  • 在 Claude Code 中安装 Superpowers
    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 先打开claude，然后通过应用商店安装


    # superpowers不在官方商店，所以要先添加Superpowers专用商店
    /plugin marketplace add obra/superpowers-marketplace
    # 从Superpowers专用商店安装商Superpowers插件 安装的时候会让你选择skill的生效范围
    /plugin install superpowers@superpowers-marketplace
    # 执行 `/reload-plugins` 来加载插件里的 Skill
    /reload-plugins

其他AI编程Agent上安装Superpowers的方式，详见github

这里可能会有疑问，明明是安装Skill，怎么变成安装插件了
要装的确实是 Skill，但在 Claude Code 里，Skill 必须 “打包成 Plugin” 才能用命令安装。

一句话厘清关系

  • Skill = 具体技能（比如 /brainstorming、/tdd、/debug）Claude
  • Plugin = 技能包 / 安装包，把一堆 Skill 打包在一起，方便分发和一键安装
  • Superpowers = 一个 Plugin，里面包含了一整套 Skill

注意
默认 /skills 只扫描用户目录和项目目录的 .claude/skills/*.md ，中定义的技能。Superpowers插件里的Skill是插件自带的内置指令，他们不会出现在 /skills/ 目录下

Superpowers 不是一个简单的「提示词合集」，它是一套完整的软件开发方法论，通过可组合的技能 (Skills) 驱动 AI 按照工程最佳实践工作。

案例

  • 需求提示词
    设计一个苹果UI风格的纯网页待办清单，数据存储在浏览器，使用React技术栈，不对接后端接口。

头脑风暴 /brainstorming

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
❯ /superpowers:brainstorming 设计一个苹果UI风格的纯网页待办清单，数据存储在浏览器，使用React技术栈，不对接后端接口。    
                                                                                                                        
⏺ 好的，这是一个空目录的全新项目。已了解基本信息：                                                                      
                                                                                                                        
  - 技术栈: React                                                                                                       
  - 样式: 苹果UI风格                                                                                                    
  - 数据: 浏览器本地存储 (localStorage)                                                                                 
  - 无后端: 纯前端                                                                                                      
                                                                                                                        
  ---                                                                                                                   
  先问一个关键问题来确定功能范围：                                                                                      
                                                                                                                        
  你希望这个待办清单支持多层级任务结构吗？                                                                              
                                                                                                                        
  - A) 简单列表 — 只有一层，所有任务平铺显示，类似 iPhone 提醒应用的"列表"视图                                          
  - B) 分组+任务 — 可以创建多个列表/分组，每个列表下有任务，类似 Apple 提醒应用的完整功能                               
  - C) 层级任务 — 任务可以嵌套子任务，形成树状结构

接下去，还会有很多一轮轮需求确认的过程，还会有技术设计确认的过程

确认完后的需求与设计稿，会保存下来

对于这份生成的设计文档，我们一定要重点查看里面的内容，不管是需求，还是设计，还是任务拆分，是否符合我们预期。
如果不如何，也优先通过claude去修改，而不是自己直接修改。

实现计划 /writing-plans

头脑风暴结束后，我们可以根据提示，直接 确认，也可以手动 以 /writing-plans 命令的方式触发

最终结束，生成了一份实施方案

并且提供了两种执行方案

方案 特点 适用场景 推荐度
1. Subagent-Driven（推荐） 每个任务都启动一个独立的子 Agent 执行，
任务之间可以人工 Review，迭代更快		 复杂项目、需要分模块开发、想控制每个步骤的质量 ⭐⭐⭐⭐⭐
2. Inline Execution 在当前会话里一次性执行所有任务，
用 executing-plans 批量跑，带检查点		 简单项目、信任整体流程、不想被打断 ⭐⭐⭐

我选择 1 的方式往下执行


执行过程中错了怎么办？

退出会话，修改实施计划，然后用自然语言让Superpowers重新执行

其他