让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 插件安装
添加插件市场
/plugin marketplace add obra/superpowers-marketplace
在市场中安装 Superpowers
/plugin marketplace add obra/superpowers-marketplace
重启 Claude Code
自检。输入
/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 的差别。
希望这期内容能对你有所帮助。
喜欢的话,记得点赞收藏转发,我们下期再见。
没有评论:
发表评论