Vibe Coding 知识库

Superpowers 介绍和用法 ​

Superpowers 是一个面向 AI 编程代理的技能框架和软件开发方法论。它不是新的大模型，也不是单独的 IDE，而是一组可组合的 SKILL.md 工作流，让 Claude Code、Codex 等工具在合适的场景里先读流程、再执行任务。

它解决的核心问题是：AI 编程工具太容易“听到需求就立刻写代码”。Superpowers 把资深工程师会做的步骤写成技能：先澄清目标，再做方案，再拆计划，再写测试，再实现，再验收和 review。

它适合解决什么问题 ​

问题Superpowers 的作用
AI 一上来就写代码用 brainstorming、writing-plans 等技能强制先想清楚
大任务容易跑偏用计划、检查点、review 把任务切成小块
AI 声称完成但没有验证用 verification-before-completion 要求证据
重构越改越乱用 code-review、simplify、TDD 等流程约束改动
多个任务可以并行在支持子代理的平台上触发 subagent-driven-development

基本工作流 ​

Superpowers 官方仓库把常用流程组织成一组技能。课堂里不需要一次讲完所有技能，先掌握这条主线即可：

  1. brainstorming：需求还粗糙时，先追问目标、约束和成功标准。
  2. writing-plans：把方案拆成可以执行的小任务。
  3. test-driven-development：高风险功能先写测试，再写实现。
  4. subagent-driven-development / executing-plans：按计划执行，支持并行的平台可以分派子代理。
  5. requesting-code-review：完成后做代码审查。
  6. verification-before-completion：最终汇报前验证证据。
  7. finishing-a-development-branch：完成分支收尾、合并或保留。

在 Claude Code 里的形态 ​

Claude Code 里，Superpowers 主要表现为插件和技能。

形态说明
插件通过 Claude Code 插件市场安装，插件里打包了一组技能
Skill每个技能本质上是一个 SKILL.md，Claude 在相关任务中读取它
Slash 命令Claude Code 中技能可以像 /skill-name 一样直接调用
子代理复杂计划可以交给子代理执行，适合大任务拆分
Hooks 配合Claude Code 还支持 hooks，可在特定事件上自动执行校验、通知或拦截

官方仓库给出的 Claude Code 安装方式之一：

text
/plugin install superpowers@claude-plugins-official

也可以先添加 Superpowers 自己的 marketplace，再安装：

text
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Claude Code 的技能也可以放在个人或项目目录里：

text
~/.claude/skills/<skill-name>/SKILL.md
.claude/skills/<skill-name>/SKILL.md

课堂用法示例：

text
/brainstorming 我们要做一个 AI 项目交付看板，先帮我把需求问清楚。

或者不用显式命令，直接描述任务，让 Claude Code 根据技能描述自动选择：

text
我要重构这个管理后台，先不要写代码，帮我梳理方案、风险和验收标准。

在 Codex 里的形态 ​

Codex 里，Superpowers 主要表现为插件、Skill 和可选的子代理流程。和 Claude Code 最大的区别是：Codex 的显式调用习惯更偏 $skill-name 或插件提及，而不是 Claude Code 的 /skill-name。

形态说明
Codex 插件Codex App 可以从插件侧栏安装 Superpowers
SkillCodex 原生支持 Agent Skills，技能是带 SKILL.md 的目录
显式调用在 CLI / IDE 中可用 /skills 或 $ 提及技能；在 App 中也可以通过插件提及触发上下文
自动触发Codex 会根据技能 description 判断是否需要加载完整技能
子代理Codex 支持原生 sub-agent，适合并行分析、实现、验证

Codex 手动安装的思路是把 Superpowers 仓库里的 skills 暴露给 Codex 的技能发现路径：

bash
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

Windows 可以用 junction：

powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"

Codex App 中，如果已经安装插件，可以像这样显式告诉 Codex 使用插件上下文：

text
[@superpowers] 先用 brainstorming 梳理这个功能，不要直接实现。

也可以用 Codex 风格的技能调用：

text
$brainstorming 帮我把后台 CMS 的静态生成能力设计清楚。

Claude Code 和 Codex 的区别 ​

对比项Claude CodeCodex
常见入口/plugin、/skill-name、自动技能触发Codex 插件、$skill-name、自动技能触发
技能目录~/.claude/skills 或 .claude/skills.agents/skills、~/.agents/skills、系统/插件技能目录
插件形态Claude Code plugin，可打包 skills、commands、hooks、MCP 等Codex plugin，可打包 skills、apps、MCP 配置等
并行能力依赖 Claude Code 子代理能力和插件实现可结合 Codex 原生 sub-agent
适合课堂演示展示 slash 命令和插件安装直观展示技能自动触发、插件提及和多代理协作直观

什么时候不要用 ​

Superpowers 适合明确目标的功能开发、重构、调试和审查。下面这些情况不建议强行套流程：

  • 两三行文案修改。
  • 临时查一个命令。
  • 没有明确目标的快速试验。
  • 课堂时间很紧，只想演示某个单点命令。

它的价值在于“让 AI 慢下来并留下证据”。如果任务本身很小，流程成本可能超过收益。

培训推荐讲法 ​

面向开发和项目经理时，可以这样讲：

  1. 开发视角：Superpowers 是把 TDD、计划、review、验证这些工程纪律写成 AI 必须遵守的技能。
  2. PM 视角：它帮助团队把模糊需求变成可验证计划，减少 AI 做错方向。
  3. Claude Code 视角：重点看插件安装、slash 命令和技能目录。
  4. Codex 视角：重点看插件、$skill 调用、自动触发和子代理。
  5. 风险提醒：它不是万能自动驾驶，仍然需要人 review 方案、diff 和验证结果。

官方与权威来源 ​