Superpowers（obra 出品，MIT，约 27.9 万星）是 Agent 技能框架 + 软件开发方法论。14 个可组合技能让编码 Agent 从"上来就写代码"变成"先想清楚再动手"：先对齐需求与设计，再出实现计划，然后以子代理驱动的方式逐个任务执行、审查、验证。

• 形态：纯技能包（SKILL.md 集合），无 CLI / daemon / 端口 / 网络调用
• 运行方式：技能由 Agent 依据 description 自动触发，用户无感知命令入口

这个工具解决什么问题：让 Agent 按软件工程方法论干活——先设计后编码、测试驱动、系统化调试、子代理驱动开发。Superpowers 是 14 个可组合技能的方法论框架：Agent 依据 SKILL.md 的 description 自动触发（如写代码前自动 brainstorming + TDD）。

什么时候用：

• 你要让 Agent 的编码行为从「直接写」变成「先想清楚再写」；
• 你要 brainstorming / test-driven-development / systematic-debugging / subagent-driven-development 这套方法论；
• 你在 Codex 环境（官方 Codex 形态 = 复制 skills/ 到 ~/.codex/skills/superpowers，本环境实测）。

什么时候别用：你只想要工具、不想要方法论约束时——它会改变 Agent 的工作方式（这是设计目的）。

注意事项：纯技能包——无 CLI/daemon/端口；安装 = 复制 skills 目录；技能由 Agent 自动触发，无需手动命令。

note: 官方 Codex 形态（本环境实测）；国内/国外均可直连 GitHub（codeload 1.7s，探针 2026-08-27）

# 来源: Trove 详细指南 · 验证于 2026-08-27
curl -sL -o /tmp/superpowers.tar.gz https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0
rm -rf /tmp/superpowers-src && mkdir -p /tmp/superpowers-src
tar xzf /tmp/superpowers.tar.gz -C /tmp/superpowers-src --strip-components=1
mkdir -p ~/.codex/skills && cp -r /tmp/superpowers-src/skills ~/.codex/skills/superpowers
test -f ~/.codex/skills/superpowers/brainstorming/SKILL.md && echo "superpowers installed: OK"

预期输出: superpowers installed: OK

第 1 步：确认技能目录就位

讲解：安装是纯文件复制，确认文件落地即安装完成——test -f 标记文件存在 + 目录列表包含核心技能目录。

# 来源: Trove 详细指南 · 验证于 2026-08-27
test -f ~/.codex/skills/superpowers/brainstorming/SKILL.md && echo "installed: OK" || echo "installed: MISSING"
ls ~/.codex/skills/superpowers

预期输出: installed: OK + 14 个技能目录（brainstorming / test-driven-development / systematic-debugging / subagent-driven-development 等）

卡住怎么办：

• 目录不齐 → 重新执行「一步步来」第 1 步的复制；
• 技能没生效 → 确认复制到了 Agent 实际读取的技能目录（Codex 是 ~/.codex/skills/）。

第 2 步：确认 Agent 能触发（可选）

讲解：技能由 Agent 自动触发，无需手动命令；新建会话后让 Agent 处理一个匹配技能的场景（如调试任务），能引用 brainstorming/systematic-debugging 即链路确认。

# 来源: Trove 详细指南 · 验证于 2026-08-27
# 无命令：新建会话让 Agent 触发技能即可

预期输出: Agent 会话中技能被自动引用（无需手动调用）

卡住怎么办：

• Agent 不引用 → 确认技能目录在 Agent 实际读取路径（~/.codex/skills/），必要时重启会话。

它怎么工作：官方 Codex 形态 = 把仓库 skills/ 复制到 ~/.codex/skills/superpowers（纯文件复制，14 个技能目录 + SKILL.md）。安装后技能由 Agent 依据 description 自动触发。方式 B：Claude Code 官方插件市场（/plugin install superpowers，未实测——未登录）。

关键概念：

• 自动触发：Agent 读 SKILL.md 的 description，任务匹配时自动装载；
• 方法论技能：brainstorming / TDD / systematic-debugging / subagent-driven-development 等 14 个；
• 同目录写面：技能子目录名唯一，与其他技能集同名则后装覆盖。

装完它动哪里：~/.codex/skills/superpowers/（Codex 形态）；Claude 形态写 ~/.claude/skills/ 或插件注册。

• ~/.codex/skills/superpowers/：14 个技能目录（本形态实测，纯文件）
• Claude Code 形态：~/.claude/skills/（推断）
• 不写：配置文件、注册表、端口、后台进程

