Superpowers:5 步让 AI 编码代理学会"先想清楚再写代码"
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个 AI 编码代理技能库,把 TDD、子代理协作等完整开发方法论装进你的编程代理,解决"AI 不假思索就乱写代码"的问题,让它按可审查、可测试的方式交付。
一句话定位
Superpowers 是装在你的编码代理(帮你写代码的 AI 助手)上的一整套"作业规范",让你说一句需求,它就自动走完"想设计 → 拆任务 → 干活 → 自审测试"的完整流程。
核心能力速览
- brainstorming(头脑风暴设计):解决"AI 一上来就写代码,方向全错"的问题,先一次一个问题地摸清你的真实需求,再分段给你看设计。
- writing-plans(写实施计划):把活拆成 2-5 分钟一个的任务,每个任务写清文件路径和验证步骤,代理连跑几小时也不跑偏。
- subagent-driven-development(子代理驱动开发):给每个任务派一个全新的子代理(帮你跑专项任务的 AI 小助手),干完做两轮审查再放行。
- test-driven-development(测试驱动开发):强制 RED-GREEN-REFACTOR 循环,测试没写之前写的实现代码会被直接删掉。
- systematic-debugging(系统化调试):从症状一路追到根因的四阶段流程,治"AI 碰运气改代码"的毛病。
它是怎么跑起来的
装好之后技能会自动触发,你不需要任何额外操作。输入就是一句"我想做个 XX"。
先触发的是 brainstorming 技能:代理不写代码,只提问,把你的想法磨成设计文档(存在docs/superpowers/specs/目录),你逐段确认。接着 using-git-worktrees 开一个隔离工作区,writing-plans 产出细粒度计划。
你说"开始"之后,subagent-driven-development 接管:每个任务派一个子代理,按 TDD 干活,完成后过"规范符合性 → 代码质量"两道审查。输出是一个测试全绿的分支,外加合并或提 PR 的建议。
典型使用场景
如果你正在让 AI 开发新功能,装好 Superpowers 后只丢一句需求即可,它会先产出设计文档让你审,不会闷头写。设计流程细节见 skills/brainstorming/SKILL.md。
如果你正在不放心 AI 独立跑大任务,可以靠子代理驱动开发:每个任务独立执行并两轮审查,预期效果是代理自主工作一两小时而不偏离计划,流程见 skills/subagent-driven-development/SKILL.md。
如果你正在被 bug 追着跑,让代理触发系统化调试技能:先定位根因再动手修,修完还要验证确实修好了才算完成。
5 分钟上手
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/su/superpowers - 在你的编码代理里装插件,以 Claude Code 为例:
/plugin install superpowers@claude-plugins-official - 浏览 skills/ 目录,每个子目录是一个技能,重点读 skills/using-superpowers/SKILL.md 了解触发机制
- 开个新会话说"我想做 XX",代理会先进入头脑风暴流程
- 设计文档通过后回复"开始",观察子代理逐个跑 TDD 循环
踩坑 & 注意事项
- ⚠️ 多代理不共享安装:你同时用 Claude Code 和 Cursor 的话,每个编码代理都要单独装一份,否则有的平台"有超能力"、有的"裸奔"。
- ⚠️ 别跳过设计审批:"反正就改一行"也走 brainstorming 流程,这正是省返工最多的一步,不是官僚。
- ⚠️ TDD 是硬规则:代理写测试前先写的实现代码会被删掉,别试图让它"这次先省了"。
- 💡 头脑风暴的可视化伴侣默认会加载一个带版本号的徽标(不含你的项目内容),介意的话设环境变量
SUPERPOWERS_DISABLE_TELEMETRY即可关闭。
现在就去跑那条安装命令,让你的代理交出第一份设计文档。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考