superpowers 是什么?

Superpowers(作者 obra/Jesse Vincent)是一套面向编码代理的「完整软件开发方法论」,建立在一组可组合的技能(skills)与一份让代理自动用上它们的初始指令之上。它的核心理念是:代理不该一上来就写代码,而应先退一步问清你到底要做什么、把规格分成可读的小块给你确认,再产出一份「连没经验、没判断力、不爱测试的初级工程师都能照着做」的实现计划(强调红/绿 TDD、YAGNI、DRY),随后进入「子代理驱动开发」——多个子代理逐个完成工程任务、互相检查与评审、持续推进,Claude 常能连续自主工作数小时而不偏离计划。技能自动触发,你无需特别操作。Shell、MIT、约 20.3 万星,是该方向星标最高的项目。

⭐ 164,590 Stars 🍴 14,401 Forks Shell 作者: obra
来源:README 顶部/How it works、GitHub meta(obra/superpowers,Shell,MIT) 查看 GitHub 仓库 →

为什么值得关注

编码代理强但常「想都不想就开写」,缺乏纪律的规格、计划与测试。Superpowers 把一整套软件开发方法论(澄清需求→分块确认规格→TDD/YAGNI/DRY 的实现计划→子代理驱动开发与评审)做成自动触发的技能,让代理像有经验的团队一样推进、还能长时间自主工作。它在 Anthropic 官方插件市场上架、跨多种 harness、由资深开发者维护、口碑极佳,星标高达约 20.3 万,是 Claude Code 技能/方法论生态里最受欢迎的项目。

来源:README How it works/Installation、GitHub meta(stars 203532、created_at 2025-10-09、pushed_at 2026-05-21)

核心功能

需求澄清与分块规格

代理在你开始构建时先退一步问清「你真正想做什么」,把从对话中梳理出的规格按足够短、能读完的小块展示给你逐段确认,避免一上来就乱写。

来源:README How it works(前两段)
纪律化的实现计划(TDD/YAGNI/DRY)

你确认设计后,代理产出一份足够清晰、连「热情但没判断、不爱测试的初级工程师」都能照做的实现计划,强调真正的红/绿 TDD、YAGNI(不做用不到的)、DRY。

来源:README How it works(实现计划段)
子代理驱动开发与评审

你说「go」后启动「子代理驱动开发」:让子代理逐个完成工程任务、检查与评审其工作、持续推进;Claude 常能连续自主工作数小时而不偏离既定计划。

来源:README How it works(subagent-driven-development 段)
自动触发、跨多 harness 安装

技能自动触发,无需特别操作。可经 Anthropic 官方插件市场装到 Claude Code,也支持 Codex CLI/App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI 等,各 harness 分别安装。仓库含 14 个技能。

来源:README Quickstart/Installation、仓库 skills/(14 个 SKILL.md)与各 .*-plugin 目录

技术架构

Superpowers 以一组可组合技能 + 让代理自动调用它们的初始指令为核心。仓库 skills/ 下含 14 个技能(每个一份 SKILL.md,覆盖需求澄清、规格、计划、TDD、子代理开发等方法论环节),hooks/ 提供让技能自动触发的钩子,scripts/ 为脚本,docs/ 文档。它为多 harness 做了适配:.claude-plugin、.codex-plugin、.cursor-plugin、.opencode 等目录与对应市场/扩展机制。技能本质是可移植指令文件,由宿主代理加载——一旦代理察觉你在构建东西,初始指令与自动触发机制就引导它走「澄清→分块规格→TDD 实现计划→子代理驱动开发与评审」的流程。安装走 Anthropic 官方插件市场(claude-plugins-official)、obra 自有市场,或各 harness 的插件/扩展命令。

