你让AI写个登录功能,它”啪”一下给你 500 行代码。**有测试吗?没有。能跑吗?不知道。review?不存在。**等你发现一堆bug回头让它改,又改出新bug。这是大多数AI编程助手的真实工作状态。

GitHub 上 28.7 万⭐的 obra/superpowers 项目解决的就是这个问题 —— 不是让AI写得更聪明,是让AI按规矩干活

一、问题:AI写代码为什么总是”凑合能用”

你可能遇到过这些场景:

这些不是AI”不够聪明”——是它没有工作方法论。普通AI编程助手就像一个”听话的工具人”:你说啥它就写啥,没有工程纪律。

二、superpowers 是什么

obra/superpowers 是一个给 AI 编程助手用的技能框架,GitHub 上 28.7 万⭐,MIT 许可,本质是一套完整的软件开发方法论。

装上之后,你的 Claude Code / Codex / Cursor 不再是”工具人”,而是按规矩办事的”工程团队”:

  1. 先反问(brainstorming)—— 弄清你到底要啥
  2. 出 spec —— 写成文档让你签字
  3. 拆 plan(writing-plans)—— 把活拆成 2-5 分钟可执行任务
  4. git worktree 隔离 —— 不污染主线
  5. TDD 强制(test-driven-development)—— 写失败测试 → 看红 → 写最小代码 → 看绿 → 重构
  6. 派子代理(subagent-driven-development)—— 每个任务派新代理执行 + 两道审查
  7. 任务间 review(requesting-code-review)—— 自动互相 review
  8. 完成前自检(verification-before-completion)—— 用证据验证

支持 14 个 harness(AI 编程工具):Claude Code、Codex、Cursor、Devin、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent、Antigravity——基本覆盖所有主流AI编程工具。

三、7 步标准工作流

[你:写一个 XX 功能]

① brainstorming —— AI 反问:"用邮箱还是手机号?要不要验证码?"

② writing-plans —— AI 拆 12 个任务,每个 2-5 分钟,附文件路径

③ using-git-worktrees —— AI 新建分支 feature/xx-iso

④ TDD —— 每个任务:先写失败测试 → 实现 → 重构

⑤ subagent-driven-development —— 派子代理执行,两道审查

⑥ requesting-code-review —— 任务间自动 review

⑦ finishing-a-development-branch —— AI 汇报:"测试全过,要 merge / PR / 保留 / 丢弃?"

每一步都有对应的子技能强制执行——不是建议,是硬性工作流

四、4 大核心原则

  1. 🧪 Test-Driven Development(测试先行,永远)

    • 任何代码改动,先写失败的测试
    • 看测试红 → 写最小代码让它变绿 → 重构
    • 测试驱动的开发,质量是设计出来的,不是事后补的
  2. 🧭 Systematic over ad-hoc(系统化优于拍脑袋)

    • 调试有 4 阶段根因排查法,不靠瞎试
    • 规划有明确的”2-5 分钟任务”颗粒度,不靠大跃进
    • 一切按流程走,而不是”灵感来了就改”
  3. 🪶 Complexity reduction(简化是首要目标)

    • YAGNI(You Aren’t Gonna Need It)—— 不要做现在不需要的东西
    • DRY(Don’t Repeat Yourself)—— 不重复造轮子
    • 真/绿/重构循环强制消除临时代码
  4. 🔍 Evidence over claims(证据优于自夸)

    • 用 verification-before-completion 自检
    • 完成 = 测试通过 + 用户能验证 + 代码可维护
    • 不靠嘴说”搞定”,靠证据说”搞定”

五、跟普通 AI 编程助手的对比

维度普通 AI 助手装上 superpowers 之后
收到需求直接动手写代码先反问澄清,出 spec
大任务一口气写完拆 2-5 分钟任务,逐步执行
测试可选强制 TDD,不写测试不让过
任务隔离单线串行派子代理,可并发可独立
代码审查没有两道审查(spec 合规 + 代码质量)
完成判定嘴说”搞定”证据验证,跑测试、看输出
收尾留下一堆半成品明确选项(merge / PR / 丢弃)
长任务容易跑偏可自主工作几小时不偏离计划

