AI自动化 2026-05-26

Obra Superpowers Claude Code 完整教程：2026 工作流指南

ZecCloud 技术团队 · 2026年5月26日 · ~8 分钟
Obra Superpowers Claude Code 插件工作流与云端 Mac 开发指南 2026

Superpowers（作者 Jesse Vincent / @obra）是 GitHub 上星标最多的 Claude Code 插件生态——截至 2026 年已有 17 万+ stars。与只增加单一技能或 MCP 的插件不同，Superpowers 安装的是完整软件开发方法论：先头脑风暴再写代码、把计划拆成小任务、强制测试驱动开发（TDD）、合并前审查。

Anthropic 在 2026 年初将 Superpowers 纳入官方 Claude 插件市场。若你已读过我们的最佳 Claude Code 插件排行，Superpowers 是那些「点工具」之上的工作流层——本篇覆盖安装、命令与适用场景。

Superpowers 到底是什么

Superpowers 不是模型升级，而是可组合技能 + 钩子的插件包，按阶段引导 Claude Code：

阶段技能行为
设计苏格拉底式头脑风暴——改文件前先提问
计划writing-plans 将工作拆成 2–5 分钟任务并标明路径
隔离using-git-worktrees 创建分支 worktree，保持干净基线
构建子智能体或批量执行，强制 TDD（红 → 绿 → 重构）
审查requesting-code-review 在任务间审查；严重问题阻断进度
交付finishing-a-development-branch — 合并、PR 或丢弃并验证
可引用定义：Superpowers 把 Claude Code 从「快速代码生成器」变成「在设计与测试明确之前拒绝动手实现的严谨队友」。

来源：obra/superpowers 与 Superpowers 文档。

在 Claude Code 上安装 Superpowers（两条路径）

路径 A — Anthropic 官方市场（推荐）

/plugin install superpowers@claude-plugins-official

若已启用 claude-plugins-official（近期 Claude Code 默认开启），这是阻力最小的安装方式。参见 Claude Code 发现插件。

路径 B — Obra Superpowers 市场（最新发布）

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

当 Obra 市场版本早于 Anthropic 目录时选路径 B。随时更新：

/plugin update superpowers

/reload-plugins

验证安装

在新 Claude Code 会话中确认斜杠命令存在：

  • /superpowers:brainstorm — 交互式设计细化
  • /superpowers:write-plan — 根据已批准设计生成实现计划
  • /superpowers:execute-plan — 带检查点的批量执行

若命令缺失，重新添加市场并检查 /plugin list。

Superpowers 工作流逐步说明

1. 头脑风暴（不要跳过）

从 /superpowers:brainstorm 开始，或用自然语言描述功能。Superpowers 阻止过早写代码——Claude 会先澄清问题并产出待批准的设计文档。

原因：多数智能体失败是规格失败，而非模型失败。

2. 编写计划

设计批准后，writing-plans 输出包含精确文件路径、每步验证方式、2–5 分钟粒度估算的任务列表。

3. Git worktree 隔离

using-git-worktrees 创建隔离分支/工作区，运行项目初始化，并在编辑前确认测试基线干净。

4. 强制 TDD 执行

实现阶段，test-driven-development 技能要求：写失败测试 → 观察失败 → 写最少代码 → 观察通过 → 重构并提交。技能内含「铁律」与常见智能体捷径的红旗表。

5. 代码审查关卡

requesting-code-review 在任务之间运行。严重问题会阻断下一任务直至修复。

6. 完成分支

finishing-a-development-branch 验证测试后，提供合并 / PR / 保留 / 丢弃选项。

Superpowers vs 原版 Claude Code

维度原版 Claude Code启用 Superpowers
听到「做 X」后常直接改文件先头脑风暴
测试除非明确要求强制 TDD 循环
计划临时发挥结构化计划与检查点
并行手动子智能体批量驱动
纪律取决于提示词技能 + 钩子强制执行
最适合快速脚本、一次性修复功能、重构、团队工作流

何时可跳过 Superpowers：一次性原型、纯 Markdown 编辑，或预计 <15 分钟、流程成本高于省下的 bug 的任务。

在云端 Mac mini M4 上使用 Superpowers

iOS 与全栈团队常在专用 Mac mini M4（本地或ZecCloud 云租赁）上运行 Claude Code，以便 Xcode、sourcekit-lsp 与长测试套件留在 Apple Silicon 上。

推荐步骤：

  1. SSH 登录 Mac — 见Mac mini M4 SSH 教程
  2. 在该主机安装 Claude Code CLI
  3. 通过路径 A 或 B 安装 Superpowers
  4. 在项目目录运行 /superpowers:brainstorm

插件在运行 Claude Code 的机器上执行——不在你的笔记本上。16 GB 内存的云 Mac 可舒适运行 Superpowers + swift-lsp 处理中等规模 iOS 仓库。

披露说明：ZecCloud 提供本篇提及的云 Mac mini 租赁。Superpowers 为 Obra 独立开源项目；ZecCloud 不维护该插件。

Superpowers vs 其他插件包

套件重点与 Superpowers 关系
Superpowers (Obra)端到端 SDLC 纪律—
官方 feature-dev功能脚手架互补 — 更轻量
官方 pr-review-toolkitPR 审查互补 — Superpowers 分支之后使用
第三方智能体市场大量单点智能体目录更广，TDD 约束较弱

可同时运行 Superpowers + github + swift-lsp——Superpowers 管流程，GitHub 与 LSP 管数据与符号。

故障排除

问题处理
找不到命令/plugin marketplace add obra/superpowers-marketplace 后重装
技能未激活/reload-plugins；开新会话
智能体仍直接写代码先显式运行 /superpowers:brainstorm
大仓库变慢用 git worktree；在计划中缩小任务范围
与其他插件冲突禁用重叠工作流插件；保留 LSP + MCP

常见问题

Obra Superpowers 免费吗？+
是的——插件为 MIT 开源。你只需为 Claude Code / API 付费，Superpowers 本身不收费。
obra 和 Superpowers 有什么区别？+
Obra 是 Jesse Vincent 的 GitHub 组织；Superpowers 是插件仓库 obra/superpowers。「Obra Superpowers」是社区常用简称。
官方市场还是 Obra 市场？+
两者均可。用 @claude-plugins-official 最简单；用 @superpowers-marketplace 可更快获得 Obra 发布节奏。
Superpowers 能在 Cursor 或 Codex 上用吗？+
Superpowers 面向多种 harness，但Claude Code 有原生插件路径（本文所述）。其他工具可能需要手动复制技能——见仓库 README。
能和现有 Claude Code 插件一起用吗？+
可以。保留 GitHub、语言服务器（如 swift-lsp）与 commit-commands；Superpowers 在之上增加工作流技能。

结论

Obra Superpowers 是 2026 年 Claude Code 的纪律层：14+ 技能强制「头脑风暴 → 计划 → TDD → 审查」再交付。从官方市场一条命令安装，验证 /superpowers:brainstorm，在本地 Mac 或云端 Mac mini上跑严肃功能开发。

在云端 Mac mini 上运行 Superpowers

ZecCloud 提供独享 Apple Silicon 节点，香港/东京/首尔/新加坡/美东可选，约 ¥730/月起，5 分钟 SSH 交付。