简体中文 | English

Superpowers 是一套面向 coding agents 的完整软件开发工作流，基于一组可组合的「技能（skills）」以及若干初始指令，确保你的 agent 会正确使用它们。

从你启动 coding agent 的那一刻就开始了。当它发现你在构建某样东西时，它不会立刻动手写代码，而是先退一步，问你真正想达成什么。

一旦从对话中梳理出需求规格，它会分块呈现给你，每块都短到可以真正阅读和消化。

在你认可设计之后，agent 会整理出一份实现计划，清晰到足以让一位热情但缺乏品味、没有判断力、不了解项目背景、还不爱写测试的初级工程师照着做。计划强调真正的红/绿 TDD、YAGNI（You Aren't Gonna Need It）和 DRY。

接下来，一旦你说「开始」，它会启动 子智能体驱动开发（subagent-driven-development） 流程：��多个 agent 逐项完成工程任务、检查并评审产出，然后继续推进。Claude 常常可以按你们一起定下的计划自主工作数小时而不跑偏。

除此之外还有很多细节，但这就是系统的核心。而且因为技能会自动触发，你不需要做任何特别操作——你的 coding agent 只是拥有了 Superpowers。

如果 Superpowers 帮你做了能赚钱的事，并且你愿意的话，我会非常感激你考虑 赞助我的开源工作。

谢谢！

• Jesse

说明： 不同平台的安装方式不同。Claude Code 或 Cursor 有内置插件市场。Codex 和 OpenCode 需要手动配置。

在 Claude Code 中，先注册市场：

/plugin marketplace add obra/superpowers-marketplace

然后从该市场安装插件：

/plugin install superpowers@superpowers-marketplace

在 Cursor Agent 聊天中，从市场安装：

/plugin-add superpowers

告诉 Codex：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

详细文档： docs/README.codex.md

告诉 OpenCode：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

详细文档： docs/README.opencode.md

在你选择的平台中开启新会话，然后请求一些应该触发技能的内容（例如「帮我规划这个功能」或「让我们调试这个问题」）。agent 应该会自动调用相关的 superpowers 技能。

1. brainstorming - 在写代码前激活。通过提问细化粗略想法、探索替代方案，��节呈现设计供验证，并保存设计文档。

2. using-git-worktrees - 在设计获批后激活。在新分支上创建隔离工作区，运行项目设置，验证干净的测试基线。

3. writing-plans - 在设计获批后激活。将工作拆成小块任务（每项 2-5 分钟），每项任务包含确切文件路径、完整代码与验证步骤。

4. subagent-driven-development 或 executing-plans - 在计划就绪后激活。为每项任务派发新的 subagent，进行两阶段评审（先看是否符合规格，再看代码质量）；或分批执行并设置人工检查点。

5. test-driven-development - 在实现过程中激活。强制 RED-GREEN-REFACTOR：先写失败测试、确认失败，再写最少代码、确认通过，然后提交；会删除在测试之前写下的代码。

6. requesting-code-review - 在任务之间激活。对照计划做评审，按严重程度报告问题；严重问题会阻塞进展。

7. finishing-a-development-branch - 在任务全部完成时激活。验证测试、给出选项（合并/PR/保留/丢弃），并清理 worktree。

Agent 会在执行任何任务前检查相关技能。 这些是强制工作流，而非建议。

测试

• test-driven-development - 红-绿-重构循环（包含测试反模式参考）

调试

• systematic-debugging - 四阶段根因分析流程（包含根因追踪、纵深防御、基于条件的等待等技术）
• verification-before-completion - 确保问题确实已修复

协作

• brainstorming - 苏格拉底式设计细化
• writing-plans - 详细的实现计划
• executing-plans - 带检查点的批量执行
• dispatching-parallel-agents - 并发 subagent 工作流
• requesting-code-review - 预审清单
• receiving-code-review - 响应反馈
• using-git-worktrees - 并行开发分支
• finishing-a-development-branch - 合并/PR 决策工作流
• subagent-driven-development - 快速迭代与两阶段评审（规格合规，然后代码质量）

元技能

• writing-skills - 遵循最佳实践创建新技能（包含测试方法）
• using-superpowers - 技能系统简介

• 测试驱动开发 - 始终先写测试
• 系统化而非临时 - 流程优先于猜测
• 降低复杂度 - 以简单为首要目标
• 证据优于断言 - 在宣布成功前先验证

延伸阅读：Superpowers for Claude Code

技能直接存放在本仓库中。贡献步骤：

1. Fork 本仓库
2. 为你的技能创建分支
3. 按 writing-skills 技能的要求创建并测试新技能
4. 提交 PR

完整指南见 skills/writing-skills/SKILL.md。

更新插件后，技能会自动更新：

/plugin update superpowers

MIT License - 详见 LICENSE 文件

• Issues：https://github.com/obra/superpowers/issues
• Marketplace：https://github.com/obra/superpowers-marketplace