一、前置条件
在开始之前,请确保已安装以下工具:
| 工具 | 检查命令 | 说明 |
|---|---|---|
| Git | git --version | 必需,用于克隆技能库 |
| Node.js | node --version | 必需,版本需 ≥ 18.0 |
| OpenCode | 打开 OpenCode 应用 | 目标平台 |
如果git --version显示版本号(如git version 2.47.1),说明已安装。如果显示不是内部或外部命令,请先安装 Git。
二、安装步骤
步骤 1:创建必要目录
打开CMD(命令提示符),依次执行:
mkdir %USERPROFILE%\.opencode\extensions 2>nul mkdir %USERPROFILE%\.opencode\plugins 2>nul mkdir %USERPROFILE%\.opencode\skills 2>nul
步骤 2:克隆 Superpowers 仓库
cd %USERPROFILE%\.opencode\extensions git clone https://github.com/obra/superpowers.git
如果 GitHub 访问慢,可使用镜像加速:
cmd
复制 下载git clone https://ghproxy.net/https://github.com/obra/superpowers.git
步骤 3:安装插件文件
copy %USERPROFILE%\.opencode\extensions\superpowers\.opencode\plugins\superpowers.js %USERPROFILE%\.opencode\plugins\
步骤 4:安装技能文件
xcopy %USERPROFILE%\.opencode\extensions\superpowers\skills\* %USERPROFILE%\.opencode\skills\ /E /I /Y
步骤 5:验证安装
:: 检查插件 dir %USERPROFILE%\.opencode\plugins :: 检查技能 dir %USERPROFILE%\.opencode\skills
预期结果:
plugins目录下应有superpowers.js文件skills目录下应有brainstorming、writing-plans、test-driven-development等文件夹
三、完成安装
完全关闭 OpenCode(确保进程彻底退出)
重新打开 OpenCode
在 OpenCode 中输入以下命令测试:
你现在有 superpowers 技能吗?请列出你拥有的技能。
如果返回技能列表(如 brainstorming、test-driven-development 等),说明安装成功。
四、完整安装脚本(一键复制)
将以下内容保存为install-superpowers.bat,以管理员身份运行:
@echo off echo ======================================== echo Installing Superpowers for OpenCode... echo ======================================== :: 创建目录 mkdir %USERPROFILE%\.opencode\extensions 2>nul mkdir %USERPROFILE%\.opencode\plugins 2>nul mkdir %USERPROFILE%\.opencode\skills 2>nul :: 克隆仓库 cd %USERPROFILE%\.opencode\extensions if exist superpowers ( echo Superpowers already exists, updating... cd superpowers git pull ) else ( echo Cloning Superpowers... git clone https://github.com/obra/superpowers.git cd superpowers ) :: 安装插件和技能 echo Installing plugins... copy .opencode\plugins\superpowers.js %USERPROFILE%\.opencode\plugins\ >nul echo Installing skills... xcopy skills\* %USERPROFILE%\.opencode\skills\ /E /I /Y >nul echo. echo ======================================== echo Installation complete! echo Please restart OpenCode to activate. echo ======================================== pause
五、常见问题排查
| 问题 | 解决方法 |
|---|---|
git not found | 安装 Git 或确认 Git 路径已添加到系统 PATH |
ghproxy.net 连接失败 | 直接使用 GitHub 原地址克隆(需科学上网) |
| OpenCode 重启后技能未加载 | 检查~/.opencode/skills目录是否存在技能文件夹 |
| 插件未被识别 | 在 OpenCode 中执行/plugin load superpowers |
六、技能清单(安装后可用的核心技能)
| 技能 | 用途 |
|---|---|
brainstorming | 需求分析和设计探索 |
test-driven-development | 测试驱动开发 |
systematic-debugging | 系统化调试 |
writing-plans | 制定执行计划 |
executing-plans | 按计划执行 |
requesting-code-review | 请求代码审查 |
verification-before-completion | 完成前验证 |
using-superpowers | 技能使用规范 |
以上就是完整的安装流程。建议将这份文档保存下来,方便以后参考或在新机器上重新安装。