乐于分享
好东西不私藏

Superpowers 给你的 AI 编程助手装上「超能力」

Superpowers 给你的 AI 编程助手装上「超能力」
Made with pollinations-retro style

给你的 AI 编程助手装上「超能力」

Superpowers —— 一个让 AI 编程代理真正「靠谱」的技能框架与方法论

⭐ 219,298 Stars · MIT 协议 · Shell 语言


🎮 这是什么?

你有没有遇到过这样的情况——

让 AI 写代码,它二话不说就开干,写了一堆你根本没要求的「额外功能」; 让它修 Bug,它猜来猜去改了十几个文件,越改越乱; 让它帮忙,结果输出的代码连测试都没有……

Superpowers 就是来解决这些问题的。

它不是一个库、不是一个框架——它是一套给 AI 编程代理用的「方法论 + 技能包」。当你的 AI 助手装上它,行为会变成这样:

你: 帮我加一个登录功能旧模式 AI: (立刻开始写代码)新模式 AI: 先等等,你说的是哪种登录?         邮箱?手机?OAuth?         需要记住我吗?         用什么存储 session?         → 让我确认一下设计再动手

🔧 怎么做到的?

Superpowers 的核心是一套强制执行的技能链(Skills Chain),AI 代理在每个关键节点自动触发对应技能,而不是靠你手动提醒:

阶段
技能
做了什么
设计
brainstorming
不急着写代码,先通过苏格拉底式提问理清需求
规划
writing-plans
把工作拆成 2-5 分钟的小任务,每个都有精确文件路径和验证步骤
隔离
using-git-worktrees
在隔离分支上工作,不污染主分支
执行
subagent-driven-development
派子代理逐任务推进,每完成一个都有两轮审查
测试
test-driven-development
强制 RED→GREEN→REFACTOR,先写失败测试,再写最小代码
审查
requesting-code-review
任务间自动审查,关键问题阻断进度
收尾
finishing-a-development-branch
验证测试、展示合并/保留/丢弃选项

重点:这些技能不是建议,是命令。 AI 会检查当前任务是否匹配某个技能,哪怕只有 1% 的可能性也要触发。


🗂️ 技能库全景

Superpowers 的技能分四大类:

🧪 测试类

技能
说明
test-driven-development
强制 TDD 循环:红灯→绿灯→重构,包含测试反模式参考
verification-before-completion
宣称完成之前必须验证,口头承诺不算数

🐛 调试类

技能
说明
systematic-debugging
4 阶段根因分析流程,不是瞎猜
verification-before-completion
确认修复真正生效了

🤝 协作类

技能
说明
brainstorming
苏格拉底式设计推敲——先想清楚再写
writing-plans
生成详细到"热心但品味差的初级工程师都能执行"的实施计划
subagent-driven-development
子代理驱动开发——快速迭代 + 双阶段审查
executing-plans
分批执行计划,有人工检查点
dispatching-parallel-agents
并行派发子代理处理独立任务
using-git-worktrees
Git worktree 隔离开发
finishing-a-development-branch
分支收尾:合并/PR/清理
requesting-code-review
代码审查检查清单
receiving-code-review
收到审查意见后的正确应对姿势

🛠️ 元技能

技能
说明
writing-skills
创建新技能的最佳实践指南
using-superpowers
技能系统入门介绍

⚡ 快速安装

Superpowers 支持主流 AI 编程工具,每个都需要单独安装:

Claude Code

# 官方市场安装/plugin install superpowers@claude-plugins-official# 或通过 Superpowers 市场/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Codex CLI / Codex App / Factory Droid / GitHub Copilot CLI

均支持,详见项目 README。


💡 它为什么有效?

Superpowers 的哲学很直接:

1. 测试先行,永远测试先行不是「有空的话顺便写个测试」,而是——没有测试就不能开始写代码。AI 必须先写一个会失败的测试,看到红灯,然后才写最少的代码让它变绿。

2. 系统化优于即兴不是「让我猜猜哪里出了问题」,而是按照根因追踪流程一步步排除。不是「我觉得改好了」,而是跑验证命令确认。

3. 复杂度最小化YAGNI(You Aren't Gonna Need It)是铁律。每个任务 2-5 分钟,不搞大而全的重构,不做多余的抽象。

4. 证据优于声称「我认为修好了」不算数。必须跑命令、看输出、确认结果。


🕹️ 实际体验

安装 Superpowers 之后,你和 AI 的对话会变成这样:

你: 我想加一个搜索功能AI: 在写代码之前,我需要了解几个点:    - 搜索范围是什么?全文?标题?标签?    - 需要模糊匹配吗?    - 搜索结果是实时过滤还是提交后返回?    - 有没有排序需求?    → 让我用 brainstorming 技能把这些理清(设计确认后)AI: 好的,我已经把设计拆成 4 个任务:    任务 1: 写搜索接口的失败测试    任务 2: 实现搜索逻辑让测试变绿    任务 3: 写前端搜索组件    任务 4: 集成测试    → 用 writing-plans 技能生成详细计划(你确认计划后)AI: 开始执行。我先创建 git worktree 隔离工作区...    任务 1 完成 ✅ 测试红灯确认    任务 2 完成 ✅ 测试绿灯确认    ...

它不是让你命令 AI 做什么——而是让 AI 自己遵循一套经过验证的工作流程。


🔮 适合谁?

适合
不适合
经常让 AI 写代码但你发现质量不稳定
只用 AI 做简单问答
想要 AI 遵循 TDD 但每次都要提醒
不在意代码质量和流程
多人协作需要一致的 AI 辅助规范
项目太小不需要结构化流程
使用 Claude Code / Cursor / Codex 等
—

📦 项目名片

项目
信息
仓库
github.com/obra/superpowers
作者
Jesse Vincent / Prime Radiant
协议
MIT
Stars
218,960+
支持工具
Claude Code, Cursor, Codex CLI/App, Gemini CLI, OpenCode, Factory Droid, GitHub Copilot CLI
社区
Discord · Issues

🎯 总结

Superpowers 做的事情很简单——把好的工程实践变成 AI 的默认行为。

不需要你每次都提醒「先写测试」「先做设计」「别乱改不相关的文件」。装上之后,AI 自己就会这么做。

就像项目的名字一样——给你的 AI 编程助手装上超能力。不是什么魔法的超能力,而是系统化的工程方法论。这种超能力,比任何花哨的代码生成都要实在。

本文项目信息基于 2026 年 6 月的数据,项目持续更新中,请以 GitHub 仓库为准。


最后: 推荐 superpowers-zh (Superpowers的中文版本,Github ⭐ 4.8K )

https://github.com/jnMetaCode/superpowers-zh

这是什么?

superpowers 是目前最火的 AI 编程 skills 框架(159k+ stars),为 AI 编程工具提供系统化的工作方法论。

superpowers-zh 在完整翻译的基础上,新增了面向中国开发者的特色 skills。

相关学习资料