⚡ 一眼定位 >>>
Superpowers 是一套面向 AI 编码代理的技能仓库，把「先澄清、再计划、再分解、再执行、最后验证/审查/收尾」固化成可复用流程。它不是单一 CLI，而是给 Claude Code、Cursor、Codex、OpenCode、Gemini CLI 等工具提供 skills、commands、hooks、agents 的协作层。
最短使用路径
1. 先把 Superpowers 接到你的代理客户端。
2. 先走 `brainstorming`，不要直接开改。
3. 再用 `writing-plans` 输出可执行计划。
4. 需要并行时切 `subagent-driven-development` 或 `using-git-worktrees`。
5. 实现时按 `executing-plans` 推进，收尾前做 `verification-before-completion` 和 `requesting-code-review`。
适合什么任务
- 新功能从 0 到 1
- 复杂 bug 定位与修复
- 多文件重构
- 需要并行代理协作的任务
- 提交前需要证据链和复审的交付
🍳 起手工作流 >>>
Recipe 1: 需求还不清楚
先用 `brainstorming`。
把目标、约束、风险、可选方案讲清楚，再决定是否进入实现。
Recipe 2: 已有方向，要先对齐计划
用 `writing-plans` 输出分阶段计划。
计划里要包含：边界、依赖、回滚点、测试点、验收标准。
Recipe 3: 任务可拆分并行
先用 `subagent-driven-development` 拆任务。
把实现、测试、文档、验证分给不同子代理，避免单线串行。
Recipe 4: 开始真正改代码
用 `executing-plans` 按已批准计划推进。
先做最小可行修改，再补测试，再做清理。
Recipe 5: 发现 bug
先用 `systematic-debugging`。
复现 -> 缩小范围 -> 找根因 -> 做最小修复 -> 验证。
Recipe 6: 提交前收尾
先跑 `verification-before-completion`，再请求 `requesting-code-review`。
最后用 `finishing-a-development-branch` 做分支收口、摘要和交接。
🧭 技能地图 >>>
| 技能 | 作用 | 典型触发点 |
|---|
| using-superpowers | 总入口，要求先调用合适的技能再回答 | 刚接手项目、需要遵循流程时 |
| brainstorming | 澄清问题、约束和方案 | 需求模糊、选型不确定 |
| writing-plans | 生成可执行计划 | 先对齐后动手 |
| using-git-worktrees | 用 worktree 隔离并行工作 | 多方案试验、多个代理并行 |
| subagent-driven-development | 把大任务拆给子代理 | 信息分散、适合并行 |
| executing-plans | 按计划实际落地 | 计划已确认，可以修改代码 |
| test-driven-development | 先测试后实现，或者补齐测试链 | 核心逻辑、回归风险高 |
| systematic-debugging | 结构化定位问题 | 线上/本地失败、复现不稳定 |
| verification-before-completion | 完成前最终检查 | 准备交付、准备合并 |
| requesting-code-review | 发起代码审查 | 进入 review 阶段 |
| finishing-a-development-branch | 收尾、总结、合并前清理 | 开发闭环 |
触发顺序建议
brainstorming -> writing-plans -> subagent-driven-development -> executing-plans -> verification-before-completion -> requesting-code-review -> finishing-a-development-branch
🔌 平台接入 >>>
Claude Code / Cursor
通过官方插件/市场流程接入 Superpowers。
接入后，优先让系统自动发现 `skills/`、`commands/`、`hooks/`、`agents/`。
Codex
# 关键路径来自仓库文档
~/.codex/superpowers
~/.agents/skills/superpowers
# 常见做法是把仓库放到 ~/.codex/superpowers，
# 再把 skills 目录链接到 ~/.agents/skills/superpowers，然后重启客户端。
OpenCode
按 OpenCode 的 plugin 机制把仓库 URL 加进去，然后重启。
核心目标是让 Superpowers 的 skills 在会话启动时可见。
Gemini CLI
gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers
🧱 仓库骨架 >>>
| 目录 / 文件 | 作用 |
|---|
| skills/ | 核心技能库，定义应该先想什么、再做什么 |
| commands/ | 可直接调用的命令入口 |
| hooks/ | 前后置事件，负责自动化触发 |
| agents/ | 专门化代理配置 |
| docs/ | 平台接入与工作流说明 |
| RELEASE-NOTES.md | 版本更新和变更记录 |
🧠 使用规则 >>>
using-superpowers- 用户的明确指令优先级高于技能建议。
brainstorming writing-plans- 需要并行时，优先拆分成可独立验证的小任务。
verification-before-completionrequesting-code-review
推荐提示词
请按 superpowers 流程处理这个需求：
先 brainstorming，再 writing-plans。
如果可以并行，就用 subagent-driven-development。
实现时按执行计划推进，最后做 verification-before-completion 和 code review。
- 只接入仓库，不触发 skills，等于只装了壳，流程不会自动变好。
- 需求不清楚就直接实现，后面通常会返工。
- 多代理并行时不拆边界，容易互相覆盖改动。
- 没有最终验证就收尾，最容易把回归带出去。
- 收尾前不做 review summary，交接成本会很高。
快速检查
1. 当前客户端是否已经能看到 Superpowers skills。
2. 计划是否先于实现。
3. 测试和验证是否有证据。
4. 分支是否已清理、总结是否已输出。