Superpowers是什么

Superpowers 是 Jesse Vincent 和 Prime Radiant 团队开发的开源 Agentic 技能框架与软件开发方法论，专为 Claude、Cursor、GitHub Copilot 等 AI Coding Agent 设计。通过 14 个可组合技能（Skills）和初始指令，让 AI 编码助手不再直接跳写代码，是先通过苏格拉底式提问提炼需求、生成可验证的设计文档、制定详细实施计划，再进入子代理驱动的开发流程。核心强调 RED-GREEN-REFACTOR 测试驱动开发、YAGNI 原则和 DRY 原则，支持 Git Worktrees 隔离开发、并行子代理调度、两阶段代码审查等高级工作流，让 Claude 等 Agent 能自主运行数小时而不偏离既定计划。
!Superpowers

Superpowers的主要功能

• 苏格拉底式头脑风暴（brainstorming）：通过追问提炼需求，分块呈现设计方案供用户确认后再进入编码
• 设计文档生成：将粗糙想法转化为结构化、可验证的规格说明并自动保存
• 详细实施计划（writing-plans）：将工作拆解为 2-5 分钟的微任务，包含精确文件路径、完整代码和验证步骤
• 子代理驱动开发（subagent-driven-development）：为每个任务派遣独立子代理，执行两阶段审查（规格合规性 + 代码质量）
• 测试驱动开发（test-driven-development）：强制 RED-GREEN-REFACTOR 循环，先写测试再写代码，删除测试前编写的任何代码
• 系统化调试（systematic-debugging）：四阶段根因分析流程，包含根因追踪、纵深防御、条件等待等技术
• Git Worktrees 工作流（using-git-worktrees）：在独立分支和工作区中开发，验证干净测试基线
• 并行代理调度（dispatching-parallel-agents）：并发执行多个子代理工作流，提升大型项目效率
• 代码审查机制（requesting-code-review / receiving-code-review）：任务间自动审查，按严重程度报告问题，关键问题阻塞进度
• 分支收尾（finishing-a-development-branch）：验证测试、提供合并/PR/保留/丢弃选项、清理工作区
• 技能自扩展（writing-skills）：遵循最佳实践创建和测试新技能，支持团队沉淀内部方法论
• 多平台插件支持：Claude Code 官方市场、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI、OpenCode 全覆盖

如何使用Superpowers

• Claude Code 官方市场：运行 /plugin install superpowers@claude-plugins-official。
• Claude Code Superpowers 市场：先执行 /plugin marketplace add obra/superpowers-marketplace，再执行 /plugin install superpowers@superpowers-marketplace。
• OpenAI Codex CLI：打开插件搜索界面，搜索 “Superpowers” 并选择安装。
• OpenAI Codex App：侧边栏点击 Plugins，在 Coding 分类找到 Superpowers 点击 + 安装。
• Cursor：在 Agent 聊天中通过插件市场搜索 “superpowers” 安装。
• OpenCode：输入 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md。
• GitHub Copilot CLI：依次运行 copilot plugin marketplace add obra/superpowers-marketplace 和 copilot plugin install superpowers@superpowers-marketplace。
• Gemini CLI：运行 gemini extensions install https://github.com/obra/superpowers，更新时用 gemini extensions update superpowers。
• 基础工作流：头脑风暴 → 设计确认 → Git Worktree 创建 → 撰写计划 → 子代理执行/计划执行 → TDD 实现 → 代码审查 → 分支收尾。

Superpowers的关键信息和使用要求

• 开源协议：MIT License，可自由使用、修改和商业应用。
• 维护者：Jesse Vincent 及 Prime Radiant 团队。
• 核心哲学：TDD 优先、系统化流程、复杂度削减、证据验证。
• 技能数量：14 个可组合技能，覆盖测试、调试、协作、计划执行、并行代理、Git 工作流。
• 安装前提：需使用支持插件系统的 Coding Agent（Claude Code、Cursor、Codex 等）。
• 工作流强制性：Agent 在执行任务前必须检查相关技能，非建议而是强制流程。
• 社区支持：Discord 社区、GitHub Issues、邮件订阅发布通知。
• 贡献规范：不接受随意新增技能，修改需跨所有支持平台验证，遵循 writing-skills 指南。
• 更新机制：部分平台自动更新，具体取决于 Coding Agent 的插件系统。

Superpowers的核心优势

• 不直接写代码，先理解需求：Agent 看到开发任务时先退一步，通过提问明确真实目标，避免幻觉和返工。
• 系统化而非随意：基于流程的方法论替代猜测式编程，以复杂度削减为首要目标。
• 证据胜于断言：验证通过后才宣告成功，避免”看起来能跑”的虚假完成。
• 自动触发技能：技能在检测到相关任务时自动激活，无需手动调用或记忆复杂指令。
• 长时间自主运行：Claude 等 Agent 可在既定计划下自主工作数小时不偏离目标。
• 强制测试优先：TDD 作为强制性工作流而非可选建议，从根本上保障代码质量。
• 多 Agent 生态兼容：同一套技能库跨 Claude、Cursor、Copilot、Codex、Gemini 等平台无缝工作。
• 微任务拆解：2-5 分钟粒度的任务描述让”热情的初级工程师”也能准确执行。
• 隔离式开发：Git Worktrees 避免污染主分支，支持并行实验和安全回退。

Superpowers的应用场景

• 从零构建新功能：通过头脑风暴和设计文档确保需求理解正确，避免后期大规模返工。
• 大型重构项目：用 Git Worktrees 隔离实验，子代理并行处理不同模块的改造。
• Bug 修复与根因分析：系统化调试技能指导 Agent 进行四阶段根因追踪，而非盲目试错。
• 代码审查自动化：在提交前让 Agent 执行两阶段审查，主动发现规格偏离和质量问题。
• 多文件复杂改动：将大需求拆解为微任务，分派子代理逐步实施并持续验证。
• 跨平台开发协作：同一套 Superpowers 技能在 Claude、Cursor、Copilot 间保持一致体验。

Superpowers的常见问题

Q：Superpowers 是一个代码库还是方法论？
A：两者兼备。它是一套基于可组合技能的完整软件开发方法论，同时以开源插件形式分发到各大 AI 编码平台。
Q：是否必须学会所有技能才能开始？
A：不需要。技能根据当前任务自动触发，用户只需正常与 Coding Agent 交互，Superpowers 会在后台接管工作流。
Q：支持哪些 AI 编码平台？
A：Claude Code（官方市场）、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI、OpenCode。
Q：能否自定义或添加新技能？
A：可以，但需遵循 writing-skills 技能指南，且必须确保跨所有支持平台兼容。官方一般不直接接受新技能贡献。
Q：为什么强调”先不写代码”？
A：直接生成代码容易产生幻觉和返工。Superpowers 通过设计文档和计划确保 Agent 真正理解需求后再动手，降低后期修正成本。
Q：TDD 是可选的吗？
A：不是。RED-GREEN-REFACTOR 是强制性工作流，Agent 会删除测试前编写的任何代码，确保测试覆盖率。
Q：子代理驱动开发和执行计划有什么区别？
A：子代理驱动开发为每个任务派遣独立 Agent 并执行两阶段审查；执行计划则以批处理模式运行并设置人工检查点。