Superpowers
Agentic skills framework — 为 coding agent 注入工程纪律的完整 SDLC 工作流，composable skills + auto-triggering，覆盖 Claude Code、Codex、Cursor、OpenCode、Kimi、Pi 等多种 harness。
状态:
active· 总分: 3.3/5 · 推荐度: 3/5
一句话总结
Superpowers 是一套把「软件工程纪律」编码为 agent skill 的框架——brainstorm → spec → plan → TDD → subagent-driven dev → review → ship，全链路流程由 skill 自动触发，而非靠 agent 自觉遵守。适合希望 agent 像 senior engineer 一样工作的开发者，不适合快速原型或一次性的简单任务。
总体评价
Superpowers 是一个高可见度的 agentic skills 框架。它的核心创新在于 auto-triggering：技能不是用户手动调用的命令，而是 agent 根据上下文自动激活的强制工作流。设计哲学上把 AI agent 视为「能力强但缺乏纪律的初级工程师」，用硬性流程关卡（brainstorming 的「无 spec 不写代码」、TDD 的「先写测试再写实现」、debugging 的「无根因不修 bug」）来弥补 agent 天然的随意性 [Docs]。
258.7k stars 是极高的点时可见度信号，但不能直接解释为生产采用或真实质量证明。v6.0 把每任务的两个 reviewer 改为一个 reviewer 同时给出 spec/quality verdict，并调整 worktree 与 review-package 流程；v6.1 又加入 Codex marketplace、移除 Codex SessionStart hook，并因上游 EOL 移除 Gemini CLI。项目仍不到一年且行为持续变动；截至 2026-07-22 有 159 个 open issues 和 166 个 open PRs [GH][GH:release]。
如果你已用 Claude Code 或 Codex 做日常开发，Superpowers 值得在隔离项目中认真试用；官方 marketplace 路径比 6 月更完整，但跨 harness 行为仍不能视作同质。核心方法论的价值高于当前版本稳定性。
推荐度：3/5
2026-07 复核：v6 改善 Codex 安装与 review 成本，但项目仍年轻、breaking changes 频繁，高权限 hooks/subagents 未独立运行验证。
角色定位：面向使用 coding agent（Claude Code、Codex、Cursor 等）进行中等复杂度以上项目开发，希望 agent 遵循严谨工程流程（TDD、spec-first、正式 review）的开发者。
推荐理由：
- 方法论扎实——TDD、root-cause debugging、subagent code review 是通行工程实践；Superpowers 将它们写成 agent 不可跳过的流程步骤 [Docs]
- 跨平台设计——同一套 skill markdown 文件覆盖 Claude Code、Codex、Cursor、OpenCode、Kimi、Pi、Copilot 等 harness；但 v6.1 移除 Gemini 也表明上游生命周期会直接改变支持矩阵 [Docs][GH:release]
- 社区可见度——258.7k stars 是点时可见度信号；README 中关于长时间自主工作等效果仍是项目方描述，本条未独立复现实测 [Docs][GH]
主要顾虑：
- 不到一年历史，版本迭代带有 breaking changes（slash command 废弃、review loop 替换），长期稳定性待观察
- 平台体验不均——Claude Code 得到最深度集成，其他平台受限于各自 agent 的能力边界
- 159 open issues / 166 open PRs 对于年轻项目仍是较高维护负载；历史样本曾涉及 worktree 数据损坏、subagent HEAD 游离等实质性问题，本条不声明这些旧 issue 当前仍未修复 [GH][GH:issues]
- Token 消耗不小——subagent-driven development 的 full review loop 在 Codex 上有过消耗 5h token 预算的 issue 报告；本条未复测当前版本 token 消耗（#1152 [GH:issues]）
结论：如果你在 Claude Code 上做 TDD 式中大型项目，可以谨慎试用；如果在 Codex/其他平台，可以关注但预期体验有折扣。对快速原型/一次性脚本场景过度设计，不适合。
优势
- Auto-triggering 机制——技能根据上下文自动激活，不需要用户记住命令或手动调用。这是 Superpowers 区别于 Spec Kit（slash command 驱动）最本质的设计差异。
- 完整 SDLC 覆盖——从 brainstorming 到 finishing-a-development-branch，7 步工作流覆盖整个开发生命周期，每个步骤有明确的 gate condition 防止 agent 走捷径。
- TDD 流程——test-driven-development 技能要求 RED-GREEN-REFACTOR 循环，强制 agent 先写失败测试再写实现；chardet 案例按文档/第三方资料作为参考，不作为本条实测证据 [Docs]。
- Subagent 架构——v6 仍采用 fresh implementer context，但每任务改为一个 reviewer 一次读取 diff、同时返回 spec 与 quality verdict，最后再做一次 whole-branch review；这是 release notes 所述设计面，本条未实测质量或成本收益 [GH:release]。
- 维护者背景——Jesse Vincent 的公开工程履历可解释项目方法论来源，但本条不据此推断当前维护响应速度或生产质量。
- 社区可见度——GitHub stars / forks 是高可见度信号；Discord 活跃度、生态广度和维护者响应速度本轮未重新核验，不能据此推断生产采用。
- MIT 许可 + 纯 Markdown 技能格式——零厂商锁定，技能可以 fork/定制/跨平台迁移。
劣势
- 仍不到一年的项目——2025 年 10 月创建，版本号已到 v6.1.1；v6 重写 review/worktree 路径，v6.1 又改 Codex hook 与支持矩阵。追求最新版的用户需要持续跟进 release notes [GH][GH:release]。
- Claude Code 偏倚——README/文档侧重 Claude Code 体验，其他平台体验可能打折扣。旧 issue 曾报告 OpenCode 上 skill 工具函数缺失（#1492 [GH:issues]），这类平台差异仍需复核当前版本。
- Worktree 依赖——using-git-worktrees 是核心工作流步骤；旧 issue 曾报告过 repo/worktree 相关故障（#1546 [GH:issues]），在其他平台上实现程度不一。
- 重流程，轻上下文——完整的 7 步工作流对于小修改/小项目是明显过度工程。框架没有内建的「轻量模式」或按场景自动降级的设计。
- 文档分散——主要文档在 README 和内联 skill 文件里，没有独立文档站点。对非 Claude Code 平台的安装和使用说明不够详尽。
- Token 成本——subagent-driven development 的 full review loop 在复杂 plan 上 token 消耗可观；旧 issue #1152 报告过完整 5h token 预算被单次运行耗尽，本条未复测当前版本 [GH:issues]。
- 自动注入与遥测边界——部分 harness 仍通过 SessionStart/extension 注入 bootstrap；Codex v6.1 已转为 native skill discovery、显式空 hooks。README 还披露 optional visual companion 会从项目网站加载带版本号的 logo，可用环境变量关闭；这些都是采用前应明确的透明性边界 [Docs][GH:release]。
适合什么场景
- 使用 Claude Code 做中大型项目的日常开发
- 希望 agent 强制遵循 TDD 和 spec-first 流程
- 需要 agent 自主工作数小时不偏离计划的复杂任务
- 多 agent 平台环境，想用统一方法论管理
- 学习 agentic SDLC 方法论——即使不完全采纳，workflow 设计本身有学习价值
不适合什么场景
- 快速原型、一次性脚本、探索性 coding——7 步工作流是过度负担
- 小项目/简单修改——相对于工作量，流程开销不成比例
- 需要所有 harness 行为完全一致的团队——安装、hook、subagent/task 工具能力仍按平台不同
- 对 token 成本极度敏感的场景——subagent review loop 有不可忽视的消耗
- 不想频繁跟进 breaking changes 的稳定型团队——项目仍在快速演进期
与类似项目对比
| 项目 | 定位 | 相对本项目 |
|---|---|---|
| github/spec-kit | Spec-Driven Development 工具包，slash command 驱动 | 定位不同：Spec Kit 更偏 artifact-centric（spec 是持久产物），Superpowers 更偏 process-centric（流程是核心）与 auto-triggering；两者可以互补而非替代。 |
| Claude Code 内置 skills | Claude Code 自带的基础技能 | Superpowers 额外文档化 brainstorming/planning/subagent workflow 等流程；是否替代内置 skills 取决于使用场景。 |
| OpenCode built-in skills | OpenCode 内置技能系统 | 与 Claude Code 类似，基础功能。Superpowers 的 OpenCode 支持曾有 issue 报告（#1492 [GH:issues]），当前版本需复核。 |
| Cursor Rules | Cursor 的指令注入机制 | Cursor Rules 更偏 instruction 注入；Superpowers 更偏可迁移 workflow/skill 文档。 |
| goose / auggie 内置 workflow | 各平台自带的开发辅助 | 各平台 workflow 与 Superpowers 的跨平台 skill 文件定位不同；本条不评价谁更优。 |
它能做什么
14 个 composable skill，分四个类别 [Docs]：
| 类别 | 技能 | 核心功能 |
|---|---|---|
| Testing | test-driven-development | RED-GREEN-REFACTOR 循环，写入反模式参考 |
| Debugging | systematic-debugging | 4 阶段根因追溯（调查→假设→修复→验证） |
| verification-before-completion | 确认修复确实生效 | |
| Collaboration | brainstorming | Socratic 式设计精化，产出 spec 文档 |
| writing-plans | 将设计拆分为 2-5 分钟的可执行任务，含精确文件路径和验证步骤 | |
| executing-plans | 批量执行 plan，人类检查点介入 | |
| dispatching-parallel-agents | 并行 subagent 工作流 | |
| subagent-driven-development | 逐任务分派 fresh implementer；单 reviewer 返回 spec/quality 双 verdict，末尾 whole-branch review | |
| requesting-code-review | Pre-review checklist，severity-based issue tracking | |
| receiving-code-review | 如何处理 review 反馈 | |
| using-git-worktrees | 隔离分支 workspace，验证 test baseline | |
| finishing-a-development-branch | merge/PR/keep/discard 决策 + 清理 | |
| Meta | writing-skills | 按最佳实践创建新 skill，含测试方法论 |
| using-superpowers | 技能系统入门指南 |
当前 README quickstart 支持面 [Docs]：Claude Code、Antigravity、Codex App/CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。Gemini CLI 已在 v6.1 release notes 中因上游 EOL 移除 [GH:release]。
能力评分 4/5。覆盖完整 SDLC 和多 harness 分发，但各平台对 hooks、subagents、task list 的实现不同，且没有 built-in CI/CD 集成；广度不能代替端到端稳定性验证 [Docs][GH:release]。
运行环境与资源占用
| 场景 | CPU | 内存 | 存储 | 说明 |
|---|---|---|---|---|
| 最小 | N/A | N/A | < 5 MB | 仅安装 skill 文件，本地文件系统 |
- 运行时：无持久服务——Superpowers 是一组 markdown 文件 + shell script hooks + JS plugin manifests。实际运行由 agent（Claude Code / Codex 等）驱动
- 操作系统：macOS / Linux / Windows（WSL），取决于目标 agent 的平台支持
- Docker：无
- GPU：不需要
- 外部依赖：git（worktree 功能需要 Git ≥ 2.5）+ 至少一个支持的 coding agent + 该 agent 的 API 额度
评分 4/5。作为纯 markdown + 少量 shell/JS 的框架，自身资源占用极低（< 5 MB 磁盘）。但框架的 subagent 编排设计会显著增加 agent 运行时的 token 消耗；旧 issue #1152 报告过 5h 预算被单次运行耗尽，本条未复测当前版本 [GH:issues]。
上手体验
安装难度因平台而异 [Docs]：
- Claude Code（最佳）：
/plugin install superpowers@claude-plugins-official，一键安装，即刻生效 - Cursor：
/add-plugin superpowers，同样简单 - Codex CLI/App：v6.1 已进入官方 Codex plugin marketplace；CLI 可用
/plugins搜索并安装 [Docs][GH:release] - OpenCode：类似 Codex；旧 issue 曾报告 skill 函数缺失问题（#1492 [GH:issues]），当前版本需复核
- Kimi / Pi / Antigravity：当前 README 分别给出 marketplace、
pi install与agy plugin install路径；能力仍取决于各 harness 的原生 skill/subagent 支持 [Docs]
初次体验：开始新 session 后说 "help me plan this feature"，如果安装正确，agent 会宣布正在使用哪个 skill 并进入格式化流程。但第一次遇到完整的 brainstorming → plan → review 链路时，流程感可能令人不适应——从「直接写代码」到「先回答 5 个 Socratic 问题」的切换需要心理准备。
评分 3/5。Claude Code 上接近 4，但其他平台拉低了平均值。安装方式不统一，非 Claude Code 平台缺乏充分的故障排查文档。
代码质量
当前 tree/API 语言快照以 Shell 和 JavaScript 为主，另有少量 TypeScript、HTML、Python 与 Batchfile；这是字节分布，不等于模块质量 [GH:local-scan]。
项目结构清晰：skills/ 目录每个 skill 有独立文件夹，内含 SKILL.md + references/ + templates/ 等子目录。docs/ 下有测试文档和平台特定 README。
静态 tree scan 识别到 52 个 test-ish 文件，但没有 GitHub Actions workflow；README 指向外置 superpowers-evals 做 skill-behavior eval，仓库内 tests 更偏 plugin infrastructure。本轮没有执行这些测试，不能把文件数当作覆盖率 [GH:local-scan][Docs]。
但关注点：
- Shell 是最大语言面，跨平台 hook/install 脚本仍有可移植性维护成本
- 159 open issues / 166 open PRs 对不到一年历史的项目显示较高维护负载；旧 issue 中有严重性较高的 bug 报告，本条不声明这些问题当前仍可复现 [GH][GH:issues]
- 快速迭代节奏意味着 regression 风险——版本间行为变更需要用户主动跟进 release notes
评分 3/5。结构与静态测试资产可见，但本轮没有执行仓库测试或外置 eval，不能判断覆盖率与跨平台通过情况；Shell-heavy 适配层、快速变更和较高 issue/PR backlog 使维护风险仍需保守估计 [GH:local-scan][GH]。
可扩展性
Superpowers 的 extensibility 是其设计核心之一 [Docs]：
- writing-skills——完整的 skill 创作工作流：定义技能边界、编写 SKILL.md（含 trigger description、instructions、pitfalls）、创建 references/templates/assets、编写测试（test-first，测试先于 skill 实现）
- SKILL.md 标准格式——纯 markdown + YAML frontmatter，任何人都可以创建新 skill 或 fork 现有 skill。不锁定特定 agent 平台
- 市场分发——Claude Code 有官方 + 社区 marketplace；Codex / Copilot 有各自的 marketplace；社区贡献路径清晰
- 平台适配层——不同 harness 使用 plugin、extension、marketplace 或 native skill discovery；是否有 SessionStart hook 取决于平台，Codex v6.1 已明确移除该 hook [Docs][GH:release]
但局限：
- skill 之间的组合/编排逻辑主要由 agent 自动决定，创作者对触发顺序的控制力有限
- 没有 skill 依赖声明机制——如果 skill A 依赖 skill B 的产出，无法在 SKILL.md 中形式化表达
评分 4/5。完全开放、跨平台、skill-first 的设计哲学，创作工具链完整（writing-skills + SKILL.md + 市场分发）。扣 1 分主要因为 skill 依赖声明机制缺失、触发顺序控制依赖 agent 自动判断——创作者的编排能力有限。
文档质量
主文档 README 现在覆盖 9 类 harness family 的安装、7 步工作流、技能库、贡献与遥测说明；RELEASE-NOTES 对 v6 的 review/worktree/Codex 迁移写得较具体 [Docs][GH:release]。
docs/ 下有 testing.md（集成测试说明）、各平台特定 README（codex、opencode、windows），以及 plans/ 和 superpowers/ 子目录。
不足：
- 没有独立文档站点——所有文档散落在 repo 内
- 非 Claude Code 平台的安装/故障排查文档较薄弱
- 技能行为细节大量内联在 SKILL.md 文件中而非集中文档——要理解一个 skill 的完整行为，需要直接读其 markdown 文件
- 版本化站点仍缺失；用户必须同时读 README、RELEASE-NOTES 和内联 SKILL.md 才能确认当前行为
评分 3/5。README 是 5 分水平，但整体文档结构分散，缺少站点化和版本化。对非 Claude Code 用户不友好。
社区与成熟度
| 维度 | 评分 | 说明 |
|---|---|---|
| 社区活跃度 | 4/5 | 258.7k stars、23.1k forks、159 open issues、166 open PRs 是高可见度与高维护负载信号；stars 不等于生产采用证明 [GH] |
| 成熟度 | 2/5 | 2025-10-09 创建（仍不到一年），v6.0/v6.1 连续改变 review、worktree、hooks、marketplace 与支持平台，API/行为稳定性仍需时间证明 [GH][GH:release] |
社区方面的积极信号主要限于本轮可核验的 GitHub 可见度、fork 数、issue/PR 活动和 release 标签；其他生态收录、Discord 活跃度或维护者响应速度需要另做来源采集后再写入。
成熟度方面的顾虑：版本迭代速度快且包含行为变更，用户需要持续跟进。旧 issue 中包含 silent stall、HEAD 游离等风险样本；截至 2026-07-22 仍有 159 open issues / 166 open PRs [GH][GH:issues]。对追求稳定的团队而言，这是最大的风险点。
安全与风险
Superpowers 本身主要是一组 Markdown、Shell/JS hooks 与 plugin manifests；本轮未发现持久服务，也未在 GitHub repository advisories endpoint 找到已发布 advisory，但这不构成安全证明 [GH:advisories][GH:local-scan]。
具体风险点：
- 自动执行因平台而异：Claude/Pi/Antigravity 等路径会通过 hook/extension 注入 bootstrap；Codex v6.1 明确移除了 SessionStart hook。任何自动加载的第三方 skill 都应视为代码/指令供应链 [Docs][GH:release]
- Subagent 权限：subagent-driven development 会分派 subagent 执行代码，subagent 拥有与主 agent 相同的文件系统权限。恶意 skill 可能通过 subagent 执行有害操作
- 外部请求与隐私：visual companion 默认可向项目网站请求带版本号的 logo；README 声称不含项目/prompt 信息并提供
SUPERPOWERS_DISABLE_TELEMETRY等 opt-out，本轮未抓包验证 [Docs]
评分 3/5。没有中心化服务降低了一部分攻击面，但 hooks/extensions、subagent 权限继承、marketplace/package 供应链和 optional version telemetry 都是非零风险；仓库未见 SECURITY.md，且本轮没有安装或权限测试，因此不能给 4。
学习价值
高。即使不完全采纳 Superpowers，其方法论有独立学习价值：
- Agentic SDLC 设计——brainstorm → spec → plan → subagent TDD → review → ship 的链路是目前最完整的 agent 工作流参考实现。理解它有助于设计自己的 agent workflow
- Skill 触发模型——auto-triggering vs slash-command 的设计差异是 agent interaction design 的核心议题。Superpowers 提供了一个极端（流程优先）的参考
- TDD 在 agent 语境下的实践——chat-based TDD 与传统 IDE TDD 在节奏和约束上有本质差异，Superpowers 的 TDD skill 提供了 agent 原生的 TDD 流程设计
- Subagent 编排——fresh implementer context + 单 reviewer 双 verdict + whole-branch review 的 v6 设计，是研究质量门与 token 成本取舍的当前案例 [GH:release]
- 写作 SKILL.md 的方法论——writing-skills 本身是关于「如何写好的 agent instruction」的元技能，包含测试 methodology，可迁移到任何 skill/instruction 创作场景