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?
若收到类似回复,则验证成功:


