obra superpowers

obra superpowers

Superpowers 是一套完整的软件开发方法论，专为你的编码代理（coding agents）构建，基于一组可组合的技能（composable skills）和一些初始指令，确保你的代理能够使用它们。

快速开始

为你的编码代理赋予 Superpowers：Claude Code、Codex CLI、Codex App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI。

工作原理

这一切从你启动编码代理的那一刻开始。一旦它发现你在构建某些东西，它不会直接跳入编写代码。相反，它会退一步，询问你真正想要做什么。当它从对话中提炼出规格说明后，会以足够短、便于实际阅读和消化的块状形式展示给你。在你确认设计后，你的代理会制定一个实现计划，这个计划清晰到即使是一个品味不佳、缺乏判断力、没有项目背景、且厌恶测试的热情初级工程师也能遵循。它强调真正的红/绿 TDD、YAGNI（你不需要它）和 DRY 原则。

接下来，一旦你说“开始”，它会启动一个子代理驱动开发（subagent-driven-development）流程，让代理逐个处理每个工程任务，检查并审查它们的工作，然后继续推进。Claude 能够自主工作数小时而不偏离你制定的计划，这并不罕见。还有更多内容，但这就是系统的核心。由于这些技能会自动触发，你无需做任何特殊操作。你的编码代理只是拥有了 Superpowers。

赞助

如果 Superpowers 帮助你赚到了钱，并且你愿意的话，我将非常感谢你考虑赞助我的开源工作。谢谢！ —— Jesse

安装

安装方式因工具（harness）而异。如果你使用多个工具，请为每个工具单独安装 Superpowers。

Claude Code

Superpowers 可通过官方 Claude 插件市场获取。

官方市场 从 Anthropic 的官方市场安装插件： /plugin install superpowers@claude-plugins-official

Superpowers 市场 Superpowers 市场为 Claude Code 提供 Superpowers 及其他相关插件。 注册市场： /plugin marketplace add obra/superpowers-marketplace 从该市场安装插件： /plugin install superpowers@superpowers-marketplace

Codex CLI

Superpowers 可通过官方 Codex 插件市场获取。 打开插件搜索界面： /plugins 搜索 Superpowers： superpowers 选择 Install Plugin。

Codex App

Superpowers 可通过官方 Codex 插件市场获取。 在 Codex 应用中，点击侧边栏的 Plugins。 你应该会在 Coding 部分看到 Superpowers。 点击 Superpowers 旁边的 + 并按照提示操作。

Factory Droid

注册市场： droid plugin marketplace add https://github.com/obra/superpowers 安装插件： droid plugin install superpowers@superpowers

Gemini CLI

安装扩展： gemini extensions install https://github.com/obra/superpowers 后续更新： gemini extensions update superpowers

OpenCode

OpenCode 使用自己的插件安装方式；即使你已在其他工具中使用 Superpowers，也需要单独安装。 告诉 OpenCode： Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md 详细文档：docs/README.opencode.md

Cursor

在 Cursor Agent 聊天中，从市场安装： /add-plugin superpowers 或者在插件市场中搜索“superpowers”。

GitHub Copilot CLI

注册市场： copilot plugin marketplace add obra/superpowers-marketplace 安装插件： copilot plugin install superpowers@superpowers-marketplace

基本工作流

• brainstorming - 在编写代码前激活。通过提问完善粗略想法，探索替代方案，分部分展示设计以供验证。保存设计文档。
• using-git-worktrees - 在设计批准后激活。在新分支上创建隔离工作区，运行项目设置，验证干净的测试基线。
• writing-plans - 在设计批准后激活。将工作分解为小任务（每个 2-5 分钟）。每个任务包含精确的文件路径、完整代码和验证步骤。
• subagent-driven-development 或 executing-plans - 在有计划时激活。为每个任务分派全新的子代理，进行两阶段审查（先检查规格符合性，再检查代码质量），或批量执行并设置人工检查点。
• test-driven-development - 在实现过程中激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，观察其失败，编写最简代码，观察其通过，然后提交。删除测试之前编写的代码。
• requesting-code-review - 在任务之间激活。对照计划进行审查，按严重程度报告问题。关键问题会阻止进度。
• finishing-a-development-branch - 在任务完成时激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作区。

代理在任何任务之前都会检查相关技能。这些是强制性工作流，而非建议。

内部构成

技能库

测试

• test-driven-development - RED-GREEN-REFACTOR 循环（包含测试反模式参考）

调试

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

协作

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

元技能

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

Phi