Superpowers技能库完整教程:让AI编程Agent按7步流程独立交付一个项目
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套可插接到 Claude Code、Codex、Cursor、OpenCode 等 AI 编程Agent的Agent技能框架与软件开发方法论。装好之后,Agent 看到你要做功能时不会直接开写代码,而是先澄清需求、产出设计文档和 2-5 分钟粒度的任务清单,再派子Agent逐任务实现、自审、合并。它相当于给Agent配了一套有纪律的工程团队,而不是一个抢着写代码的实习生。
Agent最大的坑:拿到需求就动手写代码
想象一下:你输入"给后台加个数据导出功能",Agent 立刻开始建目录、写路由、接数据库,半小时后交给你一个"看起来对"但漏掉权限控制、格式选项全靠自己猜的实现。
Superpowers 用一条硬性规则堵住这个坑:它的using-superpowers技能要求 Agent 在任何响应之前(包括追问和探索代码库)先检查有没有匹配的技能,只要判断有 1% 可能相关就必须调用。技能是强制工作流,不是建议。你不需要记任何咒语,技能会按场景自动触发。
多平台怎么装:一张表选你的Agent
Superpowers 以插件/技能包形式分发,用哪个 Agent 就装在哪,多平台混用则各装各的:
| 平台 | 安装方式 |
|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official |
| Cursor | 在 Agent 对话中执行/add-plugin superpowers |
| Codex CLI | /plugins打开插件搜索,输入superpowers安装 |
| Codex App | 侧边栏 Plugins 里找到 Superpowers,点+按提示安装 |
| Kimi Code | /plugins进入 Marketplace 安装 Superpowers |
| OpenCode | 仓库克隆 + 插件链接(见下方命令) |
OpenCode 需要手动克隆一次,这是少数要动手的平台之一:
git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.config/opencode/superpowers后续更新都很轻:Claude Code、Codex 等平台的插件更新通常自动完成;OpenCode 进入克隆目录执行git pull后重启即可。Gemini CLI、Copilot CLI、Pi、Antigravity 也都有对应插件入口,具体命令见仓库根目录 README.md 的 Installation 章节。
七步工作流:它替你管住了整个开发过程
装好后不用手动调用任何技能,一条完整开发线自动推进。
第1步 先设计:brainstorming 连环追问
brainstorming 技能在写任何代码前激活。它先读项目上下文,然后一次只问一个问题,逼你把目的、约束、成功标准说清楚,接着给出 2-3 个方案附取舍分析,最后分节展示设计逐节等你点头。简单的项目设计可以只有几句话,但"必须先过设计关"这条门禁对所有项目生效——README 明确写了反模式:"这个项目简单到不需要设计"恰恰是最容易白干活的场景。
第2步 隔离工作区 + 拆出 2-5 分钟的任务清单
设计获批后,using-git-worktrees自动新开分支和独立 worktree,先跑一遍测试基线确认环境干净,避免改动污染主分支。随后writing-plans把设计拆成每个 2-5 分钟的小任务,每个任务带精确文件路径、完整代码和验证步骤,标准是"一个没有判断力的初级工程师也能照着做对"。
第3步 让子Agent干活的执行方式
计划就绪后进入subagent-driven-development:每个任务派一个全新子Agent实现,上下文隔离、指令精准;每完成一个任务做两轮审查——先查是否符合规格,再查代码质量,最后对整个分支做一次总审查。任务之间不打断你,Agent 可以连续自主工作几个小时不偏离计划。
第4步 质量关卡与系统化调试
实现过程由test-driven-development强制 RED-GREEN-REFACTOR:先写失败测试、看它失败、写最少代码、看它通过、提交——测试之前写的代码会被要求删掉。代码提交前走requesting-code-review预审查清单,按严重级别报告问题,关键问题直接阻塞进度。
遇到 bug 时不要猜,systematic-debugging有四阶段铁律:没有完成根因调查就不许提修复方案;修完还要过verification-before-completion确认"真的修好了"而不是"看起来好了"。
第5步 收尾合并
全部任务完成后,finishing-a-development-branch验证测试,给你合并、发 PR、保留或丢弃四个选项,并清理 worktree,不会留下一个没人管的工作分支。
想加自己的技能怎么办
技能库本身就是文档驱动的:每个技能就是一个目录里的 SKILL.md。skills/writing-skills/提供了写新技能的完整规范和子Agent测试方法论,照着改即可;各平台适配差异可查 skills/using-superpowers/references/ 下的平台说明。贡献流程见 README.md 的 Contributing 一节——注意官方一般不直接收新技能,但技能修改必须全平台可用。
如何开始上手与去哪里找帮助
建议路径:挑你主力用的 Agent 按上表装好 → 随便开一个小功能需求(比如"给 README 加个安装章节")→ 观察它如何自动走 brainstorming 到计划、执行的完整流程,这一轮下来你就理解了整套机制。想深入细节,看 docs/ 目录下的设计文档与 tests/ 里的各平台测试脚本;社区问题可以走项目官方 Discord 群和 GitHub Issues 页(入口在 README 末尾的 Community 一节)。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考