GitHub 热门项目推荐：superpowers（Shell｜300990 Star）

这个项目有什么用

superpowers 是一套面向编码 agent 的软件开发方法论，建立在若干可组合的 skills 与初始指令之上，目的是让 agent 在写代码之前先把需求、设计和实现计划理清楚。它解决的是「agent 一上来就写代码」这个常见问题：装上之后，agent 会先退一步，问清楚你到底想做什么，再按流程推进。

它替代了什么

• 替代「直接丢一句需求让 agent 自由发挥」的用法，把需求澄清、规格确认、实现计划变成固定环节。
• 替代人工反复盯进度、逐条检查 agent 产出的做法，由 subagent-driven-development 流程逐项推进并审查。
• 替代口头约定式的 TDD、YAGNI、DRY 要求，把这些原则写进实现计划的要求里。

典型使用场景

• 从零开始一个新功能，需要先梳理规格再动手。
• 把一份模糊的想法变成可执行的工程任务清单。
• 让 agent 在较长时间内按既定计划自主推进，而不是频繁跑偏。

适合已经在使用 Claude Code、Codex、Cursor、Gemini CLI 等编码 agent 的个人开发者或团队；如果团队需要商业支持，README 中提供了 sales@primeradiant.com 这个联系渠道。

核心特性

• 先问再做：agent 察觉你在构建东西时不会直接写代码，而是先退一步，问清楚你真正想达成的目标。
• 分块确认规格：把对话中梳理出的 spec 切成足够短、能真正读完消化的片段展示给你，确认后才进入下一步。
• 面向「初级工程师」的实现计划：计划要清晰到让一个热情但没品味、没判断力、没有项目上下文、还讨厌测试的初级工程师也能照着做，并强调真正的 red/green TDD、YAGNI 与 DRY。
• subagent-driven-development：你说「go」之后，由多个 agent 逐项完成工程任务，检查并审查它们的工作，然后继续推进。
• 自动触发：skills 会自动触发，不需要你做额外操作，agent 就「自带」Superpowers。
• 多 harness 支持：README 的安装章节覆盖 Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Devin CLI、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse 等多种环境。

怎么安装

README 明确说明：安装方式因 harness 而异；如果你同时使用多个 harness，需要为每一个单独安装。下面以 Claude Code 与 Gemini CLI 为例，其余 harness 的命令见 README 对应小节。

1. 从 Anthropic 官方 marketplace 安装 Claude Code 插件：

   /plugin install superpowers@claude-plugins-official

2. 或者改用 Superpowers 自己的 marketplace，先注册：

   /plugin marketplace add obra/superpowers-marketplace

3. 再从该 marketplace 安装插件：

   /plugin install superpowers@superpowers-marketplace

4. 如果使用 Gemini CLI，安装扩展：

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

5. 之后更新扩展：

   gemini extensions update superpowers

README 未说明所需的语言版本、系统依赖或账号密钥等前提条件，官方文档未说明这部分内容。

怎么使用

基础用法不需要额外命令：安装完成后，skills 会自动触发。你正常启动编码 agent 并说明要构建的东西，它就会先问你真正想做什么，然后把 spec 分块给你确认，再产出实现计划，最后在你同意后进入 subagent-driven-development 流程。

以 Cursor 为例，README 给出的安装入口是在 Agent 聊天中执行：

/add-plugin superpowers

也可以在插件市场里搜索 “superpowers”。

进阶用法方面，README 提到 OpenCode 使用自己的插件安装机制，即使你已在其他 harness 中用过 Superpowers，也要单独安装：

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

Pi 则支持把本仓库作为临时包加载，便于本地开发：

pi -e /path/to/superpowers

README 还提到 Pi 会在会话启动时以及 compaction 之后注入 using-superpowers 引导，且 Pi 原生支持 skills，因此不需要兼容用的 Skill 工具；subagent 与任务列表工具仍是可选的 Pi 配套包。其他配置项的细节，官方文档未在摘录中说明。

适用场景与注意事项

适合的场景是：你希望 agent 在有明确规格和计划的前提下工作，并愿意在前期花时间确认设计与计划；也适合需要 agent 长时间自主推进、同时保持审查环节的团队。

不太适合的场景是：只想让 agent 立刻产出几行代码、不希望被追问需求的轻量任务；以及不愿意为每个 harness 重复安装的环境。

• 项目采用 MIT 协议，商用与修改相对宽松，具体条款以仓库 LICENSE 为准。
• 需要联网：安装命令大多从 marketplace 或 GitHub 仓库拉取内容。
• 多 harness 需分别安装，README 明确提醒这一点。
• README 设有「Visual companion telemetry」小节，说明存在相关遥测内容，使用前建议阅读该节。
• 企业场景如需商业支持、额外工具或托管支出，README 给出了 sales@primeradiant.com 联系方式。

项目地址

仓库地址：https://github.com/obra/superpowers
作者/组织：obra
开源协议：MIT

superpowers 把「先澄清需求、再分块确认规格、然后按计划由 subagent 推进」这套流程固化进编码 agent，是否值得引入，取决于你的团队是否愿意为前期确认付出时间。