超级能力

项目概述

Superpowers 是一套面向编码代理的完整软件开发方法论。它由一组可组合的技能（skills）与初始指令构成，能够让编码代理在启动后自动加载并按既定流程工作，无需用户额外触发。

工作原理

当编码代理启动并检测到用户要构建某项功能时，它不会立即开始写代码，而是先通过对话厘清真实需求，把模糊的想法梳理为可执行的设计文档。设计以可读的小块形式逐段展示，确认无误后，再由代理生成实施计划——该计划细化到能被初级工程师逐项执行的程度，强调严格的 TDD（红绿循环）、YAGNI 与 DRY 原则。

确认计划后，代理进入由子代理驱动的开发流程，逐项完成任务、检查并审查产出。整套流程可自主运行数小时而不偏离既定方向。所有相关技能会在每项任务前自动检查并启用，属于强制流程而非可选建议。

基础工作流

1. brainstorming：写代码前激活，通过提问打磨创意，输出设计文档。
2. using-git-worktrees：设计获批后激活，建立独立工作分支并确认测试基线干净。
3. writing-plans：将工作拆分为 2-5 分钟可完成的子任务，每项含文件路径、完整代码与验证步骤。
4. subagent-driven-development 或 executing-plans：派遣子代理执行每项任务并做两阶段审查，或按批次执行并设置人工检查点。
5. test-driven-development：强制 RED-GREEN-REFACTOR 流程，删除先于测试写出的代码。
6. requesting-code-review：在任务间触发，对照计划逐项审查，严重问题阻塞推进。
7. finishing-a-development-branch：所有任务完成后激活，验证测试后给出合并/PR/保留/丢弃等选项。

安装方式

不同编码代理的安装命令各不相同，主要示例如下：

# Claude Code 官方市场
/plugin install superpowers@claude-plugins-official

# Antigravity
agy plugin install https://github.com/obra/superpowers

# Cursor
/add-plugin superpowers

# Devin CLI
devin plugins install obra/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

# OpenCode：发送以下指令给代理执行
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

# Pi
pi install git:github.com/obra/superpowers

如果同时使用多个代理平台，需在每个平台单独安装。安装完成后，代理会在会话开始时自动加载技能。

技能库分类

• 测试：test-driven-development（红绿重构循环，含反模式参考）
• 调试：systematic-debugging（四阶段根因分析）、verification-before-completion（修复后验证）
• 协作：brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development
• 元技能：writing-skills（创建新技能的最佳实践）、using-superpowers（技能系统入门）

设计哲学

• 测试驱动开发：始终先写测试
• 系统化优于临时应对：流程胜过猜测
• 降低复杂度：把简洁作为首要目标
• 证据胜过声明：宣称完成前必须验证

贡献指南

一般流程：fork 仓库后切到 dev 分支，新建工作分支，遵循 writing-skills 技能开发与测试新技能，再提交 PR。技能行为测试使用 superpowers-evals 提供的 drill 评测框架；插件基础设施测试位于 tests/ 目录。完整指南见 skills/writing-skills/SKILL.md。

视觉伴侣遥测

brainstorming 技能提供的可选视觉伴侣功能默认从 Prime Radiant 官网加载 logo，请求中仅包含 Superpowers 版本号，不涉及项目内容、提示词或代理信息，也不会收集点击行为。若不需要该功能，可设置环境变量：

SUPERPOWERS_DISABLE_TELEMETRY=1

同时支持 Claude Code 的 DISABLE_TELEMETRY 与 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。

许可证

MIT 许可证，详见仓库 LICENSE 文件。