Superpowers 技能使用简介

---

全文链接：Superpowers 技能使用简介

---

收录开源项目 obra/superpowers 的核心概念：可组合 Skills 技能库、多宿主插件挂载、内置技能职责，以及 功能开发 / 缺陷排查 / 并行子 Agent 三类典型工作流。面向 Cursor Agent、Claude Code、Codex 等编程智能体场景。

---

它是什么

Superpowers 不是某个大模型，而是挂在宿主（插件 / Harness）里的 行为规范与流程模板：

要点	说明
技能载体	skills/<技能名>/SKILL.md，YAML 头含 name、description，供触发与检索
执行原则	任务前先查适用技能；有则必须加载并遵照（强制流程，非泛泛建议）
元技能	using-superpowers 约定何时调用 Skill、与用户指令优先级、各宿主挂载方式
Cursor 集成	.cursor-plugin/plugin.json + sessionStart 钩子，会话启动即「先找技能」

一句话：把 TDD、调试、结对设计、拆计划、代码评审等实践，落成智能体可读、可复用的操作规程。

---

适用场景

维度	说明
解决什么	抑制「一上来就写码」；长任务对齐 澄清需求 → 设计 → 拆解 → 实现 → 验证 → 收尾
适合谁	已用 Cursor Agent / Claude Code / Codex，希望流程 稳定、可复盘 的开发者或小团队
不太适合	只问一两个语法点的短对话；或坚持完全自定义提示、不愿被技能抢占流程时
典型收益	设计/计划有默认落盘位（docs/superpowers/specs/、docs/superpowers/plans/）；TDD、评审、分支收尾有清单可依

---

仓库结构（摘要）

类别	代表路径	作用
插件入口	.cursor-plugin/plugin.json、.claude-plugin/、.codex-plugin/	多宿主声明 skills / agents / commands / hooks
会话钩子	hooks/session-start	bootstrap，加载「必须先考虑技能」行为
技能本体	skills/*/SKILL.md	各主题操作规程（核心）
子 Agent	agents/code-reviewer.md	评审向 Agent 人设
文档样例	docs/superpowers/specs/、plans/	设计稿与实现计划默认落盘区

旧版 commands/brainstorm.md、write-plan.md、execute-plan.md 已 Deprecated，请改用对应 技能 目录。

---

内置技能一览

流程与设计

技能	作用
using-superpowers	元技能：何时必须调用 Skill、优先级、多平台工具对照
brainstorming	动工前澄清意图、对比方案、落盘设计；未认可设计不得实现
writing-plans	可执行实现计划（小步任务、文件边界、测试方式）
executing-plans	按计划批量执行，带人类检查点
subagent-driven-development	子 Agent 驱动 + 两阶段审查（规格对齐、代码质量）
dispatching-parallel-agents	并行子智能体编排
using-git-worktrees	worktree / 分支隔离、基线测试校验

质量与收尾

技能	作用
test-driven-development	红—绿—重构、先测后实现
systematic-debugging	复现 → 假设 → 最小实验 → 根因分层
verification-before-completion	宣称「修好」前的核验清单
requesting-code-review	发起评审，重大问题阻断推进
receiving-code-review	接收评审反馈的处理节奏
finishing-a-development-branch	验证、Merge/PR、worktree 清理
writing-skills	编写新技能的规范（维护者向）

---

三类典型工作流

场景 A：功能开发（一句话需求 → 可合并分支）

例子：「做一个 React 待办列表，支持新增、勾选完成。」

未挂载时模型易直接写组件；挂载后 brainstorming 会先对齐成功标准与技术取舍，写入设计文档，用户认可后才拆任务编码。

用户想法
  → brainstorming（设计落盘 specs/，用户认可）
  → using-git-worktrees（可选：分支隔离、基线测试绿）
  → writing-plans（plans/ 原子任务 · 路径 · 如何测）
  → subagent-driven-development / executing-plans
      ├── test-driven-development
      ├── requesting-code-review
      └── systematic-debugging / verification-before-completion
  → finishing-a-development-branch（PR / Merge）

实质：在需求、设计、开发、评审、收尾各段插入 门禁，减少返工。

场景 B：线上缺陷排查

现象报告（报错、 flaky、回归）
  → systematic-debugging（证据优先，非「抢着改一行试试」）
  →（若改代码）test-driven-development + verification-before-completion

与仓库哲学 Evidence over claims 一致。

场景 C：并行子 Agent

任务可切分且无强顺序依赖时，在 已定计划 下用 dispatching-parallel-agents 并行委派，汇总点再做集成与评审。

---

安装与延伸阅读

资源	链接
GitHub 仓库	https://github.com/obra/superpowers
Cursor 安装	README：/add-plugin superpowers
本站完整版（全目录表、流程图、各宿主说明）	Superpowers 技能使用简介

标签：AI AI编程 Superpowers Agent Skills Cursor Claude Code