Claude Code 开箱即用就很强大,但缺乏结构时,它会直接跳入编码:没有规划、没有测试、没有系统化方法。Superpowers 插件通过强制执行经过验证的开发工作流来解决这个问题,防止混乱发生。
Superpowers 实际做什么
Superpowers 是一个技能框架,在关键时刻拦截 Claude Code。当你请求某些功能时,它不会立即编写代码,而是先停下来提问。然后它强制执行 TDD,创建实施计划,并在继续之前审查自己的工作。
核心工作流:
- 头脑风暴:通过苏格拉底式提问完善你的想法
- 规划:创建小任务(每个 2-5 分钟),包含确切的文件路径
- 执行:为每个任务派发子代理,进行两阶段审查
- 完成:验证测试,提供 PR/合并选项,清理工作
安装(10 秒)
bash
打开插件菜单
/plugin
导航到 "Discover" 标签
搜索 "superpowers"
选择并安装
安装后,重启 Claude Code。你会看到 "SessionStart:startup hook succeeded: Success" 确认插件已激活。
安装了什么
插件捆绑了你需要的一切:
| 组件 | 包含内容 |
|---|---|
| 命令 | execute-plan, write-plan, brainstorm |
| 代理 | code-reviewer |
| 技能 | 14 个技能,包括 TDD、调试、git worktrees、代码审查 |
| 钩子 | SessionStart(自动引导工作流) |
三个核心命令
/superpowers:brainstorm
在任何新功能之前使用。Claude 会:
- 就你的目标提出澄清性问题
- 探索你未考虑的替代方案
- 以易于理解的块呈现设计供验证
- 保存设计文档以供参考
何时触发: 任何功能、重构或迁移的开始。
/superpowers:write-plan
头脑风暴后,创建实施计划:
- 每个任务最多 2-5 分钟
- 每个任务都有确切的文件路径和完整的代码片段
- 验证步骤内置于每个任务中
- 计划假设一个"没有上下文的热情初级工程师"将执行它
/superpowers:execute-plan
使用子代理驱动开发运行计划:
- 每个任务生成新的子代理(干净的上下文)
- 两阶段审查:规范合规性,然后代码质量
- 批次之间的人工检查点
- 关键问题自动阻止进度
14 个技能详解
| 技能 | 功能 |
|---|---|
| test-driven-development | 强制执行 RED-GREEN-REFACTOR。删除测试前编写的代码。 |
| systematic-debugging | 4 阶段根本原因流程,深度防御 |
| using-git-worktrees | 创建隔离分支,运行设置,验证干净基线 |
| using-superpowers | 技能系统介绍 |
| dispatching-parallel-agents | 并发子代理工作流 |
| executing-plans | 带检查点的批量执行 |
| finishing-a-development-branch | 合并/PR/保留/丢弃选项,清理 |
| brainstorming | 苏格拉底式设计完善 |
| writing-plans | 详细实施规划 |
| requesting-code-review | 审查前检查清单,关键问题阻止 |
| receiving-code-review | 系统化响应反馈 |
| writing-skills | 创建新技能的元技能 |
| verification-before-completion | 确保修复实际有效 |
| subagent-driven-development | 每个任务两阶段审查 |
技能如何自动触发
技能不是你调用的命令,它们基于上下文激活:
- 开始讨论新功能 → brainstorming 激活
- 设计获批 → using-git-worktrees 激活
- 实施开始 → test-driven-development 激活
- 任务完成 → requesting-code-review 激活
- 所有任务完成 → finishing-a-development-branch 激活
Claude 在任何任务前检查相关技能。这些是强制性工作流,不是建议。
Git worktree 集成
Superpowers 使用 git worktrees 进行隔离开发: bash
幕后发生的事情:
git worktree add ../project-feature feature-branch cd ../project-feature
Claude 在这里工作,主分支保持干净
优势:
- 在不同功能上运行多个 Claude 实例
- 在实验期间保持主分支稳定
- 出错时易于清理
子代理驱动开发
最强大的模式。不是一个长 Claude 会话:
- 主代理创建计划
- 新的子代理执行每个任务
- 审查代理(code-reviewer)检查工作
- 主代理继续或请求修复
为什么有效:每个子代理以专注于一个任务的干净上下文开始。没有长会话累积的混乱。
TDD 强制执行
Superpowers 认真对待 TDD。该技能:
- 要求在实施前有失败的测试
- 观察测试失败(证明它测试了某些东西)
- 实施最少代码以通过
- 在绿色时提交
- 仅在绿色后重构
如果 Claude 在测试前编写代码,该技能会指示它删除该代码并重新开始。
实际示例
你: 我的 Express 应用需要用户认证
Claude(带 Superpowers): → 激活头脑风暴技能 → 询问: OAuth 还是密码? Session 还是 JWT? 哪些提供商? → 探索: 速率限制? 账户锁定? 密码要求? → 分段呈现设计供你批准
你: 看起来不错,让我们规划一下
Claude: → 激活 writing-plans 技能 → 创建 12 个任务,每个 2-5 分钟 → 任务 1: 为 /signup 端点创建失败测试 → 任务 2: 实施 signup 处理程序以通过测试 → 每个任务都有确切的文件路径和代码
你: 执行
Claude: → 为任务 1 生成子代理 → code-reviewer 代理验证输出 → 为任务 2 生成子代理 → 报告进度,请求批准继续
管理插件
从 /plugin 菜单你可以:
- 禁用插件: 临时关闭
- 标记更新: 标记下次更新周期
- 立即更新: 立即获取最新版本
- 卸载: 完全删除
- 在 GitHub 上查看: 查看源代码
何时不使用 Superpowers
- 快速一次性问题
- 简单文件编辑
- 5 分钟以下的任务
对于这些,开销不值得。Superpowers 在需要系统化执行的多文件功能、重构和迁移上表现出色。
快速参考
| 操作 | 方法 |
|---|---|
| 安装 | /plugin → Discover → superpowers |
| 开始设计 | /superpowers:brainstorm |
| 创建计划 | /superpowers:write-plan |
| 执行计划 | /superpowers:execute-plan |
| 更新 | /plugin → 选择 superpowers → 立即更新 |
Superpowers 将 Claude Code 从"有时会偏离轨道的有用助手"转变为"遵循经过验证流程的系统化开发伙伴"。结构化工作流防止了最常见的失败模式:跳过测试、遗漏边缘情况以及偏离需求的功能。
