Superpowers：让编码代理按TDD与子代理流程开发
给编码代理加上TDD、计划和子代理审查流程，不再直接开写代码。
GitHub obra/superpowers 更新 2026-09-04 分支 main 星标 294.5K 分叉 26.3K
Shell JavaScript Python TypeScript 编码代理 TDD Git worktrees 插件生态

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你使用Claude Code、Codex CLI或Cursor，并希望代理先澄清设计再写代码。
    README“How it works”说明代理会先询问真实目标、提炼spec并展示设计；Installation列出Claude Code、Codex CLI和Cursor。
  • 你的项目要求RED-GREEN-REFACTOR、YAGNI和DRY，并接受代理按任务执行。
    README“How it works”和“Philosophy”明确强调true red/green TDD、YAGNI、DRY；“Basic Workflow”包含test-driven-development与subagent-driven-development。
  • 你需要隔离分支、任务级计划和代码审查流程。
    README“Basic Workflow”列出using-git-worktrees、writing-plans和requesting-code-review，并说明审查包含spec compliance与code quality两个阶段。

不适合，如果你

  • 你的编码代理不在README列出的Claude、Antigravity、Codex、Cursor、Devin、Factory、Gemini、Copilot、Grok、Kimi、OpenCode或Hermes范围内。
    README“Installation”仅列出这些harness，并说明安装因harness而异。
  • 你的团队不接受代理强制执行TDD、计划和代码审查工作流。
    README“Basic Workflow”明确写明“These are mandatory workflows, not suggestions”，并列出test-driven-development与requesting-code-review。
  • 你在Hermes中依赖跨长会话的bootstrap且不准备重启会话。
    README“Hermes Agent”说明Hermes没有post-compaction hook，首次turn被压缩后可能丢失bootstrap，需要启动新会话。

前置条件

  • Installation differs by harness；如果使用多个harness，需要分别安装Superpowers。
  • Codex CLI需要打开插件搜索界面，命令为`/plugins`。
  • Superpowers通过各编码代理的插件或扩展机制安装，例如Antigravity使用agy plugin install，Gemini CLI使用gemini extensions install。
  • Hermes安装后需要重启活动会话；README说明其没有post-compaction hook。
  • 视觉伴侣遥测可通过设置`SUPERPOWERS_DISABLE_TELEMETRY`为任意true值关闭。

第一步命令（README 原文）

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

要注意

  • 同一套Superpowers不能因已装在其他harness而跳过OpenCode单独安装。
    README“OpenCode”明确写明即使其他harness已使用，也要单独安装。
  • Hermes长会话压缩后技能停止触发时，需要启动fresh session。
    README“H​​ermes Agent”说明压缩超过首个turn会丢失bootstrap，技能停止触发时要启动新会话。
  • visual companion默认从网站加载Prime Radiant logo并携带Superpowers版本。
    README“Visual companion telemetry”说明默认资源来自网站，并包含正在使用的Superpowers版本。

材料未说明

  • README没有说明各harness的最低版本要求。
  • README没有给出不同模型或编码代理的兼容性矩阵。
  • README没有提供基准数据，无法量化TDD、subagent-driven-development对开发速度或成本的影响。
  • README没有说明任务失败、代理偏离计划或子代理不可用时的恢复策略。
  • README没有说明企业商业支持的价格、服务等级或数据处理条款。
  • README没有说明插件权限范围、执行隔离方式和供应链安全审计结果。

💡 深度解析

6
适合 我希望把一个较大的功能拆给多个 subagent，并用 Git worktree 隔离分支；Superpowers 能否在每项任务后分别检查规格符合性和代码质量？
适合读者： 希望让多个子代理并行处理任务、同时要求每项变更经过规格符合性和代码质量两阶段审查的 Git 用户

适合，因为子代理驱动开发、Git worktree 隔离和两阶段审查正是 README 明确提供的组合流程。

  • subagent-driven-development 会为每个工程任务调度相对独立的代理，并在继续前检查其工作。
  • README 的 “The Basic Workflow”明确要求两阶段 review：先做 spec compliance，再做 code quality；关键问题会阻断进度。
  • using-git-worktrees 会在批准设计后创建隔离工作区和新分支，适合并行任务减少工作目录互相污染。
  • dispatching-parallel-agents 也列在 Collaboration 技能库中，但 README 没有说明并行任务的最大数量、冲突解决策略或不同任务之间如何共享接口变更。
  • The Basic Workflow："subagent-driven-development ... two-stage review (spec compliance, then code quality)"
  • The Basic Workflow："Critical issues block progress."
  • The Basic Workflow：using-git-worktrees 创建“isolated workspace on new branch”
  • What's Inside / Collaboration：dispatching-parallel-agents、subagent-driven-development
