Clipping 微信公众号

你的AI编程搭档,有了-超能力-——Superpowers Skills技能库完全指南

by AI兴观点 原文 ↗
Created: 2026-04-30

公众号名称:程叙架构与AI.

作者名称:AI兴观点

发布时间:2026-04-30 08:35

原文链接:https://github.com/obra/superpowers

✅点击上方🔺公众号🔺关注我✅

你有没有过这样的经历——

给AI编程助手一个任务,它噼里啪啦一顿写代码,commit了十几二十个,结果一跑,全是bug?

或者AI完全不理解你的意图,你让它做个”用户登录功能”,它上来就开始写数据库Schema,连产品需求都没问过?

Jesse Vincent(GitHub 171k Stars项目[1]的作者)也遇到了同样的问题。

于是他做了件事:给AI编程助手写了一整套”超能力”技能库。

这个项目叫 Superpowers

GitHub:github.com/obra/superpowers

目前斩获 171,000+ Stars15,000+ Forks,是AI编程工具领域最火的开源项目之一。支持几乎所有主流AI编程工具:Claude Code、GitHub Copilot CLI、OpenAI Codex、Cursor、OpenCode、Gemini CLI。


一、为什么需要”超能力”?

Jesse在2025年10月的博客文章[2]里写过他的顿悟时刻:

“Skills are the interesting part.”

“Skills are what give your agents Superpowers.”

他说,以前AI编程最大的问题不是AI不够聪明,而是AI没有章法

你让它写代码,它就写代码。不会先问你”想做什么”,不会先规划任务,不会先写测试,甚至不会先想想”这样做对不对”。

人编程有经验,知道先设计、再动手、边做边测。

但AI没有这个”肌肉记忆”。

Superpowers 就是给AI编程助手注入一套”肌肉记忆”。

它把专业软件工程师的思维方式和工程规范,做成了一套可组合的”技能卡片”(Skills)。AI在执行任何任务之前,会自动检查有没有相关的技能要激活——强制执行,不是建议


二、Sam Schillace 的”复合团队”洞察

关于AI编程的真正突破,Sam Schillace(微软Amplifier框架[3]的联合作者)在一篇文章[4]里提出了一个重要概念:复合团队(Compounding Teams)

他说:

“那些真正实现复合增长的团队,不是在直接写代码。他们围绕AI模型构建了一套框架——就像Amplifier——有回调钩子、工具调用和流程控制,但系统本身要主动得多。”

关键洞察:

  • 单纯用Claude Code或Copilot,生产力有提升,但是短期的、有限的
  • 真正复合增长的团队,会给AI系统”建造工具的能力”——让AI自己写工具,然后永久使用这些工具。
  • 这是一种”建造工具来制造工具”的递归思维。
  • 一个团队已经有好几个月没有直接接触代码,但产品一直在正常交付——代码审查甚至被认为是一种”Fireable Offense”(拖后腿的行为)。

Sam Schillace把这类系统称为”Model-based action”(基于模型的行为)——用模型擅长使用的编程工具(git、markdown、Kubernetes、XML)作为基础设施,让模型自己构建和改进去中心化的工具链。

Superpowers 就是这种思路的具体实现。


三、Superpowers 的核心理念

Superpowers 建立在四个核心原则之上:

1. 先想清楚,再动手(Test-Driven Development)

写代码之前,先写测试。看测试失败,再写最小代码让它通过。这不是建议,是铁律。

2. 系统化优于随机化(Systematic over ad-hoc)

遇到bug不要乱猜。遵循一套固定的根因分析流程:复现→收集证据→定位问题→修复→验证。

3. 降低复杂度(Complexity reduction)

简单性是首要目标。YAGNI(You Aren’t Gonna Need It)、DRY(Don’t Repeat Yourself)贯穿始终。

4. 用证据说话(Evidence over claims)

修复完bug?测试通过?别急着庆祝。先验证是真的修好了。


四、完整工作流程:7步走

