Superpowers

Superpowers是一个AI编程技能框架，通过强制TDD、代码审查和需求澄清等工程实践，让AI编程代理像资深工程师一样工作。

收录时间：

2026-04-01

Superpowers

打开网站

一、从需求澄清到代码提交：Superpowers如何实现端到端AI软件开发？

Superpowers是一个开源的代理技能框架和软件开发方法论，专为AI编程代理（如Claude Code、Cursor、Codex、OpenCode、Gemini CLI）设计。它不是简单的代码生成器，而是一套将30年软件工程经验压缩成AI能自动触发的技能系统。

核心定位：让AI编程代理像资深工程师一样工作，而不是像”没有经验的初级工程师”那样随意行事。根据GitHub数据，截至2026年3月底，Superpowers已积累超过12.4万Star，Fork数接近1万，GitHub全球仓库排名第59位。

Superpowers核心能力

Superpowers是一个为AI编程代理设计的完整软件开发工作流系统，基于可组合的”技能”构建。它强制AI在编码前先澄清需求、制定计划，执行时遵循测试驱动开发（先写失败测试再写代码），完成后进行两阶段代码审查。支持Git Worktree环境隔离、子代理并行执行，覆盖从头脑风暴到代码提交的全流程，显著提升AI生成代码的生产可用性。

Superpowers关键信息列表

维度	描述
项目名称	Superpowers
开发者	Jesse Vincent (obra)
开源协议	MIT
GitHub Star	12.4万+ (截至2026年3月)
最新版本	v5.0.6 (2026年3月25日发布)
支持平台	Claude Code、Cursor、Codex、OpenCode、Gemini CLI
核心技能数量	14个核心技能
项目增长	单日最高增长2,230 Star
官方插件市场安装量	23万次+

解决的核心问题

根据Stack Overflow 2025年调查，84%的开发者已在使用AI编程工具，但DX对13.5万名开发者的研究发现，AI生成的代码在PR审查中被打回的概率是人工代码的1.7倍。Superpowers正是为解决AI编程的以下痛点而生：

需求理解偏差：AI一拿到需求就写代码，跳过需求澄清环节
跳过测试：直接写功能代码，测试成为事后补丁
缺乏审查：没有代码质量把关机制
上下文污染：长对话导致早期决策影响后续输出
工程纪律缺失：缺乏TDD、YAGNI、DRY等原则约束

二、Superpowers的主要功能和特点

1. 技能系统架构

Superpowers的核心是技能(Skills)系统，每个技能都是一个Markdown文件(SKILL.md)，定义了特定场景下的严格规则。AI在处理任务时必须先检查并调用相关技能，这不是建议而是强制要求。

技能三大特性：

自动触发：根据上下文智能激活，即使只有1%可能性适用
可组合：多个技能协同工作，形成完整工作流
强制执行：不符合规范则阻止继续，拒绝”简单问题就不用”的借口

2. 14个核心技能详解

Superpowers包含14个核心技能，分为协作、测试、调试、版本控制四大类别：

类别	技能名称	核心功能
系统	using-superpowers	技能路由引擎，所有对话的入口
系统	writing-skills	创建新技能的系统技能
协作	brainstorming	苏格拉底式需求精炼，生成设计文档
协作	writing-plans	生成2-5分钟粒度的详细实施计划
协作	executing-plans	批量执行含人工检查点
协作	dispatching-parallel-agents	并发子代理工作流
协作	subagent-driven-development	子代理驱动开发，含两阶段Code Review
协作	requesting-code-review	提交代码审查前的自查清单
协作	receiving-code-review	响应代码审查反馈的流程
测试	test-driven-development	强制RED-GREEN-REFACTOR循环
调试	systematic-debugging	4阶段根因分析流程
调试	verification-before-completion	确认问题真正被修复
版本控制	using-git-worktrees	使用Git Worktree进行并行开发
版本控制	finishing-a-development-branch	合并或创建PR的决策工作流

3. 关键技术特点

（1）流程图作为可执行规范

