Superpowers 零基础应用指南：让 Vibe Coding 拥有系统化软件开发能力

Claude code的最热Skill：Superpowers 系统化使用

前言

如果你已经在使用 Claude Code，那你一定体验过 AI 辅助编程带来的效率提升。但你是否遇到过这些问题：

  • Claude 有时会直接开始写代码，而没有先理解你的真实需求？
  • 写出的代码缺少测试，或者测试是在代码之后才补上的？
  • 不同会话中，Claude 的工作方式不一致，难以预测？

Superpowers 正是为了解决这些问题而生的。它为 Claude Code 提供了一套完整的软件开发工作流，让 AI 代理以可预测、可重复的方式工作。

带你从零配置 Superpowers，并通过一个完整的 Web API 项目实战，掌握其核心工作流。

什么是 Superpowers

Superpowers 是由 obra 开发的一套软件开发技能集（skills），构建在 Claude Code 的插件系统之上。它的核心理念包括：

  • 测试驱动开发（TDD）：先写测试，再写代码
  • 系统化方法：遵循流程而非猜测
  • 简化复杂性：以简洁为主要目标
  • 证据优先：验证后再声明成功

当你安装了 Superpowers，Claude 会在执行任务前自动检查相关技能，确保遵循正确的工作流程。

安装配置

第一步：注册 marketplace

打开 Claude Code，执行以下命令注册 Superpowers marketplace：

1
/plugin marketplace add obra/superpowers-marketplace

第二步：安装插件

1
/plugin install superpowers@superpowers-marketplace

安装过程输出：

1
2
3
Fetching plugin information...
Installing superpowers from obra/superpowers-marketplace...
✓ Plugin 'superpowers' installed successfully

第三步：验证安装

1
2
3
/superpowers:brainstorm  - Interactive design refinement
/superpowers:write-plan  - Create implementation plan
/superpowers:execute-plan - Execute plan in batches

核心工作流详解

Superpowers 将软件开发过程分解为清晰的阶段，每个阶段都有对应的技能支撑。让我们了解完整的工作流。

1. Brainstorming - 需求澄清与设计

当你提出”构建一个功能”时，Superpowers 不会立即开始编码。相反，它会：

  • 提出问题来理解你的真实需求
  • 探索 2-3 种实现方案及其权衡
  • 分段展示设计方案供你确认
  • 将确认后的设计保存为文档

这避免了”写出错误的东西”这种浪费。

2. Using Git Worktrees - 隔离开发环境

设计确认后，Superpowers 会创建一个隔离的 git worktree：

  • 在新分支上工作，不影响主分支
  • 运行项目设置，确保环境就绪
  • 验证测试基线通过

这保证了开发环境的干净和可回滚。

3. Writing Plans - 创建可执行计划

有了设计，下一步是制定详细的实现计划。计划的特点：

  • 每个任务 2-5 分钟可完成
  • 明确指定文件路径和操作
  • 包含完整的代码变更
  • 附带验证步骤

这种粒度让执行变得机械且可验证。

4. Subagent-Driven Development - 并行任务执行

有了计划，Superpowers 会启动子代理驱动开发：

  • 为每个任务启动新的子代理
  • 两阶段审查：规格合规性 → 代码质量
  • 自动验证每个任务完成
  • 支持长时间自主运行

5. Test-Driven Development - 测试驱动

在实现过程中，强制执行 TDD 循环：

  • RED：先写失败的测试
  • GREEN：写最少代码使测试通过
  • REFACTOR：重构优化
  • 任何在测试之前写的代码会被删除

6. Requesting Code Review - 代码审查

任务之间自动进行代码审查：

  • 对照计划检查实现
  • 按严重级别报告问题
  • 关键问题会阻止继续进行

7. Finishing Development Branch - 完成合并

所有任务完成后：

  • 验证所有测试通过
  • 展示选项：合并/PR/保留/丢弃
  • 清理 worktree

高级技巧

自定义技能触发

Superpowers 的技能会自动触发，但你也可以手动调用：

1
2
3
4
5
6
7
8
# 手动启动 brainstorming
/superpowers:brainstorm

# 手动请求代码审查
/skill superpowers:requesting-code-review

# 使用 TDD 检查
/skill superpowers:test-driven-development

与其他插件配合

Superpowers 可以与其他插件良好配合，例如：

1
2
3
4
# 安装前端设计技能
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code

# 在 brainstorming 后，Claude 会自动使用前端技能来设计 UI

工作流定制

你可以在项目的 .claude/ 目录下创建自定义配置，调整技能行为：

1
2
3
4
5
6
7
8
{
  "skills": {
    "test-driven-development": {
      "strict": true,
      "framework": "pytest"
    }
  }
}

常见问题

Q: Superpowers 会减慢开发速度吗？

A: 初期可能感觉更慢，但这是在做正确的事。长期来看，减少了返工、bug 和技术债务，整体效率更高。

Q: 可以跳过某些步骤吗？

A: 可以，但不建议。Superpowers 的设计经过实践验证，每个步骤都有其价值。如果必须跳过，明确告诉 Claude 原因。

Q: 适合团队使用吗？

A: 非常适合。统一的工作流让团队协作更顺畅，代码审查更高效。

Q: 如何贡献新技能？

A: Superpowers 是开源的。你可以 fork 仓库，创建新技能，遵循 writing-skills 技能的指导，然后提交 PR。

总结

Superpowers 将 Vibe Coding 从一个”聪明的代码助手”升级为一个”系统化的软件开发伙伴”。通过：

  1. Brainstorming 确保构建正确的东西
  2. Planning 让每一步都清晰可执行
  3. TDD 保证代码质量
  4. Review 及时发现问题
  5. Verification 确保真正完成

这套工作流虽然需要一定学习成本，但带来的收益是巨大的：更少的 bug、更好的代码质量、更可预测的开发过程。

如果你正在使用 Claude Code 进行严肃的软件开发，Superpowers 值得一试。

参考资源

本文发布于 2026-01-15，基于 Superpowers 最新版本编写。