Superpowers完整指南:给你的AI编码代理配上一整套专业开发技能
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers是一套面向AI编码代理的技能框架与软件开发方法论。它会根据你的当前情境自动激活头脑风暴、TDD、代码评审等技能,让代理不再一头扎进写代码,而是先想清楚再动手,测试通过才算完。适合所有用AI代理做真实项目开发的你。
3分钟装好:不写一行配置就能跑起来
如果你用Claude Code,在代理对话框里输入一行安装命令/plugin install superpowers@claude-plugins-official就完事了,官方插件市场里已经上架。
Codex CLI、Cursor、Gemini CLI、Kimi Code等工具各有对应的一行命令或市场入口,在 README.md 里可以找到你正在用的那一款。想读源码或参与贡献,先把仓库克隆到本地:git clone https://gitcode.com/GitHub_Trending/su/superpowers。
装完没有任何额外配置。你能感受到的第一个变化:告诉代理"给这个项目加个登录功能",它不会直接开写,而是先连问一串需求问题,把设计掰开揉碎讲给你听,逐项确认后才开工。
核心概念:看懂这三个就通了大半
技能:不是参考文档,是强制流程
skills/ 目录下每个文件夹就是一个技能:brainstorming、writing-plans、test-driven-development、systematic-debugging……技能和普通提示词文档的区别在于"触发时机"——代理在动手前必须检查相关技能,触发后就是必须执行的流程,不是建议。这个设计解决的是通用痛点:代理发挥不稳定,技能把"好习惯"变成了可复用的流程。
子代理开发:有人干活,有人验收
subagent-driven-development技能 把计划拆成2~5分钟的小任务,每个任务派一个全新子代理去做,做完再过两道审查:先查是否符合规格,再查代码质量。为什么每次都要新代理?长对话里代理容易走神,新代理状态干净。正因如此,主代理能自主跑上几个小时还不偏航。
TDD与验证:别信"我修好了"
test-driven-development 强制"先写会失败的测试,再写最少的代码让它通过"的循环,测试之前写的代码直接删掉重来。verification-before-completion 更进一步:没有测试输出当证据,就不许宣布完成。担心AI产出"看起来对但实际错",这就是核心答案。
场景化实践:按你想做的事来
从零开始新项目
代理一发现你在做东西,brainstorming 就会自动启动:一问一答把需求聊清楚,设计分段展示给你读,你点头后存成设计文档。接着 writing-plans 把设计变成实现计划,每个任务都写明白具体文件路径、完整代码和验证步骤。
改造已有代码库
从 using-git-worktrees 开始:开新分支建隔离工作区,跑项目初始化,确认基线测试通过。之后的改动全部隔离,弄坏了也不伤主线,对测试套件很长的老项目尤其重要。
交付前验证
任务做完后,finishing-a-development-branch 会跑完整测试,再给你选择:合并、提PR、保留还是丢弃。中途测试挂了,systematic-debugging 接手:四阶段根因分析,先找根因再动手,不靠猜,是技能库里最有价值的几项之一。
进阶技巧:手册里没细说的三件事
- 多个工具要分别安装:Superpowers按harness独立安装,你同时用Claude Code和Cursor,就得两边各装一份,不共享。
- 遥测可以关掉:可视化伴侣功能默认会上报版本号,设置
SUPERPOWERS_DISABLE_TELEMETRY为任意真值即可关闭,不影响任何行为。 - 别硬跳过流程:代理开始问需求问题时,它不是磨叽,是系统在工作。任务越复杂收益越大;小改动可以直接下指令,不用全流程走一遍。
Superpowers把AI编码代理的开发流程从"看运气"变成了"讲流程"。现在就给你最常用的编码代理装上它,说一句"帮我做个东西"试试。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考