agy plugin install https://github.com/obra/superpowers
材料未说明：README 未说明并发 subagent 数量限制、模型调用成本和 Git 冲突的自动处理方式。；README 未说明复杂构建系统在多个 worktree 中初始化依赖时的兼容边界。
适合 我同时使用 Claude Code 和 Codex CLI，希望两个宿主都在实现前澄清需求、生成计划，并通过 TDD 和 Git worktree 完成任务；Superpowers 是否适合？
适合读者： 同时使用 Claude Code 和 Codex CLI、希望统一需求澄清、TDD 与 Git 分支流程的编码代理用户

适合，因为它把需求、设计、计划、实现、审查和分支收尾串成同一套可组合技能流程，并且明确支持 Claude Code 与 Codex CLI。

  • README 的“Installation”说明不同 harness 需要分别安装，因此两个宿主都能接入，但不会共享一次安装状态。
  • “How it works”规定代理先提炼 spec、展示设计并等待确认，再生成实施计划，而不是立即写代码。
  • “The Basic Workflow”包含 using-git-worktrees、writing-plans、test-driven-development 和 requesting-code-review，覆盖你列出的约束。
  • 该项目是插件与技能框架，不是模型本身；不同宿主的插件钩子、上下文窗口和子代理能力是否完全一致，README 没有给出保证。
  • Installation："If you use more than one, install Superpowers separately for each one."
  • How it works："After you've signed off on the design, your agent puts together an implementation plan"
  • The Basic Workflow：using-git-worktrees、writing-plans、test-driven-development、requesting-code-review
  • 项目数据：支持 Shell、JavaScript、Python、TypeScript 和 HTML；最新版本 v6.3.0
/plugin install superpowers@claude-plugins-official
材料未说明：README 未说明 Claude Code 与 Codex CLI 在子代理、会话启动钩子和上下文持久化上的行为是否完全一致。；README 未提供跨宿主的成功率、额外模型调用次数或执行成本数据。
视情况 我维护一个测试覆盖率较低的遗留项目，想用 Claude Code 逐步增加测试并修改现有代码；Superpowers 是否会因为“先写测试、删除测试前代码”的要求而不适合？
适合读者： 维护测试覆盖率较低的遗留项目、仍想让编码代理使用 RED-GREEN-REFACTOR 的开发者

视情况；如果遗留项目已有可运行的测试基线并能逐步补测试，它可以提供纪律，但对难以测试的 UI、基础设施或现有无测试代码会产生明显摩擦。

  • README 的 “The Basic Workflow”要求 RED-GREEN-REFACTOR：先写失败测试、确认失败、写最小实现、确认通过，再提交。
  • 同一章节明确写着“Deletes code written before tests”，因此代理可能拒绝沿用未经过测试驱动编写的新增代码。
  • using-git-worktrees 流程会运行项目设置并验证 clean test baseline；这要求遗留项目至少能建立可重复的测试起点。
  • 项目洞察明确指出，低测试覆盖率、难测试 UI 和基础设施代码可能与机械式 TDD 产生摩擦；README 没有给出遗留系统的例外规则。
  • The Basic Workflow："Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit."
  • The Basic Workflow："Deletes code written before tests."
  • The Basic Workflow：using-git-worktrees 会“runs project setup, verifies clean test baseline”
  • 项目洞察 common_pitfalls：TDD 可能与遗留项目、低测试覆盖率项目或难以测试的 UI 和基础设施代码产生摩擦
材料未说明：README 未说明如何处理无法建立 clean test baseline 的仓库。；README 未说明哪些测试框架、语言或 UI 测试类型可以豁免严格的 RED-GREEN-REFACTOR。
视情况 我准备在企业环境通过 Claude Code 部署 Superpowers，组织要求关闭可选遥测并限制插件的远程访问；README 提供了足够的控制手段吗？
适合读者： 在企业环境使用 Superpowers、需要控制远程资源加载和代理访问范围的安全或平台工程师

