如果你的 Claude Code 会话仍然感觉像你在保姆式地陪伴一个拒绝在编写前进行规划的初级工程师,你并不孤单。2026 年与编码代理合作的诚实版本是,代理很快、能力强,而且结构上过度乐观。它会跳过头脑风暴,忽略测试,编写错误的抽象,并发布错误。解决方案不是更好的提示。解决方案是在代理之上添加一个方法论层。
对我来说,这一层就是 obra/superpowers — Jesse Vincent 的 Claude Code 代理技能框架。截至 2026 年 5 月,即将达到 180,000 个 GitHub 星标,目前处于 v5.1.0 版本。它不是提示模板,不是斜杠命令包,不是一种氛围。它是一个完整的开发方法论,根据上下文自动触发,强制执行测试驱动开发,并将工作分解为 2-5 分钟的任务,具有明确的规范。obra/superpowers — Jesse Vincent's agentic skills framework for Claude Code. Approaching 180,000 GitHub stars as of May 2026, currently at v5.1.0. It is not a prompt template, not a slash command pack, not a vibe. It is a complete development methodology that triggers automatically based on context, enforces test-driven development, and breaks work into 2-5 minute tasks with explicit specifications.
过去六个月来,我在我接触的每个项目上都运行了 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)
- 工作树隔离——每个非平凡的任务都在 git 工作树中运行,而不是在你的主分支上。(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 接线、冒烟测试。子智能体驱动的开发以新鲜的智能体上下文隔离交付每个任务,同时主智能体保持架构全景。检测模块的测试驱动开发在两个正则表达式 bug 进入生产前就捕获了。整个工作作为干净的 PR 和真实提交历史发布。the WordPress Stack Advisor — a free tool that takes a URL, fetches the site, detects the CMS and 30+ plugins, and returns a Claude-generated stack recommendation — in roughly 8 working hours of session time. The brainstorming skill produced the input/output spec and the system prompt approach. Writing-plans broke the build into discrete tasks: detection module, Claude integration, UI page, CSP wiring, smoke test. Subagent-driven development delivered each task in isolation with a fresh agent context, while the main agent kept the architectural picture. TDD on the detection module caught two regex bugs before they landed in production. The whole thing went out as a clean PR with a real commit history.
HIPAA 博客集群
三篇文章,完全交叉链接,配有英雄图像、架构标记和到现有 HIPAA 合规 Next.js 文章的内部链接结构。头脑风暴表明了差距分析(AccountableHQ 未涵盖的内容、Reddit 线程过时的地方)。写作计划构建了集群:父文章升级、两篇新的支持文章(Supabase + Vercel BAA、AI HIPAA)、共享内部链接框架。并行智能体拉取 DataForSEO SERP 和关于 Vercel、Supabase、OpenAI、Anthropic、Azure HIPAA 定价的实时网络研究。子智能体驱动的开发产生了每篇文章。集群在一次专注会话中发布。HIPAA-compliant Next.js post. Brainstorming surfaced the gap analysis (what AccountableHQ doesn't cover, where Reddit threads are out of date). Writing-plans structured the cluster: parent post upgrade, two new supporting posts (Supabase + Vercel BAA, AI HIPAA), shared internal-link skeleton. Parallel agents pulled DataForSEO SERPs and live web research on Vercel, Supabase, OpenAI, Anthropic, Azure HIPAA pricing. Subagent-driven development produced each post. The cluster shipped in one focused session.
我如何在个人项目中使用 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插件市场安装,无需付费。你仍然按标准费率为Claude Code使用付费给Anthropic——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。其次,框架的先规划反射对某些任务是错误的(纯探索、紧急调试)。知道何时禁用工作流是学习曲线的一部分。大约两周的定期使用后,节奏变成习惯,你会停止思考哪些技能在运行。
相关阅读
Claude Code for WordPress:我的机构在2026年运行的工作流——更广泛的Claude Code机构工作流,Superpowers作为方法论层植入其中。 — the broader Claude Code agency workflow, with Superpowers slotting in as the methodology layer.
WordPress Stack Advisor——我用 Superpowers 花大约 8 小时的会话时间从头到尾构建的一个实用工具。 — a working tool I built using Superpowers in roughly 8 hours of session time, end to end.
WordPress alternatives 2026: when no-code is not the answer——Superpowers 的写作计划 + 并行研究工作流在一次会话中产生的集群文章。 — the cluster post that the Superpowers writing-plans + parallel-research workflow produced as a single session.
这个 agent 速度快。这个 agent 能力强。这个 agent 在结构上持乐观态度。限制乐观主义付诸实践的是方法论。
如果你想讨论如何将 Superpowers 嵌入真实的工程或内容团队——涉及人员问题、工作流设计、成本经济学——请预订 30 分钟的通话。我现在在 Seahawk Media 的每个项目上都运用这套方法,这些模式可以推广到各种规模的团队。book a 30-minute call. I run this on every project at Seahawk Media now and the patterns generalise across team sizes.
