OpenCode Superpowers 插件核心价值
Superpowers 插件解决了 AI 编程'只懂打字、不懂工程'的痛点。它不像普通插件仅增加基础功能，而是将软件工程最佳实践（如 TDD、代码审查、重构）植入 AI 生成逻辑，让 AI 从'代码工具人'转变为真正的工程伙伴。实测表明，无论是个人开发还是小团队协作，该插件都能显著提升代码质量和开发效率。
前置准备
安装前需确保满足以下基础条件：
- 已安装 OpenCode（任意稳定版本均可）；
- 具备基础终端操作能力，能执行简单的 git、ln 命令；
- 网络正常，能够访问 GitHub 以拉取仓库代码。
安装步骤
全程在终端操作，建议按顺序执行。
克隆仓库
将 Superpowers 仓库克隆到 OpenCode 的默认配置目录（~/.config/opencode/），这样插件能被自动识别：
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
注意：如果克隆速度慢，可替换为国内镜像或切换网络后重试。克隆成功后，目录下会自动生成 superpowers 文件夹。
注册插件与技能链接
Superpowers 的插件文件和技能目录需要链接到 OpenCode 的对应目录才能被加载。
首先创建 OpenCode 插件目录并建立符号链接：
mkdir -p ~/.config/opencode/plugins
ln -sf ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/
接着创建技能目录并建立符号链接，确保 AI 能调用所有内置技能：
mkdir -p ~/.config/opencode/skills
ln -sf ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers
其中 ln -sf 中的 f 表示强制覆盖，若之前装过旧版本会自动替换。
验证安装
执行以下命令检查符号链接是否创建成功：
ls -l ~/.config/opencode/plugins/superpowers.js
ls -l ~/.config/opencode/skills/superpowers
若输出结果中包含 -> 且指向正确的 superpowers 目录，说明链接创建成功。
激活与验证
安装完成后，必须重启 OpenCode 才能加载插件。
重启会话
如果当前正在运行 OpenCode，先退出再重新启动：
exit
opencode
重启后，Superpowers 会自动注入上下文，无需额外配置。
确认生效
在会话中直接输入以下提问即可快速验证：
do you have superpowers?
若收到类似回复，则验证成功：
Yes! I have Superpowers installed and ready to use. Available skills include: superpowers/brainstorming, superpowers/tdd, superpowers/debugging, superpowers/code-review, superpowers/refactoring.
若未收到回复或提示'unknown command'，大概率是符号链接创建失败，请重新执行上述链接命令并重启 OpenCode。
实战使用教程
Superpowers 的核心用法是'加载技能→提出需求'，所有操作都在 OpenCode 会话中完成。
查看可用技能
输入以下指令列出所有内置技能：
use skill tool to list skills
执行后会列出技能及简要说明，常见技能包括：
- superpowers/brainstorming：结构化头脑风暴，发散需求思路；
- superpowers/tdd：测试驱动开发，先写测试用例再实现功能；
- superpowers/debugging：代码调试，定位并解决 bug；
- superpowers/code-review：代码审查，优化可读性和性能；
- superpowers/refactoring：代码重构，在不改变功能前提下优化结构。
技能加载与示例
用法很简单：先加载技能，再提出具体需求，AI 会严格按照技能对应的流程回复。
示例 1：用 TDD 技能开发 Python 函数
需求：写一个计算斐波那契数列的 Python 函数，要求遵循 TDD 流程。
use skill tool to load superpowers/tdd
Write a Python function to calculate Fibonacci numbers using TDD approach
AI 会先编写完整的测试用例（覆盖边界条件），再实现满足测试的最小功能，最后重构代码优化可读性，全程符合 TDD 规范。
示例 2：用头脑风暴技能梳理项目思路
需求：梳理一个面向新手的 Python AI 代码助手的开发思路。
use skill tool to load superpowers/brainstorming
Brainstorm ideas for a Python-based AI code assistant (focus on ease of use for beginners)
AI 会按'拆解需求→发散思路→收敛方案'的流程，给出结构化的思路，避免思路零散。
使用技巧
- 可以同时加载多个技能，例如同时遵循 TDD 和代码审查规范；
- 不需要某个技能时，直接输入
unload skill superpowers/xxx即可卸载； - 提出需求时越具体，AI 的回复越精准。
更新与维护
Superpowers 会持续更新技能和功能，后续想更新插件无需重新安装，只需拉取最新代码：
cd ~/.config/opencode/superpowers
git pull
exit && opencode
更新后建议再次输入 do you have superpowers? 验证新版本加载情况。
常见问题排查
插件未生效
原因可能是符号链接创建失败或路径错误。解决方案：重新执行符号链接命令，再重启 OpenCode；若仍失败，检查 OpenCode 插件目录是否为 ~/.config/opencode/plugins/。
技能未找到
提示'skill not found'通常因技能目录链接错误或仓库克隆不完整导致。解决方案：重新创建技能符号链接，或删除 superpowers 目录重新克隆仓库。
权限问题
终端执行 git clone 提示'permission denied'是因为无写入权限。解决方案：执行 chmod -R 755 ~/.config/opencode/ 赋予权限，再重新克隆。
总结
Superpowers 插件的核心价值在于让 AI 编程从'快速打字'升级为'工程化开发'。它不需要额外学习复杂操作，安装完成后只需加载对应技能，就能让 AI 自动遵循软件工程最佳实践。通过规范流程，这款插件能帮助开发者节省代码审查、调试、重构的时间，同时提升代码质量。按照上述步骤，几分钟即可完成安装与激活。
