Superpowers 是一套为编程代理(Coding Agents)设计的完整软件开发工作流。它基于一系列可组合的“技能”和初始指令,确保代理能够高效且智能地完成开发任务。Superpowers 的核心在于将复杂的开发流程分解为可管理的步骤,并通过自动化和智能化的方式提升代理的自主工作能力。

Superpowers 的工作机制

Superpowers 的工作流程始于编程代理启动的那一刻。它并非直接着手编写代码,而是遵循一套系统化的步骤,确保开发过程的严谨性与高效性:

  1. 需求提炼与规格确认: 代理启动后,首先会主动询问用户真正想要实现的目标,而非直接跳入代码编写。通过对话,它会提炼出清晰的需求规格,并将其分块展示给用户,以便阅读和确认。
  2. 制定实现计划: 在用户确认设计方案后,代理会制定一份详尽的实现计划。这份计划旨在让任何具备基本工程知识的开发人员都能理解并遵循,强调真正的红-绿测试驱动开发(TDD)、“你不会用到它”(YAGNI)原则以及“不要重复你自己”(DRY)原则。
  3. 子代理驱动开发: 一旦用户发出“开始”指令,Superpowers 便会启动子代理驱动开发流程。每个工程任务都会被分配给一个独立的子代理来完成,并伴随严格的检查和代码审查环节。这种模式下,代理甚至可以自主工作数小时,无需人工干预,始终遵循既定计划。
  4. 技能自动触发: Superpowers 的技能是自动触发的。这意味着用户无需执行任何特殊操作,编程代理即可自然而然地运用这些“超能力”来完成任务。

核心开发哲学

Superpowers 秉持以下开发哲学,以确保高质量和可持续的软件开发:

  • 测试驱动开发 (TDD): 始终先编写测试。这是 Superpowers 工作流的核心,要求在编写任何功能代码之前,先编写出能够验证其正确性的失败测试。
  • 系统化而非随意 (Systematic over ad-hoc): 强调通过既定流程和方法论来解决问题,而非依赖猜测或临时的解决方案。
  • 降低复杂性 (Complexity Reduction): 将简化作为首要目标。通过结构化、模块化和清晰的计划,最大限度地减少代码和系统设计的复杂性。
  • 以证据为导向 (Evidence over Claims): 在宣布成功之前,必须通过测试和验证来证明其有效性。

安装指南

Superpowers 的安装方式因平台而异。对于某些平台,它可以通过内置插件市场安装;对于其他平台,则需要手动设置。

平台 安装方式 备注
Claude Code 官方市场安装: /plugin install superpowers@claude-plugins-official 通过插件市场安装(需先注册): /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace 推荐使用官方市场安装。若需通过自定义市场安装,请先注册市场。
Cursor 通过 Agent Chat 安装: /add-plugin superpowers 或在插件市场搜索 “superpowers”。 在 Cursor 的 Agent Chat 界面直接输入命令或通过图形界面搜索安装。
Codex 手动安装: 告知 Codex 从指定 URL 获取并遵循指令: `Fetch and follow instructions from Codex 需要通过指令手动获取安装脚本。详细文档位于 docs/README.codex.md。请注意,为符合要求,此处仅保留文字描述,不提供可点击链接。
OpenCode 手动安装: 告知 OpenCode 从指定 URL 获取并遵循指令: `Fetch and follow instructions from OpenCode 与 Codex 类似,也需要通过指令获取安装脚本。详细文档位于 docs/README.opencode.md。请注意,为符合要求,此处仅保留文字描述,不提供可点击链接。
Gemini CLI 安装: gemini extensions install <br/> **更新:** gemini extensions update superpowers` Gemini CLI 提供了命令行工具进行安装和更新。请注意,为符合要求,此处仅保留文字描述,不提供可点击链接。

验证安装

安装完成后,在您选择的平台中启动一个新会话,并提出一个能够触发技能的问题,例如:“帮我规划这个功能”或“我们来调试这个问题”。代理应该会自动调用相关的 Superpowers 技能。

Superpowers 技能一览

Superpowers 内部包含丰富的技能库,它们共同支撑起整个开发工作流。这些技能在开发过程的不同阶段自动激活,确保代理高效、系统地完成任务。

技能类别 技能名称 激活时机与功能描述
工作流管理 brainstorming 代码编写前激活。 通过提问细化粗略想法,探索替代方案,分块呈现设计供验证。最终保存设计文档。
using-git-worktrees 设计批准后激活。 在新分支上创建隔离的工作区,运行项目设置,并验证干净的测试基线。
writing-plans 设计批准后激活。 将工作分解为短小(2-5分钟)的任务。每个任务包含精确的文件路径、完整的代码和验证步骤。
subagent-driven-developmentexecuting-plans 计划制定后激活。 为每个任务派遣新的子代理,进行两阶段审查(规格符合性,然后是代码质量),或分批执行并在人工检查点暂停。
requesting-code-review 任务之间激活。 根据计划进行审查,并按严重程度报告问题。关键问题会阻塞进度。
finishing-a-development-branch 任务完成后激活。 验证测试,提供选项(合并/拉取请求/保留/丢弃),清理工作区。
测试与调试 test-driven-development 实现阶段激活。 强制执行红-绿-重构循环:编写失败测试,观察其失败,编写最少代码使其通过,然后提交。删除在测试编写之前产生的代码。
systematic-debugging 系统的四阶段根本原因分析过程,包括根本原因追踪、深度防御和基于条件的等待技术。
verification-before-completion 确保问题确实得到修复。
协作与元技能 dispatching-parallel-agents 并行子代理工作流管理。
receiving-code-review 响应代码审查反馈。
writing-skills 遵循最佳实践创建新技能的元技能,包括测试方法论。
using-superpowers 介绍技能系统。

贡献与社区支持

Superpowers 是一个开源项目,欢迎社区贡献。技能直接存储在代码仓库中。要贡献新的技能,您可以:

  1. 派生(Fork)仓库。
  2. 为您的技能创建一个新分支。
  3. 遵循 writing-skills 技能的指导来创建和测试新技能。
  4. 提交拉取请求(PR)。

技能更新

当您更新插件时,Superpowers 技能会自动更新。例如,在 Claude Code 中可以使用 /plugin update superpowers 命令。

社区与支持

Superpowers 由 Jesse Vincent 和 Prime Radiant 的团队构建。如需社区支持、提问或分享您的 Superpowers 项目,请加入 Discord 社区。您也可以通过项目的问题跟踪器报告问题。

结语

Superpowers 通过其结构化的工作流和丰富的技能库,极大地提升了编程代理在软件开发中的自主性和效率。它不仅是一个工具集,更是一种先进的开发方法论,旨在让智能代理成为开发者真正的“超能力”。


👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API