< BACK 我是如何实际使用 obra/superpowers 的,Claude Code 缺失的方法论层 -- 线条艺术插画

我如何实际使用 obra/superpowers,Claude Code 缺失的方法论层

如果你的 Claude Code 会话仍然感觉像你在保姆式地陪伴一个拒绝在编写前进行规划的初级工程师,你并不孤单。2026 年与编码代理合作的诚实版本是,代理很快、能力强,而且结构上过度乐观。它会跳过头脑风暴,忽略测试,编写错误的抽象,并发布错误。解决方案不是更好的提示。解决方案是在代理之上添加一个方法论层。

对我来说,那个层级就是 obra/superpowers,Jesse Vincent 为 Claude Code 设计的代理型技能框架。截至 2026 年 5 月,GitHub 星标接近 180,000,目前版本为 v5.1.0。它不是提示词模板,不是斜杠命令包,不是氛围。它是一个完整的开发方法论,根据上下文自动触发,强制执行测试驱动开发,并将工作分解为 2-5 分钟的任务,具有明确的规范。

过去六个月,我在我接触的每个项目上运行 Superpowers——你正在阅读的个人网站、我在 Seahawk Media 的咨询工作、HostList 目录、博客内容制作,以及相当数量的一次性设计和工具工作。诚实的评价,经过如此大量的使用:这是自代理本身发布以来,对我 Claude Code 工作流最大的生产力改变。这篇文章是实际的分解,它是什么,我如何在我从事的五个类别中使用它,以及仍然需要改进的部分。

Superpowers 实际上是什么,90 秒内解释

Superpowers 作为 Claude Code 的市场插件发布。一个安装命令:

/plugin install superpowers@claude-plugins-official

之后,你的 Claude Code 代理可以访问一个可组合的技能库。每个技能都是插件目录中的一个 markdown 文件,描述何时以及如何应用特定的工作流、TDD、并行代理调度、代码审查、头脑风暴、计划编写、调试等等。Claude 读取技能元数据,识别你对话中的情况,并自动将相关技能拉入上下文。大多数时候你不需要手动调用技能。你描述问题,Claude 自己路由。

最后让我理解的心理模型是:它就是每个高级工程团队曾经拥有的部落知识,关于这个团队如何计划、测试、审查和发布的不成文规则,只是现在它是一个可便携的库,你可以在任何项目上安装,代理在每个任务前读取它。

完成繁重工作的七阶段工作流

大部分价值来自 Superpowers 默认强制执行的一个核心工作流。各阶段依次如下,括号中是技能名称:

  • 头脑风暴,在编写任何代码之前通过问题来精化想法。(brainstorming)
  • Worktree 隔离,每个非平凡的任务都在 git worktree 中运行,而不是在主分支上。(using-git-worktrees)
  • 计划编写,在接触代码之前,将工作分解为 2-5 分钟的离散任务,具有确切的规范。(writing-plans)
  • 子代理驱动的开发,每个任务分配新的子代理,执行两阶段审查,主代理保持方向感,工作代理保持专注。(subagent-driven-development)
  • 测试驱动开发,RED-GREEN-REFACTOR 是强制性的,不是可选的。(test-driven-development)
  • 代码审查,基于严重程度的审查,对关键问题进行明确的阻止。(requesting-code-review)
  • 分支完成,当工作完成时,进行结构化合并或 PR 决策。(finishing-a-development-branch)

在实践中,对于 10 行代码的编辑,你不会手动运行全部七个阶段。框架根据任务的复杂度决定哪些阶段适用,并跳过那些过度的阶段。修复一个拼写错误会简要运行规划技能并跳过 TDD。在 25,000 页的目录上添加新功能会运行完整序列。

我如何使用 Superpowers 进行博客写作和 SEO

这是没人谈论的使用场景,因为框架是为代码构建的,但大规模内容生产本质上是同样的问题:结构化规划、并行执行和发布前审查。我使用的五个具体模式:

1. 草稿前的帖子头脑风暴

每篇帖子都从头脑风暴技能开始。我用一两行描述主题,Claude 进行一次真正的审问:谁会读这篇,他们已经知道什么,对比角度是什么,我自己工作中的哪些具体信号应该出现在草稿中。大多数过去需要 90 分钟大纲会议的帖子现在只需 15 分钟的引导式问答,并能产生更紧凑的简要。

2. 集群帖子的计划写作

多篇内容集群(我本周发布的 HIPAA 集群是最近的例子)使用写作计划技能。我描述母主题,Claude 规划 3-5 篇支持帖子及其角度、内部链接结构和目标关键词。计划进入项目中的 markdown 文件。每篇帖子成为一个离散的 30-45 分钟任务。集群在一天内完成,而不是两周。