Superpowers 包含7个环环相扣的技能,覆盖从”想法”到”上线”的完整流程:

第一步:Brainstorming(头脑风暴)

触发时机:任何创意工作之前——新建功能、修改行为、搭建项目。

这是整个流程的起点。AI不会一上来就写代码,而是:

  1. 先了解项目背景(读文件、看文档、最近的commit)
  2. 问你一系列问题,一次只问一个,逐步澄清需求
  3. 提出2-3个方案,附带权衡分析和推荐建议
  4. 分段展示设计方案,等你逐段确认
  5. 确认后,生成设计文档并存档

铁律HARD-GATE——在你书面批准设计方案之前,AI不得编写任何代码,不得搭建任何项目。哪怕你觉得”这个需求很简单”。

这一步防的是:“简单”项目里藏着的未经验证的假设。


第二步:Using-Git-Worktrees(Git工作树)

触发时机:设计方案批准后,开始实现之前。

AI自动创建独立的Git Worktree工作区,为新功能建立独立的分支,和主代码库隔离。

这意味着你可以同时推进多个功能而互不干扰——AI可以在一个分支上做登录功能,同时另一个分支在做评论功能,井水不犯河水。


第三步:Writing-Plans(写实施计划)

触发时机:有了设计文档,需要开始实现时。

AI将设计方案拆解成一系列原子级任务

  • 每个任务2-5分钟能完成
  • 每个任务有精确的文件路径、完整代码、验证步骤
  • 假设执行者是一个”技术熟练但完全不了解项目的初级工程师”

任务描述要具体到”打开 src/auth/login.ts 文件,在第23行后插入以下代码”——不需要任何猜测。


第四步:Subagent-Driven-Development(子代理驱动开发)

触发时机:有了实施计划,开始执行时。

这是Superpowers最精彩的部分。

AI不再一个人埋头苦干,而是把任务分发给”子代理”并行执行

  1. 主代理读取计划,创建任务清单
  2. 每个任务分配给一个全新的子代理(干净上下文,不继承历史)
  3. 子代理完成实现后,经过两阶段审查
    • 第一阶段:规格审查(代码是否符合计划要求)
    • 第二阶段:代码质量审查(命名、测试、错误处理)
  4. 审查发现问题,打回子代理修复
  5. 通过后,标记任务完成,继续下一个

Jesse实测:Claude可以在这个流程里连续自主工作数小时,不偏离原始计划。


第五步:Test-Driven-Development(测试驱动开发)

触发时机:任何功能实现或bug修复之前。

这是Superpowers的”铁律”级别技能,核心理念三个字:红-绿-重构

RED阶段:先写一个最小化测试,展示”应该发生什么”。测试必须失败(因为功能还不存在)。

GREEN阶段:写最少的代码让测试通过。不要多写一行”未来可能用到”的代码。

REFACTOR阶段:在测试全部通过的前提下,优化代码结构。

铁律:在看到测试失败之前,不允许写任何产品代码。

如果你在写测试之前就写了产品代码?删掉,从头开始。


第六步:Requesting-Code-Review(代码审查)

触发时机:每个任务完成后、合并到主分支前。

AI自动调用代码审查子代理,对照实施计划逐条检查:

  • 严重问题(Critical):立即修复,否则阻塞
  • 重要问题(Important):修复后再继续
  • 次要问题(Minor):记录,稍后处理

Review不是可选项,是流程的必要环节。


第七步:Finishing-a-Development-Branch(完成开发分支)

触发时机:所有任务完成、测试通过后。

AI验证测试通过,然后给你四个选项:

  1. 合并到本地main分支
  2. 推送到远程并创建Pull Request
  3. 保留分支,稍后处理
  4. 丢弃此工作

你选,AI执行。


五、技能全景图

Superpowers的技能分为四大类:

🧪 测试类

技能说明
test-driven-development红-绿-重构TDD循环,含测试反模式参考
verification-before-completion确保修复真正有效,而非表面通过