第 1 步：复制技能目录（为什么直接复制：纯文件技能包，无依赖无注册）

讲解：下载 tag 为 v6.3.0 的 tarball（固定 tag 不漂移），解压后把 skills/ 复制到 ~/.codex/skills/superpowers。重复安装覆盖同名目录。安装 = 纯文件复制，无依赖、无注册、无后台进程。

# 来源: Trove 详细指南 · 验证于 2026-08-27
curl -sL -o /tmp/superpowers.tar.gz https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0
rm -rf /tmp/superpowers-src && mkdir -p /tmp/superpowers-src
tar xzf /tmp/superpowers.tar.gz -C /tmp/superpowers-src --strip-components=1
mkdir -p ~/.codex/skills && cp -r /tmp/superpowers-src/skills ~/.codex/skills/superpowers
test -f ~/.codex/skills/superpowers/brainstorming/SKILL.md && echo "superpowers installed: OK"

预期输出: superpowers installed: OK

装好确认：

• 输出 superpowers installed: OK；
• ls ~/.codex/skills/superpowers 有 14 个技能目录。

卡住怎么办：

• codeload 下载失败 → 换网络重试（codeload 直连实测 1.7s，一般可达）；
• 技能没生效 → 确认复制到了 Agent 实际读取的技能目录（Codex 是 ~/.codex/skills/）。

第 2 步：确认技能就位（本环境实测）

讲解：列出技能目录确认 14 个技能；技能由 Agent 自动触发，无需手动命令。

# 来源: Trove 详细指南 · 验证于 2026-08-27
ls ~/.codex/skills/superpowers

预期输出: 14 个技能目录（brainstorming / test-driven-development / systematic-debugging / subagent-driven-development 等）

装好确认：

• 输出包含 brainstorming、test-driven-development 等目录。

卡住怎么办：

• 目录不齐 → 重新执行第 1 步的复制。

第 3 步：更新到最新版（重新下载覆盖）或装 Claude 形态（按需）

讲解：更新 = 重新下载覆盖（固定 tag，不会漂移）；Claude Code 形态用官方插件市场（未实测——未登录）；也可手动复制到 ~/.claude/skills/superpowers。

# 来源: Trove 详细指南 · 验证于 2026-08-27
curl -sL -o /tmp/superpowers.tar.gz https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0 && rm -rf /tmp/superpowers-src && mkdir -p /tmp/superpowers-src && tar xzf /tmp/superpowers.tar.gz -C /tmp/superpowers-src --strip-components=1 && cp -r /tmp/superpowers-src/skills ~/.codex/skills/superpowers && echo "updated: OK"

预期输出: updated: OK

Claude 形态检查：

# 来源: Trove 详细指南 · 验证于 2026-08-27
ls ~/.claude/skills/superpowers 2>/dev/null || echo "未安装 Claude 形态"

预期输出: 目录列表或未安装提示

卡住怎么办：

• 下载失败 → 换网络重试（codeload 直连实测 1.7s）；
• Claude 插件形态装不上 → 确认 Claude Code 登录（本环境未实测）。

启动与入口

无启动；技能由 Agent 按需自动触发（SKILL.md 的 description 决定）。

常用操作

操作一：确认已装技能

# 来源: Trove 详细指南 · 验证于 2026-08-27
ls ~/.codex/skills/superpowers

预期输出: 14 个技能目录（brainstorming / test-driven-development / systematic-debugging / subagent-driven-development 等）

操作二：更新到最新版（重新下载覆盖）

# 来源: Trove 详细指南 · 验证于 2026-08-27
curl -sL -o /tmp/superpowers.tar.gz https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0 && rm -rf /tmp/superpowers-src && mkdir -p /tmp/superpowers-src && tar xzf /tmp/superpowers.tar.gz -C /tmp/superpowers-src --strip-components=1 && cp -r /tmp/superpowers-src/skills ~/.codex/skills/superpowers && echo "updated: OK"

预期输出: updated: OK

操作三：检查是否装过 Claude 形态

# 来源: Trove 详细指南 · 验证于 2026-08-27
ls ~/.claude/skills/superpowers 2>/dev/null || echo "未安装 Claude 形态"

预期输出: 目录列表或未安装提示

数据与目录

• 技能目录：~/.codex/skills/superpowers/（Codex 形态）；
• Claude 形态：~/.claude/skills/superpowers 或插件注册。