视情况；README 提供了关闭 Superpowers 视觉伴侣遥测的明确开关，但不足以单独证明满足企业级供应链、凭据和网络隔离要求。

  • “Visual companion telemetry”说明默认会从网站加载带版本信息的 Prime Radiant logo，不包含项目、提示词或编码代理细节。
  • 同一章节提供 SUPERPOWERS_DISABLE_TELEMETRY，并说明还遵循 Claude Code 的 DISABLE_TELEMETRY 与 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出配置。
  • 安装通过 Claude 官方 marketplace 完成，降低了来源不明安装的风险，但 README 未定义企业审批、版本锁定或插件权限策略。
  • 项目洞察提醒敏感环境还需审查插件来源、安装权限、代理可访问凭据和文件范围，因此不能只依赖环境变量完成合规判断。
  • Visual companion telemetry："It does not include any details about your project, prompt, or coding agent."
  • Visual companion telemetry：`SUPERPOWERS_DISABLE_TELEMETRY`
  • Visual companion telemetry：遵循 `DISABLE_TELEMETRY` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`
  • Installation / Claude Code："official Claude plugin marketplace"
/plugin install superpowers@claude-plugins-official
材料未说明：README 未说明插件是否支持版本锁定、离线安装、企业内部镜像或网络白名单。；README 未说明代理在不同宿主中默认可读取哪些凭据、文件和环境变量。
视情况 我主要用 Cursor Agent 做小范围修改，通常希望马上改一个文件或调整配置；Superpowers 会不会让这种工作流变得过重？
适合读者： 使用 Cursor Agent、习惯直接修改小范围代码、无法接受每次任务都经过完整设计审批的开发者

视情况；对中大型开发任务合适，但对你描述的即时小修改可能显得过重，因为项目把正式的澄清、设计确认、计划和验证设为默认路径。

  • README 的 “The Basic Workflow”要求 brainstorming 在写代码前激活，并在设计批准后创建 worktree、生成计划。
  • writing-plans 会把工作拆成每项 2–5 分钟的小任务，且每项包含准确文件路径、完整代码和验证步骤。
  • “Philosophy”明确写着“Test-Driven Development - Write tests first, always”，这与一次性配置调整或极短修复不一定匹配。
  • 项目洞察指出它更适合有仓库、测试和 Git 分支的开发任务；但 README 没有说明 Cursor 是否允许按任务类型跳过强制流程。
  • The Basic Workflow："brainstorming - Activates before writing code"
  • The Basic Workflow："writing-plans - Activates with approved design"；任务为“2-5 minutes each”
  • Philosophy："Test-Driven Development - Write tests first, always"
  • 项目洞察 usage_limitations：更适合有代码仓库、可运行测试和可使用 Git 分支的开发任务
/add-plugin superpowers
材料未说明：README 未说明 Cursor Agent 是否支持按任务规模关闭或缩短 brainstorming、TDD 和 worktree 流程。；README 未量化完整流程对单文件修改增加的交互轮次和延迟。
适合 我使用 Gemini CLI，除了采用项目现有的 TDD 和系统化调试流程，还想编写团队自己的 skill；Superpowers 是否支持这种扩展？
适合读者： 使用 Gemini CLI、希望把团队自己的测试和调试规范封装成可复用技能的高级 AI 编程用户

适合，因为项目既提供测试、调试、协作等现成技能，也把创建新技能作为正式的元技能流程，并在省略章节中列出 Gemini CLI 的宿主支持。

  • “What’s Inside / Skills Library”包含 test-driven-development、systematic-debugging、verification-before-completion 等可复用技能。
  • Meta 技能中的 writing-skills 用于“Create new skills following best practices”，并包含测试方法，适合把组织规范结构化。
  • “How it works”说明技能会自动触发，代理在识别开发任务时检查相关技能，不要求用户每次手动提示。
  • 但项目不是独立运行时或测试平台；自定义 skill 是否能被 Gemini CLI 的钩子、上下文和插件机制一致加载，README 没有详细说明。
  • What's Inside / Skills Library：test-driven-development、systematic-debugging、verification-before-completion
  • What's Inside / Meta："writing-skills - Create new skills following best practices"
  • How it works："because the skills trigger automatically, you don't need to do anything special"
  • README 省略章节：包含 Gemini CLI
材料未说明：README 未提供 Gemini CLI 的具体安装命令。；README 未说明自定义 skill 的目录结构、发布方式、版本兼容规则和 Gemini CLI 的加载限制。

✨ 核心亮点

  • 用brainstorming先澄清需求，再生成设计与实施计划
  • test-driven-development强制执行RED-GREEN-REFACTOR
  • subagent-driven-development按任务派生代理并双阶段审查
  • 支持Claude、Codex、Cursor、Gemini等多个编码代理

🔧 工程化

  • 自动触发brainstorming、writing-plans和TDD工作流
  • 用using-git-worktrees创建隔离分支并验证测试基线
  • 每个工程任务可由新subagent执行并接受两阶段审查

⚠️ 风险

  • 安装按harness区分，多个环境必须分别安装Superpowers
  • Hermes缺少post-compaction hook，长会话可能丢失bootstrap
  • 可选visual companion默认加载Prime Radiant遥测资源

👥 适合谁？

  • 使用Claude Code、Codex或Cursor的编码代理开发团队
  • 希望落实TDD、YAGNI和DRY的工程项目
  • 需要Git worktrees与子代理并行处理工程任务的团队