3. 关键词研究的并行代理调度

分派-并行-代理技能使大型SEO研究项目成为可能。对于竞争对手分析,我需要DataForSEO SERP数据用于8个关键词、4个排名竞争对手的内容审计和父主题的AI Overview引用检查。三个并行代理出去,每个都带回结构化的发现,主代理进行合成。曾经需要半天手动SERP切换的工作,现在变成了10分钟的结构化分析。

4. 测试驱动的内容质量门控

听起来有点违反直觉,但它确实有效:我的内容管道有一套测试套件。字数、Flesch-Kincaid 可读性评分、元描述长度 140-155、禁用词检查、内部链接最小值、schema 有效性、hreflang 完整性。每个草稿都要经过这道关。Superpowers 的 TDD 技能会强制执行,如果文章未通过检查,草稿就不会发布,直到问题得到解决。散文也要 RED-GREEN-REFACTOR。

5. 工作树隔离以实现站点范围的内容重写

当我本月为TRIBE v2对齐重写了17个hero副本时,工作树技能将重写与主分支隔离,直到整批完成并审查。生产环境上没有半成品的hero副本。这个技能现在已经成为习惯,以至于我注意到其他项目何时没有它。

我如何使用Superpowers进行设计工作

通过 Claude Code 进行设计是一个不同的问题,Figma 不在代理的掌控范围内,但周围的一切都在:设计标记、组件规范、文案、间距、无障碍审计、幻灯片。我依赖的三个模式:

1. 从品牌简报生成令牌架构

基于品牌简报的头脑风暴 + 写作计划会生成完整的设计标记规范、原始层、语义层、组件层,一次会话完成。Claude 并行路由设计技能(在范围内时)和写作计划技能。输出是代码库可用的 CSS 变量,而不是需要有人后来转换的 Figma 文件。

2. 组件规范生成

接收代码审查和分配并行代理处理组件规范工作。我描述一个组件(定价卡、服务中心区块、对比表),Claude 编写完整的规范、属性、变体、状态、无障碍备注,工程师或另一个代理可以实现。规范在交付前由并行代理审查。

3. 幻灯片制作

我的演示工作现在都通过 Superpowers 进行。叙事头脑风暴、幻灯片结构的写作计划、图表生成和文案优化的并行代理。一份过去需要一天工作的 25 张幻灯片,现在用两小时的引导会话完成,幻灯片以 HTML + Chart.js 形式交付,而不是需要有人重新创建的二进制文件。

我如何在网络开发中使用 Superpowers

这是最初的使用场景,也是框架深度所在的地方。这周的两个例子:

WordPress Stack Advisor 工具

我构建了 WordPress Stack Advisor,一个免费工具,接收 URL、获取网站、检测 CMS 和 30+ 个插件,返回 Claude 生成的堆栈建议,耗时约 8 个工作小时的会话时间。头脑风暴技能生成了输入/输出规范和系统提示方法。写作计划将构建分解为离散任务:检测模块、Claude 集成、UI 页面、CSP 接线、冒烟测试。子代理驱动的开发在独立的代理上下文中交付每个任务,主代理保持架构全景图。检测模块上的 TDD 在两个正则表达式 bug 进入生产前就捕获了。整个项目作为干净的 PR 发出,有真实的提交历史。

HIPAA 博客集群

三篇文章,完全交叉链接,配有英雄图像、架构标记和到现有 HIPAA 合规 Next.js 文章的内部链接结构。头脑风暴表明了差距分析(AccountableHQ 未涵盖的内容、Reddit 线程过时的地方)。写作计划构建了集群:父文章升级、两篇新的支持文章(Supabase + Vercel BAA、AI HIPAA)、共享内部链接框架。并行智能体拉取 DataForSEO SERP 和关于 Vercel、Supabase、OpenAI、Anthropic、Azure HIPAA 定价的实时网络研究。子智能体驱动的开发产生了每篇文章。集群在一次专注会话中发布。

我如何在个人项目中使用 Superpowers

这个框架在非工作问题上的适配能力出人意料地强。三个真实案例:

旅行研究

家庭假期规划:为实际方案进行头脑风暴(孩子能接受什么、预算是多少、日期怎么安排),并行代理负责餐厅研究、住宿分析和行程评分。输出是一份单页计划,附带实际来源的引用,而不是通用的列表文章。仅仅是头脑风暴技能就值得安装,它能推动大多数家庭规划会跳过的对话。

财务和决策

更大的个人财务决策(房贷再融资、购房、买车)采用与商业工作相同的计划编写方法。输出是结构化比较,权衡明确,而不是基于直觉的建议。代码评审技能改编用于非代码评审,能发现我会跳过的缺失分析。

