一、前置条件

在开始之前，请确保已安装以下工具：

工具	检查命令	说明
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 等文件夹

---

三、完成安装

1. 完全关闭 OpenCode（确保进程彻底退出）

2. 重新打开 OpenCode

3. 在 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	技能使用规范

---

以上就是完整的安装流程。建议将这份文档保存下来，方便以后参考或在新机器上重新安装。