OpenCode Superpowers 插件安装与使用指南
OpenCode 的 Superpowers 插件将软件工程最佳实践(TDD、代码审查、重构)植入 AI 生成逻辑,让 AI 从简单的代码生成工具转变为具备工程思维的协作伙伴。
核心价值
- 规范流程:强制引导 AI 遵循 TDD、YAGNI 等最佳实践,提升代码可维护性;
- 技能化拆解:内置头脑风暴、调试、代码审查、重构等实用技能,按需加载;
- 轻量兼容:依赖原生能力,不占用过多资源,适配主流 OpenCode 版本及多种 AI 代理。
前置准备
- 已安装 OpenCode(任意稳定版本);
- 具备终端操作能力,熟悉 git、ln 命令;
- 网络通畅,可访问 GitHub。
安装步骤
1. 克隆仓库
将 Superpowers 仓库克隆至 OpenCode 默认配置目录,确保插件自动识别:
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
若克隆速度慢,可尝试国内镜像源或切换网络环境。
2. 注册插件
创建符号链接,使 OpenCode 能够加载插件文件:
# 创建插件目录(若不存在)
mkdir -p ~/.config/opencode/plugins
# 创建符号链接
ln -sf ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/
注意:ln -sf 中的 f 表示强制覆盖,旧版本会自动替换。
3. 关联技能目录
将技能目录链接至 OpenCode 的技能目录,确保 AI 可调用内置技能:
# 创建技能目录(若不存在)
mkdir -p ~/.config/opencode/skills
# 创建符号链接
ln -sf ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers
4. 验证安装
执行以下命令检查链接状态:
ls -l ~/.config/opencode/plugins/superpowers.js
ls -l ~/.config/opencode/skills/superpowers
成功标志是输出中包含指向正确 superpowers 目录的箭头 ->。
激活与验证
安装完成后必须重启 OpenCode 才能生效。
- 重启应用:退出当前会话并重新启动。
exit opencode - :在会话中输入以下指令: 若回复确认信息并列出可用技能(如 ),则说明安装成功。