六、3 个真实场景:装上 superpowers 之后

场景 1:重构一个老模块

不用 superpowers:AI 直接重写 800 行,引入 3 个新 bug,2 个测试失败。 用 superpowers:brainstorming 阶段先和你确认”重构边界”,writing-plans 拆成 15 个 2-5 分钟任务,每个任务 TDD(先有测试再写实现),子代理执行 + 自动 review。最后 0 个新 bug,所有测试通过

场景 2:长任务 3 小时

不用 superpowers:AI 写到 1.5 小时就”忘了”你最初的需求,开始偏题。 用 superpowers:spec-first 把需求锁死,plan 把任务拆碎,子代理每个新上下文(不污染),自动 review 每一步对齐 spec。3 小时不跑偏

场景 3:debug 一个诡异 bug

不用 superpowers:AI 瞎试改 5 种方案,越改越乱。 用 superpowers:systematic-debugging 走 4 阶段根因排查(根因追踪 → 深度防御 → 条件等待),verification-before-completion 用证据自检。10 分钟定位根因,1 行修复

七、怎么用

装上 superpowers 后,你给 AI 一个编程任务(比如”帮我写个用户登录功能”),它不会再”啪”一下给你 500 行代码,而是按 superpowers 工作流:

  1. 反问:“邮箱还是手机号?要不要验证码?要不要第三方登录?”
  2. 写 spec 让你确认
  3. 拆 plan(12 个 2-5 分钟任务)
  4. 你说”go”
  5. 派子代理执行 + 两道审查
  6. 任务间 review
  7. 完工问你”merge / PR / 保留 / 丢弃?”

整个过程你只在反问和 sign-off 阶段介入,剩下 AI 自主完成。

八、14 个子技能清单

阶段技能用途
启动using-superpowers元技能,启动时必读
需求brainstorming苏格拉底式澄清需求
规划writing-plans任务拆 2-5 分钟颗粒度
隔离using-git-worktreesGit 分支/工作区独立干活
实施test-driven-developmentRED-GREEN-REFACTOR 强制
实施subagent-driven-development派新子代理 + 两道审查
实施executing-plans批量执行 + 人为 checkpoint
实施dispatching-parallel-agents并行子代理
质量requesting-code-review发起代码审查
质量receiving-code-review接收并响应审查反馈
收尾finishing-a-development-branchmerge / PR / 保留 / 丢弃
调试systematic-debugging4 阶段根因排查
收尾verification-before-completion完成前证据自检
Metawriting-skills编写新技能的方法论

你不需要学全套——AI 会自己判断什么时候该用哪个。最常用的是 brainstorming、writing-plans、TDD、subagent-driven-development、verification-before-completion 这 5 个

九、上游归属

想直接装上体验?

把 obra/superpowers 项目的完整 14 个子技能 + 项目介绍 + 使用说明 + 上游归属 + MIT License 全部打包好了。装到 Claude Code / Codex / Cursor 之后,你的 AI 编程助手就再也不会”瞎写代码”了——而是按 spec-first → TDD → 子代理 → 审查 → 验证的工程纪律出活。

📦 资料包下载:https://v.v8l.cn/s/pXapAp7

默认的AI是”工具人”,装上 superpowers 变”工程团队”。14 个子技能不是增加规则,是改变 AI 的整个工作方式。代码质量提升 + 返工减少,长任务从平均 3 次返工降到 0-1 次。

#AI编程 #ClaudeCode #Codex #Cursor #superpowers #TDD #子代理 #代码审查 #软件开发方法论 #MIT

本文由 AI 辅助创作,方法论与脚本为原创,配图/排版由人工完成。