个人写作练习的内容

个人散文(线下博客、咖啡馆写作、技术思考)都先经过头脑风暴。我最好的个人写作大多始于一场30分钟的 Superpowers 对话,它浮现出我本不会采用的角度。这项技能就像一位同情心强的编辑,不会让你写出无趣的版本。

Superpowers 尚未带来回报的地方

  • 微小编辑、单行CSS更改、修复一个拼写错误、调整一段文案。Superpowers的开销在这里变成了摩擦。禁用工作流阶段或直接调用代理。
  • 纯探索,当你真的不知道要构建什么,需要快速尝试五个原型时。计划编写技能会试图过早构建结构;手动模式更快。
  • 时间紧张的调试,生产环境出现问题,你只有10分钟,框架的计划优先反射是错误的反射。如果需要就使用系统调试技能,跳过七阶段工作流。
  • 团队里其他人没有使用这个框架。如果你的协作者用的是原生Claude Code,而你用的是Superpowers,那些工件(规划文件、工作树分支、结构化提交)会让工作流变得混乱而不是更清晰。要么所有人都用,要么谁都别用。

安装及前24小时

如果你用的是Claude Code,安装就一条命令:

/plugin install superpowers@claude-plugins-official

安装后,技能会根据上下文自动加载。你无需记住它们,Claude会自动路由。最有用的前24小时是故意选择一个真实项目(不是玩具项目)并让框架运行。在真实功能上运行七阶段工作流是学习节奏的方式。仅读README是不够的;价值会随使用而增加。

两个我费了一周时间才硬生生学会的配置技巧:把工作树目录放在快速SSD上(工作树技能会创建很多目录),把技能插件加到你的dotfiles里这样它能跟着你在不同机器间迁移。没有比在新笔记本上开启一个会话后却发现缺少你已经养成习惯的工作流更糟的事了。

FAQ

Superpowers是免费的吗?

是的。该框架是开源的,采用宽松许可证。通过官方Claude Code插件市场安装,无需费用。你仍然按标准费率向Anthropic支付Claude Code使用费,Superpowers不会改变这一点,但它每项任务往往会用更多token,因为它运行更丰富的计划和并行代理。实际上这对我来说是正面权衡:更多token,更少浪费的会话。

它会替代Claude Code的内置技能吗?

不是。Superpowers是叠加的。Claude Code自己的技能系统(项目级技能、市场插件)仍然以相同方式工作。Superpowers作为方法论层插入其中,七阶段工作流、TDD强制、并行代理派遣,这些编排底层技能的使用方式。

它能用于非编码任务吗?

可以,但有局限。这个框架是为软件开发而构建的,TDD和代码审查技能显然是以代码为中心的。但头脑风暴、编写计划、分发并行代理和工作树技能可以很好地推广到内容生产、设计、研究和个人项目。我现在大约40%的Superpowers使用都是非代码相关的,生产力提升是相当的。

它与其他代理框架相比如何?

最接近的比较是Cursor的代理模式、Cline和Aider的规划工作流。Superpowers的差异在于技能库的深度和TDD强制。Cursor和Cline在IDE级别做得很好;Superpowers在方法论级别运行。它们是互补的,不是竞争关系,我在Claude Code内运行Superpowers,同时为较小任务保留Cursor进行实时编辑。

有什么陷阱吗?

有两个真实的陷阱。首先,你必须真正使用它;只读README而不运行工作流会让你拥有与之前相同的Claude Code。其次,框架的先规划反射对某些任务是错误的(纯探索、紧急调试)。知道何时禁用工作流是学习曲线的一部分。大约两周的定期使用后,节奏变成习惯,你会停止思考哪些技能在运行。

相关阅读

WordPress的Claude Code:我的代理在2026年运行的工作流、更广泛的Claude Code代理工作流,Superpowers作为方法论层插入其中。

WordPress Stack Advisor,一个我用 Superpowers 在大约 8 小时的会话时间内端到端构建的工作工具。

WordPress alternatives 2026:当无代码不是答案时,这是一篇集群文章,由 Superpowers 的写作计划加平行研究工作流在一次会话中产出。

这个 agent 速度快。这个 agent 能力强。这个 agent 在结构上持乐观态度。限制乐观主义付诸实践的是方法论。

如果你想讨论如何将 Superpowers 集成到真实的工程或内容团队中,包括人的问题、工作流设计、成本经济学,请预约 30 分钟通话。我现在在 Seahawk Media 的每个项目中都运行这套流程,这些模式可以推广到不同规模的团队。

< BACK