与工具页矩阵同源，共 4 对（0 实测兼容 / 3 推断可能兼容 / 1 推断可能冲突）；完整对子、状态与证据见 冲突对子（共装矩阵）。

• 技能不触发：确认 ~/.codex/skills/superpowers 存在且含 SKILL.md；重启会话让 Agent 重新加载技能
• 同名技能被覆盖：后装者覆盖（如 brainstorming），卸载后重装即可恢复

# 来源: Trove 详细指南 · 验证于 2026-08-27
rm -rf ~/.codex/skills/superpowers
test ! -e ~/.codex/skills/superpowers && echo "零残留: OK"

Claude Code 形态需同时删 ~/.claude/skills/superpowers（如存在）。

note: 纯文件技能包，删除技能目录即零残留；本市场一键卸载自动执行

# 来源: Trove 详细指南 · 验证于 2026-08-27
rm -rf ~/.codex/skills/superpowers
test ! -d ~/.codex/skills/superpowers && echo "superpowers removed: OK" || echo "残留: superpowers 仍存在"

预期输出: superpowers removed: OK

手动确认清单（若装过其他形态）：

• ~/.claude/skills/superpowers（Claude Code 手动复制形态）
• Claude Code /plugins 安装的插件（用 /plugin uninstall superpowers）
• 其他 harness（Cursor/Gemini/Copilot 等）：对应平台插件管理删除

• Q：装完没效果？A：技能是自动触发的，给 Agent 正常提需求即可；它先对齐设计是预期行为
• Q：和别的技能包冲突吗？A：同名目录会互相覆盖；不同名一般无冲突（纯文件复制）
• Q：会动我的配置吗？A：不会。只复制 skills 目录，不写配置文件、不开端口

• 问：安装后需要配置什么吗？答：不需要。技能由 Agent 按需自动触发（SKILL.md 的 description 决定），无配置文件。
• 问：会不会影响我现有的其他技能？答：superpowers 技能子目录名唯一（如 brainstorming）；若其他技能集有同名技能，后装者覆盖（同目录写面），先检查 ~/.codex/skills 下已有技能名。
• 问：为什么我的 Agent 行为变了？答：这是预期的——superpowers 是方法论框架（先设计后编码、TDD、子代理驱动），会改变 Agent 的工作方式。
• 问：更新快，版本怎么锁定？答：本条目锁定 6.3.0（manifest version_range 单版本）；安装命令固定 tag，不会漂移。
• 问：和其他插件能一起装吗？答：与 omc/agt/deepcode 判定 possible-compatible（无共享写面）；与 ruflo 判定 possible-conflict（Claude 形态共享 ~/.claude/skills 写面，未实测），装 ruflo 时建议用 Codex 形态。
• 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口（usage-report 模板）；项目自身问题请向作者仓库反馈。

• 版本：[6.3.0, 6.3.0] 锁定（收录实测版本；安装命令固定 tag 不漂移）。
• 环境：无运行时要求；Codex 形态需 ~/.codex/skills 可写。
• 网络：codeload 直连实测 1.7s（国内/国外均可直连）。
• 写面：~/.codex/skills/superpowers/（纯文件复制；重复安装覆盖同名目录）。
• 共装：与 omc/agt/deepcode 判定 possible-compatible（无共享写面）；与 ruflo 判定 possible-conflict（Claude 形态共享 ~/.claude/skills 写面，未实测），装 ruflo 时建议用 Codex 形态。

• 官方文档未收录第三方教程；如需查阅英文原版 README 请到项目仓库

• 实测：实测记录（本地留存）（2026-08-27，codeload 下载 + 复制 + 技能就位冒烟）。
• 未实测：Claude Code 插件形态（未登录）；技能自动触发效果（需真实 Agent 会话观察）。

第三方教学未逐条实测，仅供学习；有出入以本页与官方文档为准。

• 官方 README（codeload tarball v6.3.0，2026-08-31 结构实测）：Superpowers 完整用法 [官方文档 · Superpowers 官方 · 2026-08-31（tag v6.3.0）]
  官方用法全解——安装（Claude Code 插件市场 / 多 Agent 市场：.agents/.claude-plugin/.codex-plugin/.cursor-plugin/.devin-plugin）、基本工作流（plan → execute → review）、14 个技能（brainstorming/dispatching-parallel-agents/executing-plans/systematic-debugging/test-driven-development/using-git-worktrees/writing-plans 等）、更新方式、视觉伴生遥测说明