如何让 AI 编程助手按职业流程写代码:Superpowers 快速上手
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
如果你正在遇到这种场面:让 AI 编程助手加个功能,它不问需求直接写代码,写到一半又跑偏。Superpowers 是套给编码代理装的技能框架,把头脑风暴、测试先行、代码审查这些习惯,固化成会自动触发的技能,让助手每次开工都先走流程。
它的机制不复杂:会话一开始,代理会先检查当前任务匹配哪个技能,命中就执行,不命中才自由发挥。装好之后你不用改任何说话方式,照常说"帮我加个登录",流程是它自己接上的。
它在你不同场景能做什么
| 你卡在哪 | 它会做什么 | 你得到什么 |
|---|---|---|
| 想法模糊,说不清要什么 | 连续提问,把设计拆成短段给你确认 | 一份看得懂的设计文档,而不是一堆代码 |
| 要动现有项目 | 自动建独立 worktree 分支,先确认现有测试是绿的 | 改动不碰主分支 |
| 写新功能 | 先写测试,看到失败再写代码,直到变绿 | 每行代码背后都有测试 |
| 遇到奇怪 bug | 走四阶段根因流程,不靠猜测打补丁 | 修复可复现,不复发 |
| 任务很多 | 拆成 2-5 分钟的小块,每块派一个子代理,块间两阶段审查 | 它能自主跑几个小时不跑偏 |
| 做完了不知道怎么办 | 跑全量测试,给出合并、提 PR、保留三个选项 | 干净的分支和明确的收尾 |
这些技能都放在 skills/ 目录下,一个技能一个文件夹,各平台共用同一套,没有隐藏的核心模块。
三步装好:一条命令或一次克隆
配置分层,先装最低要求,够用再往上加。
最低要求:Claude Code 一条命令装完
/plugin install superpowers@claude-plugins-official怎么判断成功了:开一个新会话说"帮我加个功能",代理先问需求而不是直接写代码,就是生效了。
标准配置:其他平台一次克隆到位
git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.config/opencode/superpowersOpenCode 放上面的目录;Codex 则克隆到~/.codex/superpowers。
怎么判断成功了:重启平台,新会话里代理会主动说明它要先走设计流程。
可选增强:可视化伴侣和并行工作区
熟悉之后不用额外配置:worktree 在流程中自动创建;头脑风暴阶段有个可选的可视化伴侣,会开一个本地页面展示设计框架。不感兴趣也不影响主流程。
跑完一个任务:从一句话到合入分支
选最常见的场景:给现有服务加登录功能。
你只输出一句:
你:给这个服务加个登录功能 它:我先用 brainstorming 问几个问题……(3 轮后给出分段设计) 你:设计没问题,go 它:建 worktree → 拆 8 个小任务 → 逐个派发子代理执行它做的事分三段。设计段:不写代码,先问范围、角色、现有鉴权方式,再把设计一段段拿给你确认。执行段:每个任务开工前触发对应技能,测试先行的循环严格执行,任务之间自审,关键问题会挡住后续进展。收尾段:全部完成后跑全量测试,给你合并、PR、保留的选项。
你得到的是:一个测试全绿的合入分支、一份可追溯的设计文档和任务计划,以及你说话方式的零改变。
新手容易卡住的五个问题
Q:装好了,代理还是直接写代码,不走流程。 A:旧会话没重新加载,技能在会话启动时注入;重启平台并开新会话。
Q:设计阶段问得太快,觉得拖慢进度。 A:那些问题决定文档内容;直接回答,比事后返工省轮次。
Q:子代理开发跑太久,能停吗。 A:每个任务只有 2-5 分钟,块间有审查;随时喊停,当前进度已落在计划文档里。
Q:多个平台能共用一份安装吗。 A:不能。每个编码平台有自己的插件体系,需分别安装。
Q:worktree 这个概念不熟,会受影响吗。 A:把它当成项目的隔离副本;代理负责创建,你只需记住分支名。
想深入,看这三个地方
- 想验证某个技能的行为是否符合预期,测试方法在 docs/testing.md
- 想写自己的技能,规范和测试方法都集中在 skills/writing-skills/
- 可视化伴侣的完整说明见 skills/brainstorming/visual-companion.md
把流程交给它,把判断留给自己。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考