2026年1月28日星期三

Superpowers

让AI编程告别"屎山"的工程化工作流。37K星开源项目通过7步流程(需求梳理、计划拆解、测试优先等)和14个预设技能,将Coding Agent从随意编码升级为稳定交付的工程流程,显著提升代码质量和可控性。

Github 有一个开源项目紧随 OpenCode 其后,冲到月榜第 2,Star 已经到 3.7 万

图片

说实话,我最近对各种 AI 编程神器已经有点免疫了,天天上热榜,天天颠覆。

但这个项目确实让我停下来认真看了半小时。

这是给 Coding Agent 准备的一套软件开发工作流。它把一整套可复用的 skills 和方法论打包好,让 Agent 按步骤把需求、设计、计划、执行一路跑完。

有了 skills,就可以不用纠结提示词怎么写了,skills 模板都帮你写好,可以大幅节省 tokens 消耗,让任务完成得更好。在提效这一块,确实很给力。

我点进去试了下,顺手用它做了一个职场说话保命神器。

Agent 不再上来就乱写,而是先澄清需求确认方案拆计划,再按步骤交付。开发节奏明显更像资深工程师

图片
图片

一、Coding Agent 工程化工作流

这个项目叫 Superpowers。主打把 Coding Agent 从会写代码的聊天框,升级成一套可重复执行的工程流程。它把需求澄清、方案确认、计划拆解、分批执行、测试与复盘这些动作写进默认路径里,让 Agent 按规矩把事做完。

图片

开源地址:https://github.com/obra/superpowers

它的核心流程主要有 7 步。

1. 头脑风暴

动手写代码前先做需求与方案的梳理。它会通过连续提问把模糊想法收敛成清晰需求,同时把可选方案摊开对比。输出会按段落分块给你确认,并把最终结果保存成设计文档。

2. 使用 Git 工作树

设计通过后再进入开发准备。它会在新分支上创建隔离工作区,完成项目初始化,并先跑一遍基线测试,确保当前环境干净可控。

3. 编写实现计划

基于已确认的设计,把工作拆成 2 到 5 分钟一块的小任务。每个任务都写清楚具体文件路径、需要完成的改动点,以及明确的验证步骤,保证计划可以直接执行。

4. 子代理驱动开发或按计划分批执行

进入实现阶段后,它可以为每个任务分配一个新的子代理执行,并进行两阶段检查,先看是否符合规格,再看代码质量。另一种模式是分批推进,每批之间设置人工检查点,降低跑偏与返工的概率。

5. 测试驱动开发

实现过程中强制遵循红-绿-重构循环。先写测试让它失败并确认失败,再写最小实现让测试通过,最后再重构并提交。如果出现先写代码再补测试的情况,会要求删除这段实现,按红-绿-重构重新走一遍。

6. 请求代码审查

在任务与任务之间插入审查环节。对照实现计划逐项检查,按严重程度汇报问题。关键问题会阻断继续推进,确保进度建立在可验证的质量之上。

7. 完成开发分支

所有任务完成后统一收尾。再次验证测试通过,并给出后续处理选项,比如合并、提交 PR、保留分支或丢弃分支。同时清理工作树与临时环境,把项目状态恢复到可继续迭代的基线。

除了这 7 步主流程,Superpowers 还内置了一个 skills 库,一共 14 个 skills,把开发里最常见的关键环节都打包好了,覆盖测试、调试、协作、元技能四大类。

图片

它背后强调的理念也很明确,测试优先流程优先复杂度最小化先验证再宣告完成

换句话说,它更关注交付稳定性。你把需求说清楚之后,流程会推动 Agent 按顺序完成设计确认计划拆解实现测试验证。关键节点会强制校验,如果测试不过会直接停下。

很多 Agent 往往一次性能给我交付结果,功能看着都有,但质量完全不可控测试经常不过,咱们还要经常面对一堆屎山代码而不知所措。

Superpowers 就像给 AI 配了一套工程监控机制,把专业开发里的固定动作变成强约束。结果也很直接,代码质量更高返工更少维护成本更低

二、快速上手

安装很简单,按不同的平台有些区别,Claude Code 最省事,两条命令就能装好。

方式一 :Claude Code 插件安装

  1. 添加插件市场
/plugin marketplace add obra/superpowers-marketplace
  1. 在市场中安装 Superpowers