技能文件使用DOT语法定义决策流程图，这不是装饰性的，而是AI必须遵循的权威定义。解决了”描述覆盖流程图”的陷阱——如果技能描述中包含工作流摘要，AI会跟随简短描述而忽略详细流程图。

（2）反合理化设计

using-superpowers技能中专门列出了AI常见的逃避借口及其反驳：

“我已经手动测试过了” → 错误，临时测试不等于系统化测试
“这应该能工作” → 必须看到测试通过才算
“这太简单了，不需要测试” → 越简单越需要测试保护

（3）子代理驱动开发(Subagent-Driven Development)

这是v4.0的重大创新！主代理为每个任务派遣一个”新鲜”的子代理（没有上下文污染），实现任务后进行两阶段审查：

阶段一：规格符合性审查（代码是否完全符合需求规格）
阶段二：代码质量审查（只有规格审查通过后才进行）

（4）Git Worktree环境隔离

自动创建新的git分支和git worktree，确保开发环境隔离，不污染主分支。相比传统分支切换，避免了频繁checkout带来的I/O和IDE重新索引问题。

三、如何使用Superpowers？

1. 安装指南（2026年3月最新）

方式一：Claude Code官方市场安装（最推荐）

# 1. 注册Superpowers插件市场（只需执行一次）
/plugin marketplace add obra/superpowers-marketplace

# 2. 安装Superpowers插件
/plugin install superpowers@superpowers-marketplace

# 3. 重启Claude Code或新开会话
# 4. 验证安装
/help

应该看到新命令：/superpowers:brainstorm、/superpowers:write-plan等。

方式二：Cursor安装

# 在Cursor Agent聊天中执行
/add-plugin superpowers

或在插件市场搜索”superpowers”。

方式三：Codex/OpenCode安装

Codex：告诉AI：”Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md“
OpenCode：告诉AI：”Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md“

2. 完整工作流程示例

以开发一个Todo管理应用为例：

步骤1：需求澄清（Brainstorming）

# 在Claude Code中
我想开发一个网页端Todo管理应用

AI不会直接写代码，而是开始苏格拉底式提问：

“这是Web app还是命令行？用什么技术栈？”
“需要哪些核心功能？”
“用户认证需要吗？” 提出3种方案供选择，分段呈现设计文档（每段200-300字），你确认后保存到docs/plans/。

步骤2：创建实施计划（Writing Plans）

设计确认后，AI自动将任务拆解为2-5分钟的小任务：

# Todo List Implementation Plan
**Goal:** Build a simple command-line todo app

### Task 1: Add command parsing
**Files:**
- Create: src/cli.py
- Test: test_cli.py
**Steps:**
1. 写测试：测试命令行参数解析失败
2. 运行测试确认是红的
3. 写最少的代码让测试通过
4. 重构
5. 确认所有测试仍然通过

每个任务包含精确文件路径、完整代码、验证命令、预期输出。

步骤3：执行开发

选择执行模式：

Subagent-Driven Development：主代理派发子代理逐任务执行+两阶段审查
Executing Plans：在独立会话中批量执行，定期检查点

步骤4：代码审查与提交

每个任务完成后自动触发代码审查，所有测试通过后提供选项：

合并到主分支
创建GitHub PR
保留分支
丢弃更改

3. 日常使用技巧

触发关键词（不需要记命令）：

规划功能：”plan 一个用户系统”、”帮我规划这个功能”
写代码：”implement 登录接口”、”实现这个功能”
调试问题：”debug 这个测试”、”为什么报错了”
代码审查：”review 这段代码”、”帮我看看有没有问题”
重构优化：”refactor 这个模块”、”怎么优化更好”

最佳实践：

生产级代码开发用TDD
需求不清晰用brainstorming
复杂项目用writing-plans拆解任务
快速原型、一次性脚本无需强制使用完整流程

四、Superpowers的官方地址和获取方式

1. 主要资源链接

资源类型	链接地址	说明
GitHub仓库	https://github.com/obra/superpowers	源代码、文档、Issue跟踪
官方插件市场	obra/superpowers-marketplace	Claude Code插件市场源
Claude官方市场	claude-plugins-official	官方认证插件
文档目录	docs/	详细使用文档
技能目录	skills/	14个核心技能文件