🐛 调试类

技能说明
systematic-debugging四阶段根因分析法:复现→证据→定位→修复。包含防御式编程、条件等待、追踪污染源等子技术
verification-before-completion验证修复真正有效

🤝 协作类

技能说明
brainstorming苏格拉底式设计澄清,分段确认
writing-plans详细实施计划,原子级任务拆解
executing-plans分批执行,附带人工检查点
dispatching-parallel-agents并行分发子代理到独立问题域
requesting-code-review预提交审查清单
receiving-code-review响应审查反馈
using-git-worktrees并行开发分支隔离
finishing-a-development-branch合并/PR决策工作流
subagent-driven-development子代理两阶段审查驱动开发

🔧 元类

技能说明
writing-skills创建新技能的完整指南(含TDD方法论)
using-superpowers技能系统入门介绍

六、Superpowers 的设计哲学亮点

1. 技能触发是强制的,不是建议

HARD-GATE是Superpowers里的特殊标记,意味着”这是强制执行,不是建议”。

brainstorming有HARD-GATE:在设计方案批准之前,不许写一行代码。

systematic-debugging有铁律:在找到根因之前,不许提任何修复方案。

没有”这步可以跳过”的例外。

2. 写技能本身也是TDD

创建新技能的流程和写代码一样:

先设计压力测试场景,让AI在没有技能的情况下演示失败,记录AI的每一个”合理化”借口,然后针对这些借口写技能文档,再验证AI现在能正确遵循。

Jesse把这个方法论叫做:RED-GREEN-REFACTOR for SKILLS

具体怎么测?他让Claude用各种”压力场景”来测试技能——比如时间压力+过度自信的场景,看AI会不会跳过必要的步骤。

3. 子代理隔离,不污染上下文

subagent-driven-development的核心原则:每个子代理都是全新的上下文,只给它完成任务所需的精确信息。

不要让子代理继承主会话的历史——那会引入混乱和偏见。

4. 内联自审替代子代理审查

v5.0.6版本做了一个重要优化:把”用子代理审查计划”改成了”内联自审”。

实测数据:子代理审查循环让执行时间增加了约25分钟,但5个版本×5次试验的回归测试显示,无论有没有审查循环,计划质量评分都一样。

内联自审在约30秒内完成,质量相当。从此不再有”等待审查”的漫长空转。


七、如何安装

Superpowers支持所有主流AI编程工具:

Claude Code(官方插件市场)

/plugin install superpowers@claude-plugins-official

Claude Code(Superpowers市场)

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

GitHub Copilot CLI

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

OpenAI Codex

在Codex侧边栏点击Plugins,搜索Superpowers,点击安装。

OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

八、社区与支持

  • Discord:discord.gg/35wsABTejz(社区支持、问题交流、分享作品)
  • GitHub Issues:github.com/obra/superpowers/issues
  • 发布公告订阅:primeradiant.com/superpowers/

Superpowers由Jesse Vincent(@obra)和Prime Radiant团队维护,采用MIT开源许可证。


写在最后

Superpowers 解决的不是”AI编程工具不够多”的问题。

它解决的是:AI编程工具缺乏工程纪律的问题。

当AI能自主工作数小时、commit几十次、不偏离计划——这不是因为AI变聪明了,而是因为有人把工程纪律写成了一整套可执行的技能,让AI在正确的时间做正确的事。

Sam Schillace说,这些团队现在的瓶颈已经不是生产力,而是人类注意力——因为AI太高效了,5-10个流程同时跑,API每天烧几百美元,但人类的审核速度成了新的限速步骤。

你的下一个编程任务,要不要试试给AI装上这套”超能力”?


参考资料:

[1] github.com/obra/superpowers

如果觉得这篇文章有帮助,欢迎点赞、在看、转发!有问题也可以在评论区留言,我会尽量回复!


cover_image

Original AI兴观点 程叙架构与AI.

Read more

输入关键词开始搜索