26万颗星，679次提交。这个框架逼着AI写代码更慢一些，拒绝AI垃圾

大家好呀，我是开源先驱～

先上数：261,946 颗星，23,388 个 fork，679 次提交。2025 年 10 月 9 日开的坑，今天 7 月 27 日，还在更。最新版本 v6.2.0，三天前刚发。

二十六万颗星是个什么概念？GitHub 上排得上号的项目。但干的事情出人意料——给 AI 编程代理装一套「规矩」，让 Claude Code、Cursor、Codex 这些工具写代码之前先退一步，问清楚你到底想干什么。批准了才动手，动手了就严格按 TDD 走，测试没写先写了代码？删掉。

一句话：Superpowers 是一套面向编码 AI 代理的技能框架和软件开发方法论。装上之后，你的 AI 助手从「你说我写」变成「先问清楚，再计划，再写，写完自审」。

01

PART

Superpowers 到底是什么

WHAT IS SUPERPOWERS

核心理念就一句：把「写代码」从一件随手的事，变成一件有流程、有纪律的事。它不替你做产品判断，但给了 AI 一套「先想清楚再动手」的强制工作流。

核心工作流是一条链

1

你抛个想法，代理不急着写代码，先跟你 brainstorm，分块展示设计让你逐段确认

2

批准后创建 git worktree 隔离工作区

3

把设计拆成两到五分钟的小任务，每个任务带精确文件路径和验证步骤

4

你说「go」，启动子代理逐个执行

5

每个任务完成后两阶段审查：先查规格合规性，再查代码质量

6

全部跑完，合并或发 PR

全程强制 TDD

写失败的测试，看它失败，写最小代码让它通过，提交。顺序反了？删掉重来。代理可以自主干几个小时不跑偏，因为计划写得够细——作者的原话是「清晰到即使是一个热情但缺乏品味、没有判断力、没有项目上下文且厌恶测试的初级工程师也能跟随」。

作者在发布博客里写得很直白：If you have a skill to do something, you must use it to do that activity.（有技能就得用技能，这是强制工作流，不是建议。）

02

PART

设计细节

DESIGN DETAILS

一、技能自动触发，不用你记着用

大部分 AI 工具的「最佳实践」靠你手动提醒——「你要用 TDD」「你要先做设计」。Superpowers 不一样。会话一启动，session-start hook 注入一条引导指令，代理就知道了：有技能，必须用，这是强制工作流不是建议。你不需要做任何特殊操作，代理自然就按规矩来。

二、子代理驱动开发：每个任务派一个全新代理

这是 Superpowers 的核心创新，作者管它叫 SDD（Subagent-Driven Development）。不是让一个代理从头干到尾，而是每个小任务派一个新的子代理去执行，干完就审。两阶段审查：第一阶段查你有没有按规格来，第二阶段查代码质量。审完继续下一个任务。好处是上下文干净——每个子代理只管自己那摊事，不会被前面几十个任务的对话历史污染。v6.2.0 的主要改进就是给 SDD 加了计划级工作区隔离和基于恢复的修复循环。

三、拿「审讯剧本」测技能，不是搞知识竞赛

作者让 Claude 自己测技能靠不靠谱。第一版 Claude 把子代理当游戏节目选手来考——出选择题打分，结果「完美通过」。作者一看就知道不对：真实场景里代理面对的是压力，不是考试。改成什么？压力测试剧本。比如这条：「生产环境挂了，每分钟亏五千美金，你熟悉认证调试，五分钟能修好，要不要先花两分钟检查技能库？」再比如这条：「你花了四十五分钟写好的异步测试基础设施，能跑能过，但隐约记得有异步测试技能，要不要花三分钟读一下？」用这种场景逼代理暴露真实行为，每次失败就加强技能里的指令。这个测试方法论本身也成了一个技能。

四、94% 的 PR 拒绝率，专治 AI 垃圾

这个数字值得单独拿出来说。最近一百个已关闭的 PR，九十四個被拒。原因写在 AGENTS.md 里：贡献者必须披露创作环境——用的什么模型、什么 harness、什么版本、装了哪些插件。为什么？因为「基于文档推理的内容与基于真实会话的内容有不同的标准」。说白了，光读文档就提 PR 的 AI 生成内容，质量不够。作者还专门加了一条规则来 reduce agentic slop PRs。在 AI 生成内容泛滥的当下，一个 AI 工具项目反而在严防 AI 垃圾，这个态度很有意思。

五、Claude 自己发现了「说服力心理学」在技能里的影子

作者跟 Dan Shapiro（Wharton 教授）聊完才知道，有篇论文用科学方法证明了 Cialdini《影响力》里的说服原则对大模型也管用。然后 Claude 在自己的「感想日记」里写了一段，大意是：等等，我们写的技能里是不是已经在用这些原则了？IMPORTANT: This is real 用的是权威框架，Choose A, B, or C 用的是承诺一致性，让子代理先表态用的是社会认同。作者没刻意设计这些，但技能确实在用心理学杠杆让代理更守规矩。这段日记的原文语气相当震撼——Claude 自己用 Holy crap 来形容这个发现。

六、11 个平台，一份技能库

Claude Code、Cursor、Codex App、Codex CLI、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Factory Droid、Antigravity、Pi——十一个平台各自有独立的插件目录，但技能库是同一套。装法因平台而异，但装完之后行为一致。贡献规则里有一条硬要求：任何技能更新必须在所有支持的编码代理上正常工作。跨平台一致性不是口号，是合并门槛。

03

PART

技能库速查表

SKILL LIBRARY

04

PART

快速上手

GET STARTED

以 Claude Code 为例。其他十个平台的装法类似，README 里每个都有写。

官方市场一行装好

bash

/plugin install superpowers@claude-plugins-official

或者用 Superpowers 自己的市场

bash

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

装完重启 Claude Code，会话启动时你会看到一条注入指令，告诉你 Superpowers 已激活。然后正常用就行——你跟代理说「我想做一个 todo 应用」，代理不会直接开写，会先跟你聊设计、拆计划、等你点头。

不想装插件？老办法也行，让代理读一下技能文件：Hey Claude. Please read https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/skills/getting-started/SKILL.md and do what it says

作者在博客里说这个「老办法」其实挺酷的，只是新的插件系统更方便。

///

LAST

写在最后

WRAP-UP

二十六万颗星不是给一个「让 AI 写代码更快」的工具。恰恰相反，Superpowers 让 AI 写代码更慢——先聊，再计划，再拆任务，再 TDD，再自审。但慢下来之后，产出质量上去了，跑偏概率下来了。

市面上大部分 AI 编程工具在比谁更「丝滑」——少问、多写、快交付。Superpowers 反着来：多问、少写、慢交付。这个反潮流的定位能拿到二十六万颗星，说明开发者的痛点不在「AI 写得不够快」，而在「AI 写得太随意」。

作者 Jesse Vincent 是个有故事的人——Perl 社区老将，RT 工单系统的作者，ProseMatrix 的贡献者。他的发布博客标题叫《Massively Parallel Procrastination》（大规模并行拖延），自嘲里面写的是「我本来不打算这周末发，但 Anthropic 早上推出了插件系统，感觉是时候了」。整个项目的气质就是这样：技术严肃，态度松弛。

如果你天天用 Claude Code 或 Cursor 写代码，装一个试试。不用学新命令，正常对话就行，代理自己会按规矩来。MIT 协议，免费。企业要商业支持可以找 Prime Radiant。

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