2. 多平台支持

Claude Code：原生最佳支持，通过插件市场一键安装
Cursor：通过/add-plugin superpowers或插件市场安装
Codex：通过GitHub仓库的.codex/INSTALL.md指引
OpenCode：通过GitHub仓库的.opencode/INSTALL.md指引
Gemini CLI：通过gemini extensions install命令安装

3. 更新与维护

# 更新插件
/plugin update superpowers

# 查看已安装插件
/plugin list

# 卸载插件
/plugin uninstall superpowers

五、Superpowers vs 同类型竞品对比分析

AI编程工作流工具三强对比（2026年3月）

维度	Superpowers	Spec-Kit (GitHub官方)	OpenSpec (Fission-AI)
核心定位	技能驱动的工程纪律框架	规范可执行化工具	轻量规范管理层
GitHub Star	12.4万+	8.25万	3.45万
开发团队	Jesse Vincent (独立开发者)	GitHub官方团队	Fission-AI团队
核心理念	约束即产品，强制工程实践	规范直接生成工作代码	规范作为活文档管理
技术架构	Shell/JavaScript技能系统	Python模板引擎+扩展系统	TypeScript变更驱动
工作流严格度	⭐⭐⭐⭐⭐ (强制)	⭐⭐⭐⭐ (结构化)	⭐⭐⭐ (灵活)
学习曲线	中等	较高	较低
自治能力	高（数小时自主运行）	中等	低
代码质量保障	TDD强制+两阶段审查	规范一致性检查	提案-执行流程
适用场景	生产级代码开发、复杂项目	团队规范统一、大型项目	快速迭代、探索性开发
价格	免费开源	免费开源	免费开源

Superpowers vs 主流AI编程工具对比

特性	Superpowers	GitHub Copilot	Cursor	Claude Code
需求澄清	✅ 强制（Brainstorming）	❌ 无	✅ 建议	✅ 建议
设计阶段	✅ 强制（分段确认）	❌ 无	✅ 可选	✅ 可选
任务拆解	✅ 自动（2-5分钟粒度）	❌ 无	✅ 手动	✅ 有限
TDD强制	✅ 强制（红-绿-重构）	❌ 无	❌ 无	❌ 无
代码审查	✅ 自动（两阶段）	❌ 无	✅ 手动	✅ 有限
多Agent协作	✅ 原生支持	❌ 无	❌ 无	❌ 需定制
环境隔离	✅ Git Worktree	❌ 无	❌ 无	❌ 无
长期自主性	✅ 数小时	❌ 单次	~1小时	~1小时
工程纪律	⭐⭐⭐⭐⭐	⭐	⭐⭐	⭐⭐⭐

数据来源：根据GitHub仓库数据、开发者社区评测和实际测试结果整理。

六、Superpowers的典型应用场景与实际体验

1. 适用人群与岗位

（1）DevOps工程师

解决痛点：自动化脚本缺乏测试和审查，生产环境风险高
实际案例：某DevOps团队使用Superpowers后，AI生成的Shell脚本第一次能直接合入主干，减少了80%的脚本调试时间
优势：强制TDD确保脚本可靠性，自动审查阻断高危操作

（2）SRE/平台工程师

解决痛点：运维脚本和工具代码质量参差不齐
实际案例：平台工程团队用Superpowers构建AI运维代理，实现了4阶段根因分析流程，复杂问题定位时间从小时级降到分钟级
优势：系统化调试流程，验证确保问题真正修复

（3）研发团队技术负责人

解决痛点：团队AI编程行为不规范，代码风格混乱
实际案例：50人研发团队统一部署Superpowers，PR审查通过率从65%提升到92%，减少了40%的代码返工
优势：统一工程规范，强制最佳实践

（4）AI Agent开发者

解决痛点：Agent行为不可控，容易偏离目标
实际案例：Agent开发团队学习Superpowers的工程化Agentic Workflow，Agent任务完成率从70%提升到95%
优势：可组合技能系统，上下文隔离设计

