古法编程

Superpowers 是一套面向 AI 编码代理的软件开发方法论与可组合技能库。它通过可触发的 SKILL.md 文件，在 AI 动手写代码前强制执行头脑风暴、编写计划、测试驱动开发与代码审查等工程流程，将专业开发纪律固化到 Claude Code、OpenAI Codex、Cursor、OpenCode、GitHub Copilot CLI、Gemini CLI 等主流 AI 编程工具中。

SuperPowers 是什么：AI 编码代理的软件开发技能库与工作流总览

使用 AI 编码代理时，开发者常遇到一个痛点：AI 倾向于直接生成代码，缺乏清晰的需求确认和工程纪律。Superpowers 正是为此设计的解决方案。它不是一个独立的代码编辑器或编程语言，而是一套完整的方法论与技能系统，旨在通过强制工作流改变 AI 代理的默认行为模式。

项目定位与核心价值

根据项目 README 的定义，Superpowers 是“一个完整的软件开发方法论，建立在一组可组合的技能之上，并通过一些初始指令确保你的代理使用它们”。这意味着它不是一个可选的功能增强插件，而是一套为 AI 代理注入的“工程肌肉记忆”。

它解决的核心问题是行为规范化。安装后，AI 代理获得了“软件开发最佳实践”的内置知识，能够在用户未明确指示时，自动遵循最合理的工程流程。开发者无需再扮演“流程监督者”，AI 自身就能在合适时机主动确认需求、编写测试或发起审查。

它为谁设计？

Superpowers 主要服务于以下几类开发者：

  • 使用 Claude Code、Codex、OpenCode、Cursor、Gemini CLI、GitHub Copilot CLI 进行软件开发的个人或团队。
  • 希望将 TDD、系统化调试、代码审查、子代理执行等专业流程固化到 AI 工作流中的工程团队。
  • 需要理解其多平台插件机制、测试体系或可视化服务的贡献者和维护者。

七步工作流闭环：从想法到安全合并

Superpowers 的核心是一个强制性的七步闭环工作流。它会在 AI 代理开始工作前自动触发，确保从“澄清需求”到“代码合并”的每个环节都处于受控状态：

  1. brainstorming（头脑风暴）：在写代码前激活，通过苏格拉底式提问挖掘真实需求、探索替代方案，并将设计文档分段呈现给用户确认。这一步是硬性门禁，设计未获批准前不能进入下一阶段。
  2. using-git-worktrees：在设计批准后激活，创建隔离的 Git 工作树进行开发，确保不会直接修改主分支，实现并行开发的安全隔离。
  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、保留或丢弃分支等选项，安全收尾。

这个工作流的设计哲学强调“系统化优于临时发挥”、“证据优于声明”、“简洁优于过度设计”。

可组合的技能库构成

Superpowers 的核心是一个可组合的 skill 集合，每个 skill 是一段描述特定工程行为的规范文件（SKILL.md）。当 AI 检测到对应场景时，会自动加载并遵循。技能库主要分为三类：

  • 测试与调试类：包含 test-driven-development（强制 RED-GREEN-REFACTOR）、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（分支管理）。
  • 元技能类：包含 writing-skills（用于创建新技能的规范）和 using-superpowers（介绍整个技能系统）。

所有技能都是强制触发的，而非可选建议。using-superpowers 技能本身会强制 AI 在任何任务开始前检查相关技能，这是工作流得以生效的基石。想深入了解某个技能如何工作，可以参考专题文章，例如 SuperPowers brainstorming 技能详解 和 SuperPowers TDD 技能。

广泛的跨平台支持

Superpowers 的设计目标是支持主流的 AI 编码代理。从仓库的元数据文件可以清晰地看到其跨平台架构：

  • package.json 显示其当前版本为 5.1.0，主入口 .opencode/plugins/superpowers.js 专门适配 OpenCode 平台。
  • .claude-plugin/plugin.json 为 Claude Code 提供插件元数据。
  • .codex-plugin/plugin.json 为 OpenAI Codex CLI 和 App 提供插件定义，其中详细描述了技能路径和界面信息。
  • .cursor-plugin/plugin.json 适配 Cursor 平台的插件清单。
  • gemini-extension.json 用于 Gemini CLI 的扩展配置。

