Superpowers(开发方法论技能)

作者 设施特

让 AI 写代码最崩的不是写错,是它不问你想要什么就闷头开写,写完还自认为对。Superpowers 给编码 agent 装一套强制流程:先问清需求、出设计文档、拆成分钟级任务、真红绿 TDD,每步都要证据。GitHub 31.4 万 star。

Github
Skill 编程开发 v1.0.0 热度 0

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-50(Superpowers(开发方法论技能))。
详情页:https://www.cweto.cn/work-50.html
GitHub:https://github.com/obra/superpowers
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

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/superpowers

Superpowers 怎么使用

  1. 装好后重启对应 agent,启动时会自动注入 using-superpowers 引导,不需要每次手动开。
  2. 直接描述你想做的东西,brainstorming 技能会主动追问,把小改动在对话里谈定,大项目生成设计文档。
  3. 设计确认后自动进入 writing-plans,得到带文件路径和验证步骤的任务清单。
  4. 任务执行阶段:要最彻底就选子代理驱动开发(每任务一个新子代理 + 评审),要最省钱就在当前会话内联执行、最后统一评审一次。
  5. 过程中 agent 必须遵守 TDD,先写失败测试再写实现,跳过测试写的代码会被删掉。
  6. 任务之间自动做代码审查,严重问题会挡住后续推进。
  7. 全部完成后自动验证测试,并让你选合并、提 PR、保留分支还是丢弃。
  8. 如果某个会话行为异常,直接说「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