2. 实际体验反馈

正面评价：

“装了Superpowers后，AI从一个急于炫技的代码打字员，变成了严谨规范的工程伙伴”
“代码质量明显提升：因为它会主动跑测试、做审查，所以bug少了很多”
“需求理解更准确：它会先把情况问清楚再动手，避免了理解偏差引发的返工”
“可维护性更好：自动生成文档，规范commit message，项目结构更清晰”

需要适应的方面：

速度变慢：以前让AI写个功能5分钟搞定，现在可能要15分钟（需要先规划）
token消耗增加：做更多”额外”工作，成本相应提高
学习成本：需要理解技能体系才能更好使用

3. 量化效果数据

根据开发者社区调研和实际项目数据：

代码质量提升：TDD强制实施后，单元测试覆盖率从平均45%提升到85%+
返工率降低：需求澄清环节减少了70%的理解偏差导致的返工
审查效率：自动两阶段审查将人工代码审查时间减少60%
长期自治：在Superpowers流程下，Claude Code可以自主运行数小时不偏离方向

七、Superpowers能为用户带来的价值

1. 对个人开发者的价值

（1）提升代码质量与可靠性

强制TDD确保每行代码都有测试保障
自动代码审查提前发现潜在问题
系统化调试流程快速定位根因

（2）规范开发习惯

从”随意写代码”到”按流程开发”的转变
学习资深工程师的工作方法论
培养工程思维和最佳实践意识

（3）提高长期效率

虽然单次任务时间增加，但减少了大量后期调试和返工时间
可维护性提升，后续迭代更顺畅
知识沉淀在技能文档中，形成个人知识库

2. 对团队的价值

（1）统一工程规范

通过共享技能库确保团队代码风格一致
新成员快速上手团队开发流程
减少代码审查中的风格争议

（2）降低协作成本

设计文档作为沟通基础，减少认知偏差
自动化流程减少人工协调工作
Git Worktree隔离避免开发冲突

（3）提升交付质量

生产级代码标准，减少线上事故
可预测的开发过程，更好管理项目进度
客户满意度提升，技术债务可控

3. 对企业组织的价值

（1）技术风险控制

AI生成代码的可控性和可审计性
合规性要求满足（金融、医疗等行业）
知识产权保护，代码质量保障

（2）人才效能放大

初级工程师在AI辅助下达到资深水平产出
专家经验通过技能系统规模化复制
团队整体技术能力提升

（3）创新加速

快速原型验证，降低试错成本
复杂问题系统化解决能力
技术债务管理，保持创新活力

八、Superpowers最近3到6个月内的重大更新

2026年第一季度重要更新（2026年1月-3月）

1. v5.0.6版本（2026年3月25日）

Inline Self-Review替代Subagent Review Loop：简化审查流程，提高效率
Windows hook修复：完善Windows平台支持
Cursor插件支持优化：原生集成Cursor Agent系统

2. v5.0.0重大重构（2026年3月初）

技能触发系统优化：更智能的上下文感知激活
测试框架升级：三套测试框架统一管理
跨平台一致性提升：Claude Code、Cursor、Codex体验一致化

3. 官方市场认证（2026年1月）

进入Anthropic官方插件市场（claude-plugins-official）
单日最高增长2,230 Star，GitHub Trending第一
插件市场安装量突破23万次

4. 社区生态发展

GitHub Star突破12万：从2025年10月开源到2026年3月，增长超过10万Star
开发者教程丰富：CSDN、稀土掘金、阿里云社区等平台涌现大量教程
企业采用案例增加：多家科技公司内部部署使用

技术架构演进趋势

根据项目commit记录和社区讨论，Superpowers正在向以下方向演进：

更轻量的技能加载：按需加载技能详情，减少token消耗
多模型支持扩展：除了Claude，更好支持GPT、Gemini等模型
企业级功能：私有部署、访问控制、审计日志等
可视化工具：技能工作流可视化编辑和调试

九、常见问题FAQ解答

1. 安装与配置问题