这些元数据文件版本号（均为 5.1.0）保持一致，确保了跨平台体验的同步。安装方式因平台而异，例如 Claude Code 可通过官方市场安装：/plugin install superpowers@claude-plugins-official。各平台的详细安装步骤可参考 SuperPowers 安装指南。

近期技术演进（v5.1.0）

从 RELEASE-NOTES.md 的 v5.1.0 条目可以看到项目的持续进化。本次更新重点包括：

  • 移除遗留组件：彻底移除了已弃用的 slash commands（/brainstorm, /execute-plan, /write-plan），并移除了名为 code-reviewer 的专用代理，统一为通用的 Task 分发加提示模板的模式。
  • 工作树技能重写：using-git-worktrees 和 finishing-a-development-branch 技能现在会检测代理是否已运行在隔离的工作树中，并优先使用平台原生的工作树控制，增强了跨平台兼容性和健壮性。
  • 贡献者指南增强：在 CLAUDE.md 中为 AI 代理新增了提交前检查清单，明确了仓库不接受的 PR 类型，以规范 AI 生成的贡献内容。
  • Codex 插件同步工具：新增脚本用于将 Superpowers 同步到 OpenAI Codex 插件市场。

这些迭代使得 Superpowers 在可靠性、跨平台兼容性和协作规范性上不断提升。关于版本变化的详细解读，可以查看 SuperPowers 版本与发布重点。

FAQ

Q: Superpowers 和直接告诉 AI “先写测试再写代码”有什么区别？ A: 区别在于“强制性”和“系统性”。口头要求可能被 AI 遗忘或选择性执行。Superpowers 将 TDD 等规则写入了 AI 的强制执行流程中，确保无论任务大小、无论用户是否提醒，该流程都会作为前置条件被触发。它是一套完整的、自动化的工程纪律系统。

Q: 我是否需要购买或修改我的 AI 编程工具才能使用 Superpowers？ A: 不需要。Superpowers 是一个插件/技能库，通过平台各自的插件机制（如 Claude Code 的 plugin、OpenCode 的 config hook）加载。它利用现有 AI 工具的能力，通过注入上下文和指令来改变其行为模式，无需对工具本身进行任何修改或购买。

Q: 如何更新 Superpowers 以及如何维护技能库？ A: 更新方式依赖平台，例如 Claude Code 可通过 /plugin update superpowers 进行。技能库本身是开源的，遵循 MIT 许可。它的维护和扩展也有一套规范：内置了 writing-skills 元技能，指导开发者按照标准格式创建和测试新的 skill，确保其能跨所有支持的编码代理工作。详细贡献规则可见 如何给 SuperPowers 提交高质量 PR。

本系列文章

解释 SuperPowers 的定位、核心工作流、支持平台、版本信息和仓库结构，作为站点首页与搜索入口。

拆解 SuperPowers 的主工作流技能：技能发现、头脑风暴、写计划、执行计划、子代理开发、工作树隔离与分支收尾。

解释 SuperPowers 如何通过 TDD、系统化调试、完成前验证、请求/接收代码审查来降低 AI 代码风险。

介绍 browser-based visual companion 的用户流程、服务器实现、WebSocket 协议、HTML frame 模板、启动/停止脚本和测试。

覆盖 Claude Code、Codex、OpenCode、Cursor、Gemini、Copilot CLI 的插件清单、安装方式、启动注入、技能目录注册和工具名映射。

介绍 SuperPowers 如何把技能文档当作代码来测试，包括 RED-GREEN-REFACTOR、压力场景、触发测试、Claude Code/OpenCode 集成测试和 token 分析。

记录旧 slash commands 的弃用状态，避免用户继续搜索或依赖旧命令。