来源:README How it works/Installation、仓库目录树(skills/hooks/scripts/docs、各 plugin 目录)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 宿主代理:Claude Code/Codex/Factory Droid/Gemini CLI/OpenCode/Cursor/Copilot CLI宿主代理:Claud… Anthropic 官方插件市场 + obra 自有市场Anthropic 官方… hooks(技能自动触发)hooks(技能自动… 需求澄清与分块规格 纪律化的实现计划(TDD/YAGNI/DRY)纪律化的实现计划(TDD… 子代理驱动开发与评审 自动触发、跨多 harness 安装自动触发、跨多 harnes… superpowers 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown 技能定义(SKILL.md)+ Shell(钩子/脚本)框架Agent Skills + 软件开发方法论(可组合技能 + 自动触发)
宿主代理:Claude Code/Codex/Factory Droid…Anthropic 官方插件市场 + obra 自有市场hooks(技能自动触发)
纯仓库分发,无服务端;经各 harness 的插件市场/扩展机制安装,技能自动触发
来源:README Installation、仓库 skills/hooks 与各 plugin 目录

快速上手

按你的 harness 分别安装。Claude Code:经 Anthropic 官方市场 `/plugin install superpowers@claude-plugins-official`,或注册 obra 市场 `/plugin marketplace add obra/superpowers-marketplace` 后 `/plugin install superpowers@superpowers-marketplace`。Codex CLI:`/plugins` 搜 superpowers 安装;Codex App 在 Plugins 侧栏点 + 安装。Factory Droid:`droid plugin marketplace add https://github.com/obra/superpowers` 后 `droid plugin install superpowers@superpowers`。Gemini CLI:`gemini extensions install https://github.com/obra/superpowers`。OpenCode/Cursor/Copilot CLI 各有对应安装方式。装好后无需特别操作——你一开始构建,技能就自动引导代理走澄清需求、分块规格、TDD 计划、子代理开发的流程。
来源:README Quickstart/Installation 各 harness 段

使用场景

适合用 Claude Code/Codex/Cursor 等做实际软件开发、又希望代理「有纪律」的人:让代理在动手前澄清需求、把规格分块给你确认、按 TDD/YAGNI/DRY 出可执行计划,再用子代理驱动开发与评审长时间自主推进,减少跑偏与返工。对想给团队/个人工作流引入一套久经打磨的 agent 开发方法论的人尤其合适,也是学习「如何用可组合技能 + 自动触发把方法论装进代理」的范例。

来源:README How it works/顶部

优势与局限

优势

  • 不是堆技能而是给方法论:澄清→分块规格→TDD 计划→子代理开发与评审,让代理像有经验的团队一样有纪律地推进。
  • 自动触发、零额外操作:技能自动生效,代理察觉构建意图即引导流程,能长时间自主工作。
  • 覆盖广、安装权威:Anthropic 官方市场上架,跨 Claude Code/Codex/Gemini/Cursor 等多 harness,MIT 开源。
  • 口碑与人气极高(约 20.3 万星),由资深开发者维护、持续迭代。

局限

  • 效果是方法论/提示层引导,最终质量仍取决于底层模型与任务,复杂项目仍需人把关关键决策。
  • 强流程化对小改动或探索性任务可能显得重,偏好轻量的人需适应。
  • 强绑定各 harness 的技能/插件机制,且需按每个 harness 分别安装。
  • 子代理长时间自主开发会放大 token 消耗,需关注成本与产出审阅。
来源:README How it works/Installation、技能为指令文件的本质

最新版本

项目以技能/插件形式分发,已上架 Anthropic 官方插件市场,并支持 Codex、Factory Droid、Gemini CLI、OpenCode、Cursor、Copilot CLI 等多 harness。当前含 14 个技能,覆盖需求澄清、规格、TDD 计划与子代理驱动开发等方法论环节,技能自动触发。MIT 开源、约 20.3 万星。仓库最近一次更新在 2026-05-21。

来源:README Installation/How it works、GitHub meta pushed_at 2026-05-21、created_at 2025-10-09

总结评价

Superpowers 是 Claude Code 生态里最受欢迎、也最有方法论分量的技能框架(约 20.3 万星):它不只给代理加技能,而是给它一整套有纪律的软件开发方法——先澄清需求、分块确认规格、按 TDD/YAGNI/DRY 出计划,再用子代理驱动开发与评审长时间自主推进,且技能自动触发、零额外操作。对认真用代理做开发、苦于其「想都不想就开写」的人,它能显著提升产出的条理与质量,已上架 Anthropic 官方市场、跨多 harness、口碑极佳。要理解它是方法论/提示层引导(效果随模型而定、关键决策仍需人把关)、强流程对小任务偏重、需按 harness 分别装且会放大 token 成本。作为「给编码代理装上一套靠谱开发方法论」的框架,它几乎是标杆。

来源:综合 README、How it works、Installation 与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 20:50. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件