Q1：Superpowers安装后没反应怎么办？

A：检查以下步骤：

确认Claude Code版本≥2.0.13：claude --version
验证插件安装：/plugin list查看是否显示superpowers
重启Claude Code会话
尝试触发关键词：”plan 一个功能”或”帮我规划”

Q2：OpenCode用户遇到symlink失效？

A：检查清单：

✅ 路径是否正确：~/.config/opencode/plugins/
✅ 权限是否755：chmod 755 ~/.config/opencode/plugins/
✅ 源文件是否存在：ls -la ~/.config/opencode/superpowers/ 暴力解决：删除symlink重新执行安装命令

Q3：想卸载Superpowers怎么办？

A：

# 卸载插件
/plugin uninstall superpowers

# 移除市场（可选）
/plugin marketplace remove obra/superpowers-marketplace

# 验证
/plugin list

2. 使用与功能问题

Q4：技能不触发怎么办？

A：试试这些关键词：

plan / planning / 规划 / 策划 → 触发brainstorming
implement / 实现 / 写代码 → 触发writing-plans
debug / 调试 / 为什么报错 → 触发systematic-debugging
review / code review / 审查 → 触发requesting-code-review
refactor / 重构 → 触发相关技能

Q5：Superpowers让AI变慢了，值得吗？

A：这取决于你的使用场景：

快速原型/一次性脚本：可能不需要完整流程
生产级代码/长期维护项目：绝对值得！虽然单次时间增加，但：
- 减少了70%的后期调试时间
- 提升了代码质量和可维护性
- 减少了团队协作成本

Q6：如何创建自定义技能？

A：

在skills/目录下创建Markdown文件（如my-skill.md）
使用YAML Frontmatter定义元数据： --- name: my-custom-skill trigger: custom-scenario priority: 50 ---
编写技能流程和规则
AI会自动发现并按需使用

3. 技术与兼容性问题

Q7：Superpowers支持哪些AI编程工具？

A：主要支持：

Claude Code：原生最佳支持（推荐）
Cursor：通过插件系统
Codex：通过安装脚本
OpenCode：通过安装脚本
Gemini CLI：通过extensions系统

Q8：Superpowers会消耗更多token吗？

A：是的，但通过优化：

技能按需加载：只有相关技能才加载完整详情
轻量级触发：初始只检查技能适用性
长期收益：虽然单次token增加，但减少了多次调试的累计消耗

Q9：团队如何统一使用Superpowers？

A：建议方案：

创建团队技能库：在内部Git仓库维护定制技能
配置共享：通过环境变量或配置文件统一设置
培训与文档：制定团队使用规范和最佳实践
渐进式采用：从核心项目开始，逐步推广

十、总结

Superpowers代表了AI编程工具发展的一个重要方向：从追求”更聪明”到追求”更可靠”。它通过一套精心设计的技能系统，将30年软件工程经验编码成AI必须遵守的纪律，解决了当前AI编程工具最核心的痛点——缺乏工程规范。

核心优势总结

工程纪律强制化：不是建议而是强制，确保AI遵循TDD、代码审查等最佳实践
全流程覆盖：从需求澄清到代码提交，14个技能覆盖完整开发周期
智能上下文感知：1%可能性就触发相关技能，避免遗漏关键环节
多平台支持：Claude Code、Cursor、Codex等主流工具原生集成
开源生态活跃：12万+ GitHub Star，23万+安装量，社区支持强大

适用性建议

强烈推荐使用：

生产环境代码开发
长期维护的项目
团队协作开发
复杂系统架构设计
需要高可靠性的场景

可能不需要：

快速原型验证（一次性代码）
简单脚本编写
学习/实验性质的项目

未来展望

随着AI编程工具的普及，像Superpowers这样的工程纪律框架将变得越来越重要。它不仅提升了AI生成代码的质量，更重要的是培养了开发者的工程思维，让AI真正成为可靠的工程伙伴而非随性的代码打字员。

