Superpowers 深度解析让 AI 编程助手拥有「资深工程师」的方法论如果你曾用 AI 编程工具写过复杂项目,可能都遇到过这些问题:代码不完整、跳过测试、随手糊一套架构、调 Bug 全靠猜……Superpowers 正是为解决这些问题而生。它把数十年沉淀下来的软件工程方法论,以 Markdown 文件的形式注入到 AI 编程助手中,让其从「智能补全」蜕变为「资深开发者」。— · — · — · —一、什么是 SuperpowersSuperpowers 是由 Jesse Vincent(GitHub 用户名 obra)创建的一个开源「智能体技能框架」(Agentic Skills Framework),本质上是一套软件开发方法论。它通过向 AI 编程助手注入一系列结构化的「技能」(Skills),强制其遵循专业开发流程,而不是从零开始即兴发挥。自 2025 年 10 月发布以来,该项目在 GitHub 上已收获超过 17 万 Stars,并于 2026 年 1 月被纳入 Anthropic 官方插件市场。版本 5.0.7(2026 年 3 月)是目前的稳定版本。核心定位Superpowers 不是给 AI 增加新能力,而是为其增加「纪律」。Claude Code 本身已经具备规划、调试、重构等能力,Superpowers 的价值在于:把这些能力组织成有序的、可预测的、不可跳过的工作流。一句话概括: Superpowers 「方法论作为代码」(Methodology-as-Code),把资深工程师的工作习惯固化为机器可读的 Markdown 文件。支持的平台Superpowers 采用与平台无关的设计,同一套 skills/ 目录可在以下编程助手中使用:●Claude Code(原生支持,推荐)●Cursor IDE●OpenAI Codex CLI 与 Codex App●GitHub Copilot CLI●Gemini CLI(通过扩展)●OpenCode 开源框架●Factory Droid不论使用哪个平台,核心 Skills 文件保持一致,真正实现了「一次编写,处处运行」的工程文化。— · — · — · —二、Superpowers 的完整执行过程理解 Superpowers 的执行过程,是用好它的关键。整个流程分为「启动加载」与「任务执行」两大阶段。阶段一:会话启动与自动加载Superpowers 的魔法始于 AI 编程助手的启动时刻。当你打开 Claude Code 等支持的工具时,它会:1.自动注入 Session-Start Hook(会话启动钩子)2.Hook 体积极小,据官方数据小于 2000 tokens3.Hook 内容会强制 AI 优先读取 getting-started/SKILL.md4.getting-started 文件会告知 AI 何时调用哪个技能实际的 Hook 注入内容形如:You have Superpowers.**RIGHT NOW, go read**:/Users/jesse/.claude/plugins/cache/Superpowers/skills/getting-started/SKILL.md关键设计: Hook 本身不包含完整的方法论指令,而是一个「书签」。这种渐进式披露(Progressive Disclosure)设计避免了上下文窗口被无关内容污染。阶段二:任务执行的标准生命周期当你向 AI 发出一个编程任务后,Superpowers 会引导其按以下完整生命周期顺序推进:阶段技能调用产出物 / 行为①brainstorming(头脑风暴)AI 拒绝直接写代码,先用苏格拉底式提问澄清需求,产出经用户确认的设计文档②using-git-worktrees(分支隔离)创建独立的 Git Worktree 工作区,新建特性分支并验证基线测试③writing-plans(撰写计划)将设计拆解为 2-5 分钟可完成的微任务,标注文件路径与测试用例④subagent-driven-development派遣独立子智能体执行每个任务,父智能体只负责协调与验收⑤test-driven-development子智能体内部强制 RED-GREEN-REFACTOR 循环,先写失败测试再实现⑥requesting-code-review另一个全新的子智能体进行代码审查,对照计划与编码规范打分⑦verification-before-completion运行完整验证(测试、构建、Lint),确认所有标准达成⑧finishing-work(收尾)提供 PR 创建、本地合并、保留分支等结构化选项整个流程的核心理念可以用一个公式来表达:前期投入 10-20 分钟做头脑风暴和规划 → 实施阶段省下数小时的 Bug 修复与返工时间。社区数据显示,完整流程使整体开发速度提升 2-3 倍。— · — · — · —三、Superpowers 的触发逻辑Superpowers 最巧妙的设计,是它的「双轨触发机制」。技能既可以由 AI 根据上下文自动激活,也可以由用户通过显式命令调用。触发方式一:自动激活(Auto-Trigger)这是 Superpowers 最强大也最容易被忽视的能力。AI 会在每个任务开始前,主动扫描所有可用技能的 YAML frontmatter 元数据,匹配当前任务上下文:---name: brainstormingdescription: |You MUST use this before any creative work —creating features, building components,adding functionality, or modifying behavior.Explores user intent, requirements and designbefore implementation.---description 字段不是简单的说明文字,而是一段「触发指令」。一旦 AI 识别出当前任务命中描述,该技能将被强制激活,且不可绕过。▍ 自动触发的关键词模式各核心技能的触发关键词如下:技能名触发关键词与场景brainstorming创建功能、构建组件、添加新行为、修改业务逻辑等任何「创造性工作」test-driven-development实现新功能、编写业务代码,只要涉及「写代码」就必然触发systematic-debuggingBug、报错、修复、异常、问题排查等关键词出现时subagent-driven-development任务包含 2 个以上无共享状态、无顺序依赖的独立子任务时requesting-code-review收到代码审查反馈、需要决定是否采纳建议时verification-before-completionAI 即将声明「完成」「修好了」「实现了」之前触发方式二:斜杠命令显式调用当你需要明确控制流程,或希望从中间某一步开始时,可以使用斜杠命令直接调用技能:# 启动头脑风暴会话/brainstorming# 调用其它技能的通用语法/superpowers:brainstorm 用户认证系统/superpowers:write-plan 实现 OAuth2 登录/superpowers:execute-plan# 提醒 AI 它拥有 Superpowers(常用)/using-superpowers使用建议: 在新会话开始时输入 /using-superpowers,可以显式提醒 AI 当前会话应全程使用 Superpowers 方法论,这比依赖自动加载更可靠。触发方式三:Iron Law(铁律)与红旗清单每个 Superpowers 技能文件都有一个独特的结构:开头是大写的「Iron Law」(铁律),后面跟一张「Red Flags」(红旗)清单。▍ Iron Law 示例(TDD 技能)IRON LAW:NO PRODUCTION CODE WITHOUT A FAILING TEST.如果你发现自己在写实现代码而没有失败的测试,立即停止,删除代码,从测试开始。▍ Red Flags 红旗清单示例以下是 TDD 技能中明文列出的「危险信号」,一旦 AI 自己说出这些话就应该警觉:●「测试第一次运行就通过了」(说明你没真的 RED 过)●「我先实现,等下补测试」(等下永远不会来)●「我先保留这段代码作为参考」(不,删掉它)●「就这一次破例」(这是滑坡的开始)验证类技能(verification-before-completion)的红旗则包括:●「应该可以了」(should)●「大概没问题」(probably)●「看起来好了」(seems to)⚠ 重要: 这些不是激励海报式的口号,而是被编入指令的硬性检查项。一旦 AI 自己使用了这些词,它会被强制要求停下来重新验证,不允许声明完成。— · — · — · —四、14 个核心技能详细说明Superpowers 当前共内置 14 个核心技能,可大致分为四大类。下面逐一详细介绍每个技能的功能、触发场景与使用方法。4.1 设计与规划类技能▍ 1. brainstorming(头脑风暴)定位:所有创造性工作的强制前置步骤。功能详解:这是 Superpowers 中触发频率最高的技能。它拒绝让 AI 直接进入编码,而是通过苏格拉底式的多轮提问,先把模糊的需求打磨成可执行的设计文档。典型对话流程包括:●确认技术栈偏好(如 Next.js vs Vue vs Svelte)●拆分功能性与非功能性需求●探索边界情况(并发、错误处理、性能要求)●识别隐性假设并显式化●最后给出有理有据的技术推荐触发场景:任何「创建」「实现」「构建」「设计」「添加」类指令。产出:一份用户已签字确认的设计文档(spec)。▍ 2. writing-plans(撰写实施计划)定位:把设计文档转化为可执行的「微任务清单」。功能详解:针对已确认的设计,该技能会生成一份极其详尽的实施计划,任务粒度控制在 2-5 分钟内可完成。每个任务都包含:●精确的文件路径●待新增或修改的函数/类名●对应的测试用例描述●依赖关系标注●验证命令(如 npm test、构建命令)一份典型的计划可能长达 500 行,但每一行都清晰可执行,即便交给一个「热情但缺乏判断力的初级工程师」也能照着完成。Spec Self-Review: 5.0 版本新增了「计划自审清单」,会在生成计划后用约 30 秒自查,通常可发现 4-5 个潜在 Bug。▍ 3. using-git-worktrees(Git Worktree 分支隔离)定位:为每个新任务创建独立的物理工作区。功能详解:该技能调用 Git 的 worktree 功能,为每个特性分支创建独立的目录。这样做的好处包括:●主分支不被未完成的工作污染●可同时进行多个并行实验●失败的尝试可整体丢弃,无需复杂的回滚●基线测试在干净环境下运行,避免污染触发时机:设计文档已确认,即将进入编码阶段。4.2 实施与测试类技能▍ 4. test-driven-development(测试驱动开发)定位:Superpowers 的灵魂技能,强制执行 RED-GREEN-REFACTOR 循环。功能详解:这是 Superpowers 区别于其他 AI 编程工具的最显著特征。它严格执行经典 TDD 三步循环: RED先写一个会失败的测试。如果第一次就通过,说明测试本身有问题,必须重写。 GREEN写最少量的实现代码让测试通过,不追求完美,只求能跑过。 REFACTOR在测试保护下重构代码结构,优化命名、消除重复,但不增加新功能。关键纪律点:「先实现,后补测试」的做法被明确禁止。如果 AI 不小心先写了实现,它的 Iron Law 会要求其删除已写代码,从测试开始。配套原则:同时强调 YAGNI(你不会需要它,不要过度设计)与 DRY(避免重复代码)。▍ 5. condition-based-waiting(基于条件的等待)定位:处理异步操作与时间相关的测试场景。功能详解:测试异步代码时,新手常用 sleep(N) 来等待操作完成。这种做法既慢又不可靠。该技能强制使用「轮询条件」模式:// ❌ 错误做法await sleep(2000); // 祈祷 2 秒够用assert(condition);// ✅ 正确做法await waitFor(() condition true,{ timeout: 5000, interval: 50 });通过持续轮询条件状态,既能立即响应,又能在异常情况下提供明确的超时报错。▍ 6. subagent-driven-development(子智能体驱动开发)定位:利用并行子智能体,实现快速迭代与隔离审查。功能详解:对于复杂任务,父智能体不亲自写代码,而是为每个微任务派遣一个全新的子智能体。每个子智能体只看到:●当前任务的描述与上下文●对应的测试用例●相关的代码文件这种「上下文隔离」设计有三大好处:5.避免子智能体被无关历史污染,保持判断力清晰6.可并行处理多个独立任务,大幅提速7.便于事后审查,每个任务的「上下文」可独立追溯5.0 版本优化: 原先的子智能体审查环节已被「内联自审」取代,执行时间从约 25 分钟缩短到几分钟。▍ 7. parallel-task-execution(并行任务执行)定位:识别可并行的独立任务并发执行。功能详解:与 subagent-driven-development 配合使用。当遇到 2 个或以上无共享状态、无顺序依赖的任务时,自动启动并行执行:●分析任务间的数据依赖图●识别可并发的独立分支●派遣多个子智能体并发工作●最后聚合结果并验证4.3 调试与验证类技能▍ 8. systematic-debugging(系统化调试)定位:用四阶段方法论根除 Bug,而不是「乱试一通」。功能详解:面对 Bug,该技能强制按以下四阶段推进,严禁跳步:阶段名称具体动作①Reproduce(复现)先稳定地复现问题,写一个失败的最小测试用例②Isolate(隔离)用二分法、日志或断点缩小问题范围,找到出错的最小代码片段③Identify(根因)找到真正的根本原因,而不是表面症状④Verify(验证)修复后重跑复现测试,确认 Bug 真正消失⚠ 关键防线: 如果连续 3 次修复尝试都失败,该技能会触发「架构审查」,强制 AI 后退一步,质疑当前的整体设计假设,而不是继续打补丁。▍ 9. root-cause-tracing(根因追踪)定位:深度追溯依赖链,找出级联故障的源头。功能详解:适用于跨多个组件、多个模块的复杂故障。该技能教 AI 沿着调用栈与数据流向反向追溯,绘制完整的依赖图,理解每一层组件的交互方式,而不是停留在表层报错信息。▍ 10. defense-in-depth(纵深防御)定位:为关键路径设置多层验证。功能详解:对于生产代码、关键 API 端点、支付逻辑等高风险场景,单层校验不够,需要在多个层次设防:●输入层校验(用户输入)●业务逻辑层校验(权限、状态)●数据访问层校验(持久化前后)●错误处理与降级策略▍ 11. verification-before-completion(完成前验证)定位:严防 AI 滥用「我觉得修好了」式表态。功能详解:这是一个极其重要的「最后防线」技能。在 AI 准备宣称任务完成前,必须执行:8.运行完整测试套件(不只是新增的测试)9.执行构建命令,确认无编译错误10.运行代码风格检查(Lint)11.验证所有原始需求都已实现12.确认没有引入新的警告或弃用提示只有以上所有项都通过,AI 才被允许使用「完成」「修好」等确定性表述。4.4 协作与元技能类▍ 12. requesting-code-review(代码审查请求)定位:启动结构化代码审查流程。功能详解:当一个主要任务完成后,该技能会派遣一个全新的子智能体进行代码审查。审查分两阶段:●Spec Compliance(规范符合性):对照原始计划与设计,验证所有需求是否都已实现●Code Quality(代码质量):对照编码规范,检查命名、结构、可读性、测试覆盖等审查智能体使用全新上下文,避免「自己审查自己」的盲点。▍ 13. responding-to-code-review(回应代码审查)定位:用工程师的严谨态度,而非讨好,回应审查意见。功能详解:这个技能解决一个真实问题——AI 太容易屈从于审查意见,即使审查者本身可能搞错了。该技能强调:●先理解审查意见的技术背景●如果意见不清,主动追问而非猜测●如果意见有误,基于事实礼貌地反驳●严禁「表演式认同」(performative agreement)技术正确性优先于人际和谐——这是 Superpowers 反复强调的态度。AI 应当像一个有职业素养的工程师,而不是讨好的助手。▍ 14. finishing-work(收尾工作)定位:结构化地完成开发周期的最后一公里。功能详解:所有实现完成、所有测试通过、所有审查回应后,该技能会向用户呈现三个选项:13.创建 GitHub Pull Request(默认提供模板)14.本地直接合并 Worktree 回主分支15.保留当前分支,暂停工作不论选择哪个,AI 都会自动清理工作区状态、整理 Commit 历史、生成变更说明。— · — · — · —五、安装与使用指南Claude Code 安装(推荐方式)Claude Code 2.0.13 及以上版本支持插件市场,安装最为简便。第一步:启动 Claude Code,在命令行中输入:/plugin marketplace add obra/superpowers-marketplace第二步:安装插件:/plugin install superpowerssuperpowers-marketplace或使用 Anthropic 官方市场:/plugin install superpowersclaude-plugins-official第三步:退出并重启 Claude Code。重启后你会看到 Hook 自动注入提示。第四步:验证安装。输入 /help 并切换到 custom-commands 标签,应能看到 brainstorming、write-plan、execute-plan 等命令。其他平台安装Cursor IDE:在 Cursor 设置中打开插件市场,搜索 superpowers 并安装。需要使用 camelCase 风格的 hooks(5.0 版本后已支持)。GitHub Copilot CLI:copilot plugin marketplace add nguyenducviet4/superpowerscopilot plugin install superpowerssuperpowersOpenAI Codex CLI:通过官方 Codex 插件市场安装,搜索 superpowers 并 Install Plugin。Gemini CLI、OpenCode:参照官方 GitHub 仓库 obra/superpowers 中的对应说明。日常使用建议▍ 会话开始时打开一个新项目后,建议先输入:/using-superpowers这会显式提醒 AI:本次会话全程使用 Superpowers 方法论。这比依赖自动加载更可靠,尤其在长会话中。▍ 启动复杂功能开发不要直接说「帮我写一个 X」,而是说:我想开发一个项目管理工具,主要功能是看板、任务分配、评论与通知。请使用 superpowers 方法论,先从 brainstorming 开始。这样 AI 会完整走完头脑风暴 → 设计 → 计划 → 实施 → 审查的全流程。▍ 处理棘手 Bug遇到难以复现或定位的 Bug 时:/superpowers:systematic-debugging问题描述:- 现象:用户偶发性看到 500 错误- 触发条件:不规律,无法稳定复现- 影响范围:约 5% 的请求AI 会按四阶段方法论一步步推进,而不是凭直觉乱猜。自定义个人技能Superpowers 采用两层技能架构:●Core Skills(核心技能):由官方仓库维护,所有用户共享●Personal Skills(个人技能):存放于 ~/.config/superpowers/skills/,可自由扩展你可以为自己团队的特定技术栈、架构规范或业务领域编写专属技能。例如:●公司内部的命名规范●特定框架的最佳实践(如 Rails、Spring Boot)●行业合规要求(如金融行业的审计日志)最强大的玩法是:你可以把一本技术书的内容喂给 Claude,让它阅读、内化,并自动生成对应的新技能文件。— · — · — · —六、什么场景适合用 Superpowers非常适合的场景●有清晰架构要求的复杂项目(微服务、SaaS、企业级应用)●对可靠性、零停机有要求的关键业务系统●遵循敏捷或 TDD 方法论的团队,希望维持工程标准●面向客户或商用产品的专业级开发●需求模糊、需要先做需求挖掘的项目●有测试覆盖率要求的遗留代码重构可能不适合的场景●一次性脚本或玩具项目(开销大于收益)●纯探索性 Demo,只为验证想法可行性●已有非常成熟流程、不希望引入新工作方式的团队●对响应时间极敏感的紧急 Hotfix学习成本: 首次使用需要 1-2 个完整项目周期来熟悉多阶段工作流。一旦上手,后续效率提升明显。— · — · — · —七、常见问题答疑▍ Q1:Superpowers 是 Anthropic 官方出品吗?不是。Superpowers 是由 Jesse Vincent 等社区开发者维护的开源项目,采用 MIT 许可证。但自 2026 年 1 月起,它已被 Anthropic 官方插件市场收录,代表了一定程度的官方认可。▍ Q2:使用 Superpowers 是否完全免费?插件本身完全免费,开源 MIT 协议。但你仍需为底层 AI 模型(如 Claude API)的使用付费,这部分按 Anthropic 标准定价。▍ Q3:支持哪些编程语言?Superpowers 与编程语言无关。它的方法论(TDD、调试、规划)是通用的,可应用于 Python、Go、Rust、Java、C#、PHP、JavaScript 以及任何 AI 编程助手能处理的语言。▍ Q4:是否会显著增加 Token 消耗?恰恰相反。MindStudio 等独立评测显示,Superpowers 通常会降低 Token 消耗。原因是:有了结构化流程,AI 不需要每次从头推理整套方法,可直接套用预定义模式,中间产出大幅减少。▍ Q5:不会 TDD 的人能用吗?可以,而且是学习 TDD 的极好方式。Superpowers 会一步一步引导你完成 RED-GREEN-REFACTOR 循环,并明确指出常见反模式,边用边学最有效。▍ Q6:多个技能会冲突吗?不会。技能设计为可组合(composable),AI 会自动协调多个技能同时生效。典型组合是 test-driven-development systematic-debugging using-git-worktrees 三者并用。▍ Q7:能在团队中统一规范吗?能。这正是 Personal Skills 的设计目的。团队可以维护一个私有 Skills 仓库,统一安装到每位成员的环境,实现工程文化的「代码化」分发。— · — · — · —八、写在最后Superpowers 的本质,是把一位资深工程师数十年的工作习惯,封装成可以「秒级安装」的 Markdown 文件。它告诉我们一个深刻的洞察:AI 编程助手当前最大的瓶颈,从来不是「智能」本身,而是「纪律」。当我们给一个聪明的实习生一份清晰的工作流程,他能做出令人惊叹的成果;反之,即使是天才,失去章法也只能产出脆弱的玩具。如果你正在用 AI 工具开发严肃项目、对代码质量有要求、希望团队保持工程标准——Superpowers 几乎是当下最值得引入的免费方案。它不需要切换模型、不需要付费订阅,只需要一条安装命令。作者 Jesse Vincent 在项目介绍中写道:「你的编程助手只是有了 Superpowers,而你什么都不用做。」愿你也能借此让 AI 真正成为团队中的高级工程师,而不仅仅是一个昂贵的自动补全。最常用的claude code、codex、cursor安装教程图示 项目地址GitHub:github.com/obra/superpowers官方文档:claude.com/plugins/superpowers—— 全文完 ——
Superpowers深度解析：让 AI 编程助手拥有「资深工程师」的方法论
Superpowers 深度解析让 AI 编程助手拥有「资深工程师」的方法论如果你曾用 AI 编程工具写过复杂项目,可能都遇到过这些问题:代码不完整、跳过测试、随手糊一套架构、调 Bug 全靠猜……Superpowers 正是为解决这些问题而生。它把数十年沉淀下来的软件工程方法论,以 Markdown 文件的形式注入到 AI 编程助手中,让其从「智能补全」蜕变为「资深开发者」。— · — · — · —一、什么是 SuperpowersSuperpowers 是由 Jesse Vincent(GitHub 用户名 obra)创建的一个开源「智能体技能框架」(Agentic Skills Framework),本质上是一套软件开发方法论。它通过向 AI 编程助手注入一系列结构化的「技能」(Skills),强制其遵循专业开发流程,而不是从零开始即兴发挥。自 2025 年 10 月发布以来,该项目在 GitHub 上已收获超过 17 万 Stars,并于 2026 年 1 月被纳入 Anthropic 官方插件市场。版本 5.0.7(2026 年 3 月)是目前的稳定版本。核心定位Superpowers 不是给 AI 增加新能力,而是为其增加「纪律」。Claude Code 本身已经具备规划、调试、重构等能力,Superpowers 的价值在于:把这些能力组织成有序的、可预测的、不可跳过的工作流。一句话概括: Superpowers 「方法论作为代码」(Methodology-as-Code),把资深工程师的工作习惯固化为机器可读的 Markdown 文件。支持的平台Superpowers 采用与平台无关的设计,同一套 skills/ 目录可在以下编程助手中使用:●Claude Code(原生支持,推荐)●Cursor IDE●OpenAI Codex CLI 与 Codex App●GitHub Copilot CLI●Gemini CLI(通过扩展)●OpenCode 开源框架●Factory Droid不论使用哪个平台,核心 Skills 文件保持一致,真正实现了「一次编写,处处运行」的工程文化。— · — · — · —二、Superpowers 的完整执行过程理解 Superpowers 的执行过程,是用好它的关键。整个流程分为「启动加载」与「任务执行」两大阶段。阶段一:会话启动与自动加载Superpowers 的魔法始于 AI 编程助手的启动时刻。当你打开 Claude Code 等支持的工具时,它会:1.自动注入 Session-Start Hook(会话启动钩子)2.Hook 体积极小,据官方数据小于 2000 tokens3.Hook 内容会强制 AI 优先读取 getting-started/SKILL.md4.getting-started 文件会告知 AI 何时调用哪个技能实际的 Hook 注入内容形如:You have Superpowers.**RIGHT NOW, go read**:/Users/jesse/.claude/plugins/cache/Superpowers/skills/getting-started/SKILL.md关键设计: Hook 本身不包含完整的方法论指令,而是一个「书签」。这种渐进式披露(Progressive Disclosure)设计避免了上下文窗口被无关内容污染。阶段二:任务执行的标准生命周期当你向 AI 发出一个编程任务后,Superpowers 会引导其按以下完整生命周期顺序推进:阶段技能调用产出物 / 行为①brainstorming(头脑风暴)AI 拒绝直接写代码,先用苏格拉底式提问澄清需求,产出经用户确认的设计文档②using-git-worktrees(分支隔离)创建独立的 Git Worktree 工作区,新建特性分支并验证基线测试③writing-plans(撰写计划)将设计拆解为 2-5 分钟可完成的微任务,标注文件路径与测试用例④subagent-driven-development派遣独立子智能体执行每个任务,父智能体只负责协调与验收⑤test-driven-development子智能体内部强制 RED-GREEN-REFACTOR 循环,先写失败测试再实现⑥requesting-code-review另一个全新的子智能体进行代码审查,对照计划与编码规范打分⑦verification-before-completion运行完整验证(测试、构建、Lint),确认所有标准达成⑧finishing-work(收尾)提供 PR 创建、本地合并、保留分支等结构化选项整个流程的核心理念可以用一个公式来表达:前期投入 10-20 分钟做头脑风暴和规划 → 实施阶段省下数小时的 Bug 修复与返工时间。社区数据显示,完整流程使整体开发速度提升 2-3 倍。— · — · — · —三、Superpowers 的触发逻辑Superpowers 最巧妙的设计,是它的「双轨触发机制」。技能既可以由 AI 根据上下文自动激活,也可以由用户通过显式命令调用。触发方式一:自动激活(Auto-Trigger)这是 Superpowers 最强大也最容易被忽视的能力。AI 会在每个任务开始前,主动扫描所有可用技能的 YAML frontmatter 元数据,匹配当前任务上下文:---name: brainstormingdescription: |You MUST use this before any creative work —creating features, building components,adding functionality, or modifying behavior.Explores user intent, requirements and designbefore implementation.---description 字段不是简单的说明文字,而是一段「触发指令」。一旦 AI 识别出当前任务命中描述,该技能将被强制激活,且不可绕过。▍ 自动触发的关键词模式各核心技能的触发关键词如下:技能名触发关键词与场景brainstorming创建功能、构建组件、添加新行为、修改业务逻辑等任何「创造性工作」test-driven-development实现新功能、编写业务代码,只要涉及「写代码」就必然触发systematic-debuggingBug、报错、修复、异常、问题排查等关键词出现时subagent-driven-development任务包含 2 个以上无共享状态、无顺序依赖的独立子任务时requesting-code-review收到代码审查反馈、需要决定是否采纳建议时verification-before-completionAI 即将声明「完成」「修好了」「实现了」之前触发方式二:斜杠命令显式调用当你需要明确控制流程,或希望从中间某一步开始时,可以使用斜杠命令直接调用技能:# 启动头脑风暴会话/brainstorming# 调用其它技能的通用语法/superpowers:brainstorm 用户认证系统/superpowers:write-plan 实现 OAuth2 登录/superpowers:execute-plan# 提醒 AI 它拥有 Superpowers(常用)/using-superpowers使用建议: 在新会话开始时输入 /using-superpowers,可以显式提醒 AI 当前会话应全程使用 Superpowers 方法论,这比依赖自动加载更可靠。触发方式三:Iron Law(铁律)与红旗清单每个 Superpowers 技能文件都有一个独特的结构:开头是大写的「Iron Law」(铁律),后面跟一张「Red Flags」(红旗)清单。▍ Iron Law 示例(TDD 技能)IRON LAW:NO PRODUCTION CODE WITHOUT A FAILING TEST.如果你发现自己在写实现代码而没有失败的测试,立即停止,删除代码,从测试开始。▍ Red Flags 红旗清单示例以下是 TDD 技能中明文列出的「危险信号」,一旦 AI 自己说出这些话就应该警觉:●「测试第一次运行就通过了」(说明你没真的 RED 过)●「我先实现,等下补测试」(等下永远不会来)●「我先保留这段代码作为参考」(不,删掉它)●「就这一次破例」(这是滑坡的开始)验证类技能(verification-before-completion)的红旗则包括:●「应该可以了」(should)●「大概没问题」(probably)●「看起来好了」(seems to)⚠ 重要: 这些不是激励海报式的口号,而是被编入指令的硬性检查项。一旦 AI 自己使用了这些词,它会被强制要求停下来重新验证,不允许声明完成。— · — · — · —四、14 个核心技能详细说明Superpowers 当前共内置 14 个核心技能,可大致分为四大类。下面逐一详细介绍每个技能的功能、触发场景与使用方法。4.1 设计与规划类技能▍ 1. brainstorming(头脑风暴)定位:所有创造性工作的强制前置步骤。功能详解:这是 Superpowers 中触发频率最高的技能。它拒绝让 AI 直接进入编码,而是通过苏格拉底式的多轮提问,先把模糊的需求打磨成可执行的设计文档。典型对话流程包括:●确认技术栈偏好(如 Next.js vs Vue vs Svelte)●拆分功能性与非功能性需求●探索边界情况(并发、错误处理、性能要求)●识别隐性假设并显式化●最后给出有理有据的技术推荐触发场景:任何「创建」「实现」「构建」「设计」「添加」类指令。产出:一份用户已签字确认的设计文档(spec)。▍ 2. writing-plans(撰写实施计划)定位:把设计文档转化为可执行的「微任务清单」。功能详解:针对已确认的设计,该技能会生成一份极其详尽的实施计划,任务粒度控制在 2-5 分钟内可完成。每个任务都包含:●精确的文件路径●待新增或修改的函数/类名●对应的测试用例描述●依赖关系标注●验证命令(如 npm test、构建命令)一份典型的计划可能长达 500 行,但每一行都清晰可执行,即便交给一个「热情但缺乏判断力的初级工程师」也能照着完成。Spec Self-Review: 5.0 版本新增了「计划自审清单」,会在生成计划后用约 30 秒自查,通常可发现 4-5 个潜在 Bug。▍ 3. using-git-worktrees(Git Worktree 分支隔离)定位:为每个新任务创建独立的物理工作区。功能详解:该技能调用 Git 的 worktree 功能,为每个特性分支创建独立的目录。这样做的好处包括:●主分支不被未完成的工作污染●可同时进行多个并行实验●失败的尝试可整体丢弃,无需复杂的回滚●基线测试在干净环境下运行,避免污染触发时机:设计文档已确认,即将进入编码阶段。4.2 实施与测试类技能▍ 4. test-driven-development(测试驱动开发)定位:Superpowers 的灵魂技能,强制执行 RED-GREEN-REFACTOR 循环。功能详解:这是 Superpowers 区别于其他 AI 编程工具的最显著特征。它严格执行经典 TDD 三步循环: RED先写一个会失败的测试。如果第一次就通过,说明测试本身有问题,必须重写。 GREEN写最少量的实现代码让测试通过,不追求完美,只求能跑过。 REFACTOR在测试保护下重构代码结构,优化命名、消除重复,但不增加新功能。关键纪律点:「先实现,后补测试」的做法被明确禁止。如果 AI 不小心先写了实现,它的 Iron Law 会要求其删除已写代码,从测试开始。配套原则:同时强调 YAGNI(你不会需要它,不要过度设计)与 DRY(避免重复代码)。▍ 5. condition-based-waiting(基于条件的等待)定位:处理异步操作与时间相关的测试场景。功能详解:测试异步代码时,新手常用 sleep(N) 来等待操作完成。这种做法既慢又不可靠。该技能强制使用「轮询条件」模式:// ❌ 错误做法await sleep(2000); // 祈祷 2 秒够用assert(condition);// ✅ 正确做法await waitFor(() condition true,{ timeout: 5000, interval: 50 });通过持续轮询条件状态,既能立即响应,又能在异常情况下提供明确的超时报错。▍ 6. subagent-driven-development(子智能体驱动开发)定位:利用并行子智能体,实现快速迭代与隔离审查。功能详解:对于复杂任务,父智能体不亲自写代码,而是为每个微任务派遣一个全新的子智能体。每个子智能体只看到:●当前任务的描述与上下文●对应的测试用例●相关的代码文件这种「上下文隔离」设计有三大好处:5.避免子智能体被无关历史污染,保持判断力清晰6.可并行处理多个独立任务,大幅提速7.便于事后审查,每个任务的「上下文」可独立追溯5.0 版本优化: 原先的子智能体审查环节已被「内联自审」取代,执行时间从约 25 分钟缩短到几分钟。▍ 7. parallel-task-execution(并行任务执行)定位:识别可并行的独立任务并发执行。功能详解:与 subagent-driven-development 配合使用。当遇到 2 个或以上无共享状态、无顺序依赖的任务时,自动启动并行执行:●分析任务间的数据依赖图●识别可并发的独立分支●派遣多个子智能体并发工作●最后聚合结果并验证4.3 调试与验证类技能▍ 8. systematic-debugging(系统化调试)定位:用四阶段方法论根除 Bug,而不是「乱试一通」。功能详解:面对 Bug,该技能强制按以下四阶段推进,严禁跳步:阶段名称具体动作①Reproduce(复现)先稳定地复现问题,写一个失败的最小测试用例②Isolate(隔离)用二分法、日志或断点缩小问题范围,找到出错的最小代码片段③Identify(根因)找到真正的根本原因,而不是表面症状④Verify(验证)修复后重跑复现测试,确认 Bug 真正消失⚠ 关键防线: 如果连续 3 次修复尝试都失败,该技能会触发「架构审查」,强制 AI 后退一步,质疑当前的整体设计假设,而不是继续打补丁。▍ 9. root-cause-tracing(根因追踪)定位:深度追溯依赖链,找出级联故障的源头。功能详解:适用于跨多个组件、多个模块的复杂故障。该技能教 AI 沿着调用栈与数据流向反向追溯,绘制完整的依赖图,理解每一层组件的交互方式,而不是停留在表层报错信息。▍ 10. defense-in-depth(纵深防御)定位:为关键路径设置多层验证。功能详解:对于生产代码、关键 API 端点、支付逻辑等高风险场景,单层校验不够,需要在多个层次设防:●输入层校验(用户输入)●业务逻辑层校验(权限、状态)●数据访问层校验(持久化前后)●错误处理与降级策略▍ 11. verification-before-completion(完成前验证)定位:严防 AI 滥用「我觉得修好了」式表态。功能详解:这是一个极其重要的「最后防线」技能。在 AI 准备宣称任务完成前,必须执行:8.运行完整测试套件(不只是新增的测试)9.执行构建命令,确认无编译错误10.运行代码风格检查(Lint)11.验证所有原始需求都已实现12.确认没有引入新的警告或弃用提示只有以上所有项都通过,AI 才被允许使用「完成」「修好」等确定性表述。4.4 协作与元技能类▍ 12. requesting-code-review(代码审查请求)定位:启动结构化代码审查流程。功能详解:当一个主要任务完成后,该技能会派遣一个全新的子智能体进行代码审查。审查分两阶段:●Spec Compliance(规范符合性):对照原始计划与设计,验证所有需求是否都已实现●Code Quality(代码质量):对照编码规范,检查命名、结构、可读性、测试覆盖等审查智能体使用全新上下文,避免「自己审查自己」的盲点。▍ 13. responding-to-code-review(回应代码审查)定位:用工程师的严谨态度,而非讨好,回应审查意见。功能详解:这个技能解决一个真实问题——AI 太容易屈从于审查意见,即使审查者本身可能搞错了。该技能强调:●先理解审查意见的技术背景●如果意见不清,主动追问而非猜测●如果意见有误,基于事实礼貌地反驳●严禁「表演式认同」(performative agreement)技术正确性优先于人际和谐——这是 Superpowers 反复强调的态度。AI 应当像一个有职业素养的工程师,而不是讨好的助手。▍ 14. finishing-work(收尾工作)定位:结构化地完成开发周期的最后一公里。功能详解:所有实现完成、所有测试通过、所有审查回应后,该技能会向用户呈现三个选项:13.创建 GitHub Pull Request(默认提供模板)14.本地直接合并 Worktree 回主分支15.保留当前分支,暂停工作不论选择哪个,AI 都会自动清理工作区状态、整理 Commit 历史、生成变更说明。— · — · — · —五、安装与使用指南Claude Code 安装(推荐方式)Claude Code 2.0.13 及以上版本支持插件市场,安装最为简便。第一步:启动 Claude Code,在命令行中输入:/plugin marketplace add obra/superpowers-marketplace第二步:安装插件:/plugin install superpowerssuperpowers-marketplace或使用 Anthropic 官方市场:/plugin install superpowersclaude-plugins-official第三步:退出并重启 Claude Code。重启后你会看到 Hook 自动注入提示。第四步:验证安装。输入 /help 并切换到 custom-commands 标签,应能看到 brainstorming、write-plan、execute-plan 等命令。其他平台安装Cursor IDE:在 Cursor 设置中打开插件市场,搜索 superpowers 并安装。需要使用 camelCase 风格的 hooks(5.0 版本后已支持)。GitHub Copilot CLI:copilot plugin marketplace add nguyenducviet4/superpowerscopilot plugin install superpowerssuperpowersOpenAI Codex CLI:通过官方 Codex 插件市场安装,搜索 superpowers 并 Install Plugin。Gemini CLI、OpenCode:参照官方 GitHub 仓库 obra/superpowers 中的对应说明。日常使用建议▍ 会话开始时打开一个新项目后,建议先输入:/using-superpowers这会显式提醒 AI:本次会话全程使用 Superpowers 方法论。这比依赖自动加载更可靠,尤其在长会话中。▍ 启动复杂功能开发不要直接说「帮我写一个 X」,而是说:我想开发一个项目管理工具,主要功能是看板、任务分配、评论与通知。请使用 superpowers 方法论,先从 brainstorming 开始。这样 AI 会完整走完头脑风暴 → 设计 → 计划 → 实施 → 审查的全流程。▍ 处理棘手 Bug遇到难以复现或定位的 Bug 时:/superpowers:systematic-debugging问题描述:- 现象:用户偶发性看到 500 错误- 触发条件:不规律,无法稳定复现- 影响范围:约 5% 的请求AI 会按四阶段方法论一步步推进,而不是凭直觉乱猜。自定义个人技能Superpowers 采用两层技能架构:●Core Skills(核心技能):由官方仓库维护,所有用户共享●Personal Skills(个人技能):存放于 ~/.config/superpowers/skills/,可自由扩展你可以为自己团队的特定技术栈、架构规范或业务领域编写专属技能。例如:●公司内部的命名规范●特定框架的最佳实践(如 Rails、Spring Boot)●行业合规要求(如金融行业的审计日志)最强大的玩法是:你可以把一本技术书的内容喂给 Claude,让它阅读、内化,并自动生成对应的新技能文件。— · — · — · —六、什么场景适合用 Superpowers非常适合的场景●有清晰架构要求的复杂项目(微服务、SaaS、企业级应用)●对可靠性、零停机有要求的关键业务系统●遵循敏捷或 TDD 方法论的团队,希望维持工程标准●面向客户或商用产品的专业级开发●需求模糊、需要先做需求挖掘的项目●有测试覆盖率要求的遗留代码重构可能不适合的场景●一次性脚本或玩具项目(开销大于收益)●纯探索性 Demo,只为验证想法可行性●已有非常成熟流程、不希望引入新工作方式的团队●对响应时间极敏感的紧急 Hotfix学习成本: 首次使用需要 1-2 个完整项目周期来熟悉多阶段工作流。一旦上手,后续效率提升明显。— · — · — · —七、常见问题答疑▍ Q1:Superpowers 是 Anthropic 官方出品吗?不是。Superpowers 是由 Jesse Vincent 等社区开发者维护的开源项目,采用 MIT 许可证。但自 2026 年 1 月起,它已被 Anthropic 官方插件市场收录,代表了一定程度的官方认可。▍ Q2:使用 Superpowers 是否完全免费?插件本身完全免费,开源 MIT 协议。但你仍需为底层 AI 模型(如 Claude API)的使用付费,这部分按 Anthropic 标准定价。▍ Q3:支持哪些编程语言?Superpowers 与编程语言无关。它的方法论(TDD、调试、规划)是通用的,可应用于 Python、Go、Rust、Java、C#、PHP、JavaScript 以及任何 AI 编程助手能处理的语言。▍ Q4:是否会显著增加 Token 消耗?恰恰相反。MindStudio 等独立评测显示,Superpowers 通常会降低 Token 消耗。原因是:有了结构化流程,AI 不需要每次从头推理整套方法,可直接套用预定义模式,中间产出大幅减少。▍ Q5:不会 TDD 的人能用吗?可以,而且是学习 TDD 的极好方式。Superpowers 会一步一步引导你完成 RED-GREEN-REFACTOR 循环,并明确指出常见反模式,边用边学最有效。▍ Q6:多个技能会冲突吗?不会。技能设计为可组合(composable),AI 会自动协调多个技能同时生效。典型组合是 test-driven-development systematic-debugging using-git-worktrees 三者并用。▍ Q7:能在团队中统一规范吗?能。这正是 Personal Skills 的设计目的。团队可以维护一个私有 Skills 仓库,统一安装到每位成员的环境,实现工程文化的「代码化」分发。— · — · — · —八、写在最后Superpowers 的本质,是把一位资深工程师数十年的工作习惯,封装成可以「秒级安装」的 Markdown 文件。它告诉我们一个深刻的洞察:AI 编程助手当前最大的瓶颈,从来不是「智能」本身,而是「纪律」。当我们给一个聪明的实习生一份清晰的工作流程,他能做出令人惊叹的成果;反之,即使是天才,失去章法也只能产出脆弱的玩具。如果你正在用 AI 工具开发严肃项目、对代码质量有要求、希望团队保持工程标准——Superpowers 几乎是当下最值得引入的免费方案。它不需要切换模型、不需要付费订阅,只需要一条安装命令。作者 Jesse Vincent 在项目介绍中写道:「你的编程助手只是有了 Superpowers,而你什么都不用做。」愿你也能借此让 AI 真正成为团队中的高级工程师,而不仅仅是一个昂贵的自动补全。最常用的claude code、codex、cursor安装教程图示 项目地址GitHub:github.com/obra/superpowers官方文档:claude.com/plugins/superpowers—— 全文完 ——
