Skill 说明
Superpowers 是什么
Superpowers 是给编码智能体用的一整套软件开发方法论,由一个技能库加一段启动指令组成,装好之后 agent 会在每一项任务开始前自动检查有没有对应技能,是强制执行而不是建议。
它改变的是 agent 的工作起点:当 agent 看出来你在造东西时,不会直接跳去写代码,而是先退一步问清楚你真正想做什么。拿到 spec 后拆成短段落给你确认,你签字后才生成实施计划——计划要详细到「一个积极性很高但没品味、没判断力、没有项目背景、还讨厌测试的初级工程师」也能照着做。之后进入子代理驱动开发,agent 逐个任务推进、审查自己的工作,常常能连续自主工作几个小时不偏离计划。
| 技能 | 作用 |
|---|---|
| brainstorming | 动手前问清真实意图,大改动出书面设计文档 |
| writing-plans | 把工作拆成 2-5 分钟级的小任务,附精确文件路径与验证步骤 |
| using-git-worktrees | 在新分支建隔离工作区,确认测试基线干净 |
| test-driven-development | 强制 RED-GREEN-REFACTOR,先写失败测试,删掉测试前写的代码 |
| requesting-code-review | 任务之间按计划审查,严重问题阻塞推进 |
| systematic-debugging | 四阶段根因排查流程 |
| finishing-a-development-branch | 收尾时验证测试并给出合并 / PR / 保留 / 丢弃选项 |
支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kimi Code、Qwen Code、Pi、Antigravity、GitHub Copilot CLI、Grok Build、Devin CLI、Factory Droid、Hermes Agent、Muse 等十余种 harness。项目采用 MIT 协议,GitHub 上约 31.4 万 star。
Superpowers 怎么安装
不同 harness 装法不同,用几个就分别装几次。Claude Code 走官方插件市场最省事:
/plugin install superpowers@claude-plugins-official也可以注册作者自己的市场:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace其他常用 harness:
# Gemini CLI
gemini extensions install https://github.com/obra/superpowers
# Qwen Code
qwen extensions install obra/superpowers
# Antigravity
agy plugin install https://github.com/obra/superpowers
# Pi
pi install git:github.com/obra/superpowersSuperpowers 怎么使用
- 装好后重启对应 agent,启动时会自动注入 using-superpowers 引导,不需要每次手动开。
- 直接描述你想做的东西,brainstorming 技能会主动追问,把小改动在对话里谈定,大项目生成设计文档。
- 设计确认后自动进入 writing-plans,得到带文件路径和验证步骤的任务清单。
- 任务执行阶段:要最彻底就选子代理驱动开发(每任务一个新子代理 + 评审),要最省钱就在当前会话内联执行、最后统一评审一次。
- 过程中 agent 必须遵守 TDD,先写失败测试再写实现,跳过测试写的代码会被删掉。
- 任务之间自动做代码审查,严重问题会挡住后续推进。
- 全部完成后自动验证测试,并让你选合并、提 PR、保留分支还是丢弃。
- 如果某个会话行为异常,直接说「figure out what went wrong with superpowers in this session」,会调起诊断技能读会话记录给出逐行证据。
Superpowers 适合谁用
- 用过编码 agent 但受不了它不沟通就乱写、写完还自信满满的人
- 要把 AI 生成代码放进生产环境的团队,需要强制 TDD 和评审留痕
- 需要长任务自主执行的场景,希望 agent 连续跑几小时不跑偏
- 同时使用多种编码 agent、想要一套统一工作流的人
- 想自己写技能扩展 agent 能力的开发者,仓库里有 writing-skills 最佳实践
Superpowers 项目地址
- GitHub 仓库:https://github.com/obra/superpowers
- 技能市场仓库:https://github.com/obra/superpowers-marketplace
- 官方博客发布说明:https://blog.fsck.com/2025/10/09/superpowers/
- 作者团队官网:https://primeradiant.com/superpowers/
- 问题反馈:https://github.com/obra/superpowers/issues