对于个人开发者，Superpowers是提升技能、学习最佳实践的绝佳工具；对于团队和企业，它是统一规范、控制风险、提升效率的关键基础设施。在AI编程工具百花齐放的2026年，Superpowers用12万GitHub Star证明了一个简单而深刻的道理：在软件开发中，纪律比聪明更重要。

参考文章或数据来源

本文引用了以下平台和来源的内容，数据来自GitHub官方统计、开发者社区调研和实际项目测试：

硅基盆栽：《开源播种上下文不再丢失,这个”插件”把AI编程从玄学变工程》（2026/03/31）
阿里云开发者社区：《Superpowers:Vibe Engineering 的第一站——让Coding Agent 守点规矩》（2026/03/11）
稀土掘金：《Superpowers 完整指南:AI 编程代理工程化工作流的革命》（2026/03/04）
燕十三的嵌入式AI之旅：《AI 编程必须安装的一个 Skill: Superpowers》（2026/02/15）
智能思辨录：《给Claude Code装上超级技能包 —— SuperPowers使用实践》（2026/03/26）
AI神经：《当 AI Coding Agent有了”紧箍咒”:带你拆解 Superpowers 框架》（2026/03/16）
blog.fsck.com：《Superpowers: How I’m using coding agents in October 2025》（2025/10/09）
GitHub趋势分析：《GitHub 12 万 Star 的 Superpowers:为什么开发者都在给 AI 编程助手「装技能」？》（2026/03/31）
虾看虾说：《AI Agent开发框架横评:2026年最新战局,Superpowers卷土重来》（2026/03/28）
53AI：《值得用的Agentic Skills框架:Superpowers从安装到实战》（2026/03/29）
码语者：《Superpowers 53.2k星终端增强工具集 GitHub今日最热 725星单日暴涨》（2026/03/03）
一周涨了10万星:编码Agent框架到底在卷什么？（2026/03/19）
数字突触：《今日GitHub项目热榜第一:superpowers,让我重新理解看待AI编程！》（2026/03/30）
AI大气层：《GitHub 40K stars 的超级项目:给 AI 编程套上缰绳,他就是Superpowers！》（2026/03/28）
51CTO：《一个 Claude 插件, Github Star 干到十万多:Superpowers 到底把 AI 编程变成了什么？》（2026/03/26）
术哥无界：《AI 编程工作流选型:Spec-Kit、OpenSpec、Superpowers 深度对比》（2026/03/27）
CSDN：《Superpowers 系统学习笔记:AI编程Agent的完整开发方法论》（2026/03/25）
给聪明人讲AI：《我最近强推的 2 套「编程 Skill 套装」》（2026/03/31）
小栈手记：《AI 编程工具三国杀 — Cursor vs Claude Code vs Gem)ini 实测对比》（2026/03/26）
Coodes：《Claude Code vs Cursor:两款AI编程工具深度横评,结论意外》（2026/03/29）
zeeklog.com：《Claude Code vs Cursor:谁才是 2025 年最强 AI 编程助手？》（2026/03/15）
AI工具深度评测:Claude Code vs Cursor —— 选择更适合你的AI编程助手（2026/03/04）
稀土掘金：《2026 年 AI 编程工具横评:Copilot / Cursor / Claude Code / Windsurf / Trae,到底该用哪个？》（2026/02/12）
博客园：《Superpowers 详细用法教程》（2026/01/21）
CSDN：《Superpowers安装教程》（2026/03/19）
稀土掘金：《Superpowers:为AI编程智能体赋予工程化超能力(安装与配置)》（2026/03/25）
CSDN：《Superpowers插件完整使用指南(一文搞懂)》（2026/02/26）
CSDN：《用Superpowers 给你的 AI 编程 Agent 装上纪律,从安装到跑通一个完整项目》（2026/03/26）
小泽的 AI 实验室：《Claude Code 必装神器!Superpowers 超详细安装教程,小白也能看懂！》（2026/03/09）
打造你的 AI 软件开发搭档:从安装 Superpowers 到创建专属智能体（2026/03/24）
一步API：《开源Claude Code工程级开发插件 Superpowers 完整上手攻略:安装+实战+技巧全解析》（2026/03/25）