/plugin marketplace add obra/superpowers-marketplace
  1. 重启 Claude Code

  2. 自检。输入 /help,确认能看到下面这些命令。能看到就说明安装成功了

/superpowers:brainstorm
/superpowers:write-plan
/superpowers:execute-plan

方式二 :OpenCode

OpenCode 需要手动安装。做法很简单,让 OpenCode 直接拉取仓库里的安装文档,然后按文档步骤执行即可。

拉取指令


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

方式三:Codex

Codex 也需要手动安装。思路和 OpenCode 一样,让 Codex 拉取仓库提供的安装文档,然后按步骤执行即可。

拉取指令

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

后续升级也很简单,直接执行下面这条命令就行。更新完成后建议重启一次,确保新版本生效

/plugin update superpowers

三、项目实测

接下来,带大家一起实际体验一下这个项目。

第一步,安装 Superpowers。

我使用的是 Claude Code,输入上面的两行代码。不到一会,Superpowers 插件就安装好了。

/plugin marketplace add obra/superpowers-marketplace
/plugin marketplace add obra/superpowers-marketplace

第二步,开发职场说话保命神器。

我们用一个案例测试一下这个项目到底怎么样,背景是这样的:

在公司里遇到点糟心事,有时候真的很想直接怼回去。

但手指停在发送键前,又开始犹豫。怕一句话说重了得罪人,怕把关系搞僵,怕最后显得自己不专业。

那不如来做个职场说话保命神器

把我心里那句气话丢进去,让它给我生成几种不同语气的可发送版本。

我跟 Superpowers 说了想法之后,它没有急着写代码,而是把关键条件一条条问清楚。先确认应用形式,是做网页、命令行还是插件。

图片

这里我选了网页应用。它立刻追问第二个关键点,5 种语气要怎么定,是固定预设、用户可选,还是智能匹配。

图片

这里,我选了固定 5 种,并把语气定成道歉版、解释版、客气版、强硬版、阴阳版。接着它又问了一些问题,比如要不要登录和历史记录。

这些基本信息敲定后,它开始把设计方案分段抛出来让我确认。先给整体架构,再给 UI 交互细节,还画了一个可视化的页面布局示意图,输入框放哪、5 张卡片怎么排、复制按钮怎么做,一眼就能看懂。

图片

在适当跟它沟通调整页面 UI 后,它开始跟我对齐核心功能实现

Prompt 怎么写,5 种语气的定义怎么约束,输出统一为 JSON 方便前端解析。接口层怎么做输入校验,空输入、超字数怎么提示,API Key 无效、请求超时、额度不足这些边界情况怎么兜底,甚至连项目的文件结构一键启动命令都给我列得明明白白。

图片
图片

等这些都确认完,它才开始进入开发阶段。整个过程很像有个专业的产品经理技术负责人在前面把需求卡住,最后再把实现落地。

不到一会儿,一个能本地跑起来的版本就出来了。

图片

我输了一句试了下,效果出乎意料地稳,一次就跑通,没有任何 Bug。

它给的 5 种语气版本,每一种都挺像真人说话的,不是那种 AI 味很重的套话。

真要遇到棘手场面,直接就能发过去。

图片

说到底,Superpowers 的价值不在于让 Agent 写得更快,而是让它写得更稳、更可控

它把资深工程师那些默认动作写进强约束流程先澄清需求,再对齐方案,再拆计划、按步交付,最后用测试验收把质量钉死。

如果你也受够了 Agent 一顿猛写,最后只留下一堆屎山代码,不妨试试这套工作流。建议先从 brainstorm 和 write-plan 跑一遍,你会立刻感受到它和常见 Agent 的差别。

希望这期内容能对你有所帮助。

喜欢的话,记得点赞收藏转发,我们下期再见。

没有评论:

发表评论

腾讯“元宝派”内测引爆AI社交,百人群聊秒满,微信QQ首度打通

2026年腾讯推出AI社交功能"元宝派",用户可创建百人群聊,微信QQ好友首次互通。元宝集成对话、生图、总结等AI能力,斗图聊天趣味十足,未来将打通腾讯全生态。目前内测火爆,功能持续优化中。 劲爆的东西来了。 2026年开年,腾讯正式进军AI社交赛道。 元...