Superpowers 技能库实操指南：AI 编程助手 3 种平台一次部署
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个 Claude Code 插件形态的技能库，把设计、计划、测试驱动开发、调试等工程流程注入 AI 编程助手的对话上下文，让 Agent 按固定流程工作，而不是拿到需求就直接写代码。下面按部署、使用、适配、维护四块说明怎么把它跑起来。
三种平台的安装差异：Superpowers 部署对比表
三个平台的安装机制不同：Claude Code 走插件市场，Codex 和 OpenCode 目前靠 clone 仓库后手动接入。
| 平台 | 安装方式 | 关键路径 | 备注 |
|---|---|---|---|
| Claude Code | 插件市场两条命令 | 注册 obra/superpowers-marketplace | 装完输入/help可看技能命令列表 |
| Codex | clone 到本地目录 | ~/.codex/superpowers | 依赖 Node.js，建议 v18+ |
| OpenCode | clone 后建符号链接 | ~/.config/opencode/plugin/superpowers.js | 重启 OpenCode 才生效 |
Claude Code：
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplaceCodex：
git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.codex/superpowersOpenCode（插件入口在仓库的.opencode/plugins/superpowers.js）：
git clone https://gitcode.com/GitHub_Trending/su/superpowers ~/.config/opencode/superpowers ln -sf ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugin/superpowers.js技能速览：按使用场景找对应技能
技能名保留英文原名，每个技能都带触发条件，命中场景时自动激活。
- 需求还是个模糊想法时 →brainstorming：用提问收敛需求，把设计稿拆成短段落逐段给你确认。
- 设计敲定要拆任务时 →writing-plans：产出带精确文件路径、完整代码和验证步骤的任务清单，单任务控制在 2-5 分钟粒度。
- 要开隔离分支干活时 →using-git-worktrees：建独立工作区并确认测试基线是干净的。
- 计划确认后想放手执行时 →subagent-driven-development：每个任务派独立子代理完成并复核，关键问题会挡住后续任务。
- 进入编码阶段 →test-driven-development：先写失败的测试，再写最小实现，测试通过才提交。
- 任务之间想留质量关口 →requesting-code-review：对照计划出审查报告，按严重级别列出问题。
- 测试挂了或行为异常时 →systematic-debugging：按四阶段流程定位根因，而不是改到碰巧能过为止。
- 声称"已修复"之前 →verification-before-completion：用证据确认问题确实消失。
- 任务全部完成时 →finishing-a-development-branch：验证测试后给出合并、提 PR 或丢弃的选项，并清理工作区。
一次完整的上手流程：从模糊想法到合入分支
我在装有 Claude Code 的机器上执行完上面两条安装命令后，没有做任何额外配置。对着 Agent 说一句"我想给项目加个限流功能"，它没有立刻写代码，而是触发 brainstorming，先问了几个关于流量峰值和失败策略的问题，然后把设计稿分成几段发给我确认。我回复确认后，writing-plans 生成了任务清单，我说了"go"，subagent-driven-development 开始逐任务派子代理执行，每个任务的实现过程都遵守 test-driven-development，先有测试后有代码。中途有一次测试失败，它自行进入 systematic-debugging 定位后修复。全部任务结束时，finishing-a-development-branch 跑完测试并让我选择合并还是提 PR。整个过程没有手动调用过任何技能，触发都发生在对应任务之前。
跨平台适配的关键差异：工具映射与上下文持久化
技能本身不绑定任何平台的工具名。SKILL.md 里写的是"创建文件""执行命令""派发子任务"这类动作描述，各平台加载时映射到本地工具：文件修改在 OpenCode 上落到apply_patch，在 Claude Code 上是编辑类工具；命令执行落到bash；子任务模板落到各自的任务工具。同一套技能文件因此能原样跑在三个平台上。OpenCode 侧的注册和注入逻辑集中在.opencode/plugins/superpowers.js，通过 config 钩子登记技能目录，不需要符号链接也能发现技能（符号链接只是手动安装方式的替代）。
上下文持久化是另一个容易出问题的点。插件通过消息钩子把 using-superpowers 的引导文本注入每轮对话，OpenCode 压缩上下文后会重新注入，所以长会话里技能依然可用。技能发现时存在优先级：项目级技能（.opencode/skills/或对应目录）> 个人技能 > Superpowers 内置技能。如果你有同名自定义技能，会直接覆盖内置版本，这是特性而不是 bug。
运行时代价方面，OpenCode 插件代码是 ES Module，要求 Node.js 不低于 v14，建议 v18 以上。
日常维护与常见坑：更新、版本要求与符号链接
- 更新：Claude Code 走插件更新；clone 安装的平台在仓库目录
git pull后重启对应平台。 - OpenCode 的 git+ 插件规格可能被 lockfile 或包缓存钉在旧提交上，更新不生效时清一下插件缓存或重装。
- 符号链接要指向
.opencode/plugins/superpowers.js（注意是 plugins 复数目录），用ls -l确认目标没指到旧路径。 - 某个技能没被发现时，先检查该技能目录下
SKILL.md的 YAML frontmatter 是否合法，name 和 description 缺一不可。 - 快速验证是否装好：让助手列出它当前可用的技能，OpenCode 里可以用原生 skill 工具查询。
Superpowers 的价值不在技能数量，而在于把"先设计、再计划、测试先行"变成 Agent 的默认行为。现在打开 Claude Code，执行上面两条安装命令，丢一个模糊需求进去，看它如何先提问再动手。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
