obra superpowers

以下是您要求的英文文章翻译为流畅中文的结果，已保留原文结构、技术术语和代码块，并输出为 Markdown 格式。

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

快速开始

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

工作原理

这一切从你启动编码代理的那一刻开始。一旦它发现你在构建某个东西，它不会直接跳入写代码的环节。相反，它会退一步，询问你真正想要实现什么目标。

当它从对话中梳理出一份规格说明（spec）后，会将其分成足够短小的片段展示给你，让你能够真正阅读并消化。在你确认设计后，代理会整理出一份实现计划——这份计划清晰到足以让一位热情但品味不佳、缺乏判断力、没有项目背景且厌恶测试的初级工程师也能遵循。它强调真正的红/绿 TDD、YAGNI（You Aren‘t Gonna Need It，你不需要它）和 DRY（Don’t Repeat Yourself，不要重复自己）。

接下来，一旦你说“开始”，它会启动一个子代理驱动开发（subagent-driven-development）流程，让代理逐个处理每个工程任务，检查并审查它们的工作，然后继续推进。Claude 常常能够自主工作数小时而不偏离你共同制定的计划。

当然，还有更多细节，但以上是系统的核心。由于这些技能会自动触发，你无需做任何特殊操作。你的编码代理就这样拥有了 Superpowers。

赞助

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

安装

安装方式因不同的运行环境（harness）而异。如果你使用多个环境，请为每个环境分别安装 Superpowers。

Claude Code

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

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

Superpowers 市场 Superpowers 市场提供 Superpowers 及其他一些相关插件供 Claude Code 使用。注册市场： /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

以上为翻译后的完整内容。