191k Star 的 Superpowers：把 AI 从“会写代码“改造成“守纪律的工程师“

路易乔布斯 · 2026-05-14 · AI Daily 深度拆解数据时间锚点本文写作时 obra/superpowers 数据为191k stars / v5.1.0 (2026-04-30) / 8 个编码代理平台已支持。一、那条让我点进去的 AI 日报今早翻 AI 日报第 9/10 条标着 重磅发布 Agent 技能框架与开发方法论GitHub 上出现了一个名为 superpowers 的 Agent 技能框架与软件开发方法论旨在解决 AI 代理在实际开发中缺乏结构化技能的问题。我点进去之前对这个项目的认知是 “34k stars 的小工具”。点进 GitHub 第一眼数字让我愣住了191,000 stars。这不是小项目。这是一年内从 0 到接近 React 早期影响力级别的爆款。再翻 RELEASE-NOTES作者 Jesse Vincent 从 v2.02025-10-12一路迭代到 v5.12026-04-307 个月里把它从一个个人插件打磨成了8 个 AI 编码代理平台共同遵循的工作流层——Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode、Factory Droid、GitHub Copilot CLI、Codex App全部一行命令安装。那它到底是什么官方一句话定义最准“An agentic skills framework software development methodology that works.”但这句话说人话就是一件事它把软件工程师素养植入到 AI agent 里。让 AI agent 在写代码之前先做一个守纪律的工程师。我花了一晚上把它读穿写下这篇深度拆解。看完你会知道(1) 它解决的核心问题是什么(2) 一个真实 SKILL.md 长什么样(3) 7 个月演进里作者敢于砍自己的哪些设计(4) 不论你用不用它能从中借走什么。二、它解决了什么问题AI 强 ≠ AI 可靠你的 AI 编码 agent 现在大概是这样的你说加个用户登录它 30 秒内甩你 200 行代码没问你 OAuth 还是密码、用什么 session 方案、要不要双因素没写一行测试改完一处发现另一处坏了自己也不回头看听起来像不像你团队里那个最让人头疼的初级工程师Jesse Vincent 给出了一组让我心惊的硬数据。在 v5.1.0 的 RELEASE-NOTES 里他公开了一份调查“过去 100 个 PR 中94% 因 AI 生成的低质内容被拒。”100 个有 94 个被拒。这不是AI 还不够好这是**“AI 没有被规训”**。Jesse 据此在 v5.1 加了一份AI agent 贡献者守则明确写在CLAUDE.md顶部——AI 提交的 PR 如果只是对着别人代码改名换姓或复制官方 README 凑个文件一律退回。这背后的命题清晰得近乎残酷AI 强大不等于 AI 可靠。要可靠你得给它一套不能跳过的规矩。Superpowers 想做的事就是这个。它不优化模型、不教 prompt、不卖 API。它只做一件事——在 AI agent 和你的代码库之间竖起一道工程师纪律的墙。三、它的方法论4 条哲学 7 步工作流 19 个技能4 条设计哲学Jesse 在 README 里只写了 4 条全是动名词全是反话哲学反对的是什么Test-Driven Development反对先写代码再补测试Systematic over ad-hoc反对看心情决定流程Complexity reduction反对为复杂而复杂Evidence over claims反对我觉得这样没问题简单粗暴。这 4 条不是给人看的是给 AI agent 看的。每一条都对应底下一组可执行 skill。7 步标准工作流Superpowers 把接到需求 → 交付代码这条路径拆成了 7 步每一步对应一个或多个 skill#步骤对应技能这一步要解决什么1澄清需求brainstorming不让 AI 直接动手强制先反问真实意图2隔离环境using-git-worktrees不污染主分支每个任务独立 worktree3写计划writing-plans把任务拆到 2-5 分钟粒度初级工程师都能照做4执行subagent-driven-development/executing-plans子代理派发 两阶段审查5测试驱动test-driven-development强制 RED-GREEN-REFACTOR先红后绿6代码审查requesting-code-review任务间审查按严重程度报告7收尾finishing-a-development-branch合并 / PR / 保留 / 丢弃由用户拍板这套流程的精髓在第 1 步和第 7 步——两端都把方向盘留给人。第 1 步用brainstorming强制澄清意图AI 不能跳过。第 7 步合并方式必须用户选。中间 5 步是 AI 的执行域但被 skill 体系夹得死死的进 worktree → 出 plan → 跑 TDD → 评审 → 报告。19 个技能的全景类别核心技能测试test-driven-development调试systematic-debugging4 阶段根因分析/verification-before-completion协作brainstorming/writing-plans/executing-plans/dispatching-parallel-agents/requesting-code-review/receiving-code-review/using-git-worktrees/finishing-a-development-branch/subagent-driven-development元writing-skills怎么写新 skill/using-superpowers怎么用整套体系注意writing-skills这个元技能。它的存在意味着Superpowers 不是给你一套固定的方法论是给你一套怎么把方法论编译成 AI 能执行的 skill的元方法。这是它从 Cursor Rules、Claude Code Memory 这类同类产品里跳脱出来的关键差异。四、一个真实 SKILL.md 长什么样光说19 个技能太抽象。我把最核心那个brainstorming的源码全读了给你拆开看。一个真实的 SKILL.md 里有什么。4.1 Frontmatter强制触发---name:brainstormingdescription:You MUST use this before any creative work-creating features,building components,adding functionality,or modifying behavior. Explores user intent,requirements and design before implementation.---关键词“You MUST”。不是 “should”、不是 “recommended”。这一句话直接决定 AI 在什么场景必须激活这个 skill——任何创造性工作之前。4.2 HARD-GATE硬门控在你向用户呈现设计、并且用户批准之前 不得调用任何实现技能、不得写代码、不得搭脚手架、不得做任何实现动作。 此规则适用于每一个项目无论它看起来多简单。这不是建议是HARD-GATE——硬门控。AI 不能跳过。4.3 反模式段驳斥常见借口接下来一段标题是“This Is Too Simple To Need A Design”——直接把 AI 最常用的借口拎出来打脸即使是 todo list、单函数工具、配置改动也必须走流程。设计可以短到几句话但必须呈现并获批准。Jesse 把模型可能找的借口提前堵死。这是经验之谈——他在 v4.0 文档化过一个叫 “Description Trap” 的现象短 description 会盖过详细 flowchart 的指引。所以现在每个 skill 都把反模式显式写出来。4.4 9 步可执行 Checklist#步骤关键动作1探索项目上下文检查文件、文档、最近 commits2提供视觉伴侣如需要单独一条消息不与其他内容合并3逐个提出澄清问题一次只问一个4提出2-3 种方案带 trade-offs 和推荐意见5分节呈现设计每节按复杂度伸缩逐节获批6写设计文档保存到docs/superpowers/specs/YYYY-MM-DD-topic-design.md并 git commit7Spec 自审内联检查占位符、矛盾、歧义、范围8用户审阅 spec 文件等待用户明确同意9过渡到实现只能调用writing-plans技能注意第 9 步——明确的下游交接。AI 完成 brainstorming 后只能进入 writing-plans。不能直接跳去 frontend-design、不能直接 mcp-builder。整个工作流被锁成单向有向图。4.5 Graphviz DOT 流程图skill 文件里直接内嵌一份 DOT 源码digraph brainstorming { Explore project context - Visual questions ahead?; Visual questions ahead? - Offer Visual Companion [labelyes]; Visual questions ahead? - Ask clarifying questions [labelno]; Ask clarifying questions - Propose 2-3 approaches; Propose 2-3 approaches - Present design sections; Present design sections - User approves design?; User approves design? - Present design sections [labelno, revise]; User approves design? - Write design doc [labelyes]; Write design doc - Spec self-review; Spec self-review - User reviews spec?; User reviews spec? - Write design doc [labelchanges requested]; User reviews spec? - Invoke writing-plans skill [labelapproved]; }这个图既能渲染给人看也能被 AI 当状态机执行。机器可读 人类可读——这是 Superpowers 把 skill 写成程序而非教程的关键技法。4.6 Spec 自审 4 项写完设计文档不是终点。AI 要自审 4 件事占位符扫描有没有 TBD / TODO / 模糊需求内部一致性各节是否互相矛盾范围检查是否聚焦于单个实现计划还是该拆歧义检查任何需求是否可能有两种解读若是挑一种并写明确。自审完成后仍然要用户审阅 spec 文件这道闸门。4.7 关键洞察通读这一份 SKILL.md我提炼出 Superpowers 真正的设计美学它不是给人读的教程是给模型执行的「程序 守则」。身份元数据 强制规则 有序步骤 决策图 原话 prompt 自检清单 原则总结——七件套全齐。每一件都是为了让模型可以机械地、不偷懒地、可验证地执行。这跟你写一个 Cursor Rule 是完全不同的层次。Cursor Rule 是你应该这样SKILL.md 是你必须这样否则 HARD-GATE 拦你。五、7 个月三次转身作者敢于砍自己的设计Superpowers 真正让我佩服的地方不是它的设计精妙而是 Jesse Vincent 在 7 个月里 3 次推翻自己。这种东西在国内同类项目里很少见。转身一架构v2.0 → v3.0v2.0单体插件v2.x拆成 shim 独立 skills 仓库v3.0直接放弃自维护迁移到 Anthropic 官方 skills 系统放下自己造的轮子是反直觉的。但 Jesse 看到 Anthropic 原生 skill 系统能更可靠地被 Claude 加载立刻迁移。别为代码自尊心买单。转身二范围单平台 → 8 平台版本新增平台v3.3Codex首次跨平台v3.5OpenCodev4.3Cursorv5.0.1Gemini CLIv5.0.7GitHub Copilot CLIv5.1Factory Droid每加一个平台都要改 bootstrap、写工具映射、调试兼容性。但 Jesse 的判断很清晰Superpowers 应该是工作流层不是Claude Code 插件。到 v5.1它是少数几个真正做到在 8 个 AI 编码代理上行为一致的方法论项目。转身三方法论描述 → 强制 → 简化这个最有意思。v4.3之前Jesse 信任模型会按 description 走流程。结果发现 AI 经常跳过 brainstorming 直接动手——这就是 v4.0 文档化的“Description Trap”当 description 短、flowchart 长时模型只看 description 就做决定flowchart 失效。v4.3Jesse 加了 HARD-GATE 检查表 DOT 流程图——从建议升级到强制。但故事没结束。v5.0Jesse 又加了一套 subagent 评审循环——每个任务派子代理审一遍。听起来很优雅。v5.0.6他做了实测“subagent 评审循环让执行时间增加约 25 分钟但质量提升不可测。”下一个版本他就把它删了。换成内联自评。这是非常硬核的工程师品质——愿意基于真实数据砍掉自己设计的复杂机制。v5.1 进一步删了遗留 slash 命令、命名 agent、Integration 章节。“少即是多” 成为主旋律。如果你只能从这 7 个月的演进里学一件事那就是复杂的方案先做一个版本上线跑数据跑不出价值就砍。不要因为我设计得好就保留。六、我能从中借鉴什么无论你用不用 Superpowers 本身下面 5 条都能直接抄到你自己的工作流里。6.1 给 AI agent / 团队定 SKILL 卡片三件套任何重复出现的工作流都该写成 SKILL 卡片结构最少包含--- name: skill-name description: You MUST use this when trigger condition --- ## HARD-GATE硬门控 在 某条件 之前不得 某些动作。 ## Checklist9 步左右每步动词开头 1. ... 2. ... ## Anti-pattern反模式段 This Is Too Simple To Need A X——驳斥这个借口。 ## Self-review自审清单 1. 占位符扫描 2. 内部一致性 3. 范围检查 4. 歧义检查HARD-GATE Checklist Anti-pattern三件套。少哪件都会被绕过。6.2 把先写测试内化为强制门控不是开发者自觉——99% 的人没那个自觉。是 skill 里写明在你写实现代码之前必须先写一个失败测试并验证它确实失败。 违反此规则的提交会被代码审查拒绝。强制 RED → GREEN → REFACTOR。AI agent 比人类更适合执行这个因为它没有先写完再补测试的偷懒倾向前提是你写了 HARD-GATE。6.3 用数据砍自己的设计v5.0.6删 subagent 评审循环 v5.1删 subagent 评审循环 这两步是最值钱的方法论。把它压成一句话每个复杂机制上线后3 个月内必须给出它带来的可量化价值。给不出就砍。不要因为我设计得很巧妙就保留。6.4 跨工具的工作流层思维Superpowers 一开始只跑在 Claude Code 上作者完全可以一直当 Claude 插件做下去。但 Jesse 想到了一件事方法论应该可移植不该被某个工具锁定。类比一下你自己的项目你的 Cursor Rules 能不能搬到 Codex CLI你的 Claude Memory 能不能在 Gemini 上跑如果不行问问自己是真的不可能还是你没想过6.5 描述性指导 → 强制性门控的升级路径写规则的人最容易犯的错写一句建议这样做然后期待执行者真的这样做。Superpowers 的演进告诉你别期待。加门控。描述性“Should call brainstorming before coding”——AI 会跳过强制性HARD-GATE checklist DOT 流程图——AI 跳不过这条规律对你管理团队也成立。七、它的局限和你不该用它的时候公平起见给反方一个机会。局限后果Skill 触发依赖模型遵循指令的能力弱模型上不靠谱GPT-3.5、本地小模型不接受新技能贡献想加自己的 skill 必须 fork 自己维护重流程对快速试错场景反而拖累周末 hack 一个原型不该用它8 平台兼容意味着复杂的 bootstrap调试时要分清是平台问题还是 skill 问题强制 brainstorming 可能让用户烦经验老手知道自己要什么时反复反问反而打断它适合长周期项目、多人协作、有质量门槛、AI agent 长时间无人值守工作。它不适合周末项目、原型验证、5 分钟一次性脚本、你已经知道全部细节只想让 AI 当代笔。八、结尾191k Star 不是因为它写代码厉害读完这一切我想清楚了一件事。Superpowers 拿到 191k stars不是因为它让 AI 写代码更厉害——它根本不写代码。它拿到 191k stars是因为它让 AI 不再乱写代码。这个区别比看起来大得多。整个行业过去两年都在卷AI 怎么写得更多更快Superpowers 反过来卷AI 怎么写得更少更准。它把刹车踏板装回了 AI 的车上。你装上之后第一次看到 AI agent 反过来问你 “你确定这个需求吗”——那一刻你就懂为什么它值 191k stars 了。附8 平台一键安装# Claude Code/plugininstallsuperpowersclaude-plugins-official# Codex CLI/plugins → 搜索 superpowers# Gemini CLIgemini extensionsinstallhttps://github.com/obra/superpowers# Cursor/add-plugin superpowers# GitHub Copilot CLIcopilot plugininstallsuperpowerssuperpowers-marketplace# Factory Droiddroid plugin marketplaceaddhttps://github.com/obra/superpowers# OpenCode让 AI 抓 .opencode/INSTALL.md# Codex App侧边栏 Plugins → Coding → 仓库https://github.com/obra/superpowersv5.1.0191k starsMIT License