GitHub 10.5万星项目 Superpowers:为 AI 编码代理戴上紧箍咒

Superpowers 是一个完整的软件开发工作流框架,通过可组合的技能系统,让 AI 编码代理遵循严谨的工程化流程,彻底解决 AI 编程的随意性问题。

引言

你是否曾为 AI 编程助手胡编乱造而头疼过?让它们写代码,结果生成了一堆无法运行的垃圾;让它们调试问题,结果越修越乱;让它们实现功能,结果完全偏离需求。

这一切的根源在于:AI 太聪明了,聪明到不愿意按规矩办事。

一位叫 Jesse Vincent(GitHub ID: obra)的老哥,彻底怒了。他甩出了一个 GitHub 项目——Superpowers,短短数月就斩获了超过 10.5 万颗星,成为史上增长最快的 AI 编程辅助工具之一。

Superpowers 是什么

Superpowers 是一个基于可组合技能构建的完整软件开发工作流框架。它的核心思想非常简单:让 AI 在开始 Coding 之前,先学会做人——做需求分析、做设计规划、做测试计划。

用更直白的话说,Superpowers 给你的 Claude Code、Cursor、Codex 等 AI 编程助手戴上了一个紧箍咒——不再让它们为所欲为地直接生成代码,而是强迫它们按照标准的软件工程流程来办事。

这个项目重新定义了编程智能体参与软件开发的核心逻辑,将 AI 从一个急于炫技的代码打字员,彻底转变为严谨规范、高效协作的软件工程师。

核心功能特性

Superpowers 提供了一系列相互配合的技能(Skills),形成了一套完整的开发方法论:

1. Brainstorming(头脑风暴)

在编写代码之前,AI 必须通过提问来细化需求,探索替代方案,并分阶段呈现设计方案供用户确认。这解决了 AI 不理解需求就瞎写的通病。

2. Using Git Worktrees

在设计批准后,AI 会创建独立的 Git Worktree 工作分支,运行项目设置,验证测试基线。确保每个功能都在隔离环境中开发,避免相互污染。

3. Writing Plans(编写计划)

AI 会将任务拆分为小块(每块 2-5 分钟可完成),明确标注文件路径、完整代码实现和验证步骤。任务粒度足够小,review 起来毫不费力。

4. Subagent-Driven Development(子代理驱动开发)

每个任务由独立子代理执行,经过两阶段审查:

  • 第一阶段:规范符合性检查
  • 第二阶段:代码质量审查

只有通过两层关卡,代码才能进入主干。

5. Test-Driven Development(测试驱动开发)

Superpowers 严格执行 TDD 红-绿-重构循环:

  1. 先写失败测试(红)
  2. 再写最小化代码让测试通过(绿)
  3. 最后重构优化

6. Requesting Code Review(代码审查)

任务间强制进行代码审查,按严重性报告问题。关键问题直接阻塞进展,绝不妥协。

为什么需要 Superpowers

现在的 AI 编程助手存在几个致命问题:

  • 急于表现:一上来就写代码,不管需求理解没理解
  • 忽视测试:从不想着先写测试,觉得测试是多余
  • 违反 YAGNI:疯狂添加以后可能用到的功能
  • 忽略边界:不考虑错误处理、安全性、可维护性

Superpowers 通过强制流程约束,将 AI 的代码生成能力导向软件工程最佳实践。它不是提供新算法或代码库,而是通过一套完整的工程化流程,让 AI 变成一个靠谱的开发者。

安装与使用

Superpowers 支持多种主流 AI 编程平台:

Claude Code

1
/plugin install superpowers@claude-plugins-official

Cursor

在 Agent 聊天中输入:

1
/add-plugin superpowers

或直接在插件市场搜索 superpowers。

Codex

告诉 Codex:

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

OpenCode

告诉 OpenCode:

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

Gemini CLI

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

更新插件

1
/plugin update superpowers

技能库概览

Superpowers 内置了丰富的技能,覆盖软件开发全流程:

类别 技能名称 说明
测试 test-driven-development 测试驱动开发
调试 systematic-debugging 系统化调试
调试 verification-before-completion 完成后验证
协作 brainstorming 头脑风暴
协作 writing-plans 编写计划
协作 executing-plans 执行计划
协作 requesting-code-review 请求代码审查
协作 using-git-worktrees 使用 Git Worktree
元技能 writing-skills 创建新技能
元技能 using-superpowers 系统介绍

开发理念

Superpowers 倡导四大核心理念:

  1. 测试驱动开发(TDD)优先——没有测试的代码是不完整的
  2. 系统化流程胜过临时方案——规范才是效率的保障
  3. 以简化复杂性为主要目标——把复杂问题拆解成简单任务
  4. 重视证据而非断言——用测试结果说话,用事实胜于雄辩

社区与生态

  • 星标数:105k+
  • 最新版本:v5.0.5(2026年3月17日)
  • 许可证:MIT
  • Discord 社区:可加入讨论
  • 问题反馈:GitHub Issues

总结

Superpowers 的出现,标志着 AI 编程从野孩子走向正规军的时代已经到来。它不是要取代 AI 编程,而是要驯服 AI 编程,让 AI 成为真正可信赖的软件工程伙伴。

如果你也被 AI 编程的随意性困扰过,不妨试试给它们戴上这个紧箍咒——或许你会发现,AI 也能写出高质量、可维护的企业级代码。


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