跳至主要內容

OpenCode + Superpowers：技能插件安装与用法

LiuMangMang2026/3/16大约 4 分钟AI开发工具OpenCodeSuperpowers插件Skills

OpenCode + Superpowers：技能插件安装与用法

Superpowers 是一套给 OpenCode 增强“技能（skills）体系”的插件与技能包：
把常用的提示词/工作流封装成可复用技能，并在每次对话时自动注入必要的引导上下文。

一、它解决什么问题

在 OpenCode 里你当然可以直接对话、直接改代码；但当你需要把一套稳定的工作方式
（例如：代码审查、需求拆解、写作规范、某语言最佳实践）复用到每个项目时，skills
会更顺手。

Superpowers 主要提供：

  • 一个 OpenCode 插件：启动时自动注入 superpowers 的引导上下文。
  • 一组技能：通过 OpenCode 的 skill 工具发现/加载。
  • 适配逻辑：把部分为其他代理写的技能说明，映射到 OpenCode 的工具体系。

二、快速安装（把话直接丢给 OpenCode）

如果你希望“让 OpenCode 帮你完成安装”，可以直接在对话里说：

Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js to ~/.config/opencode/plugins/superpowers.js, then symlink ~/.config/opencode/superpowers/skills to ~/.config/opencode/skills/superpowers, then restart opencode.

你也可以按下面手动安装（更可控，适合第一次装）。

三、手动安装（macOS / Linux）

前置条件：

  • 已安装 OpenCode
  • 已安装 Git

执行：

# 1) 安装（或更新）
if [ -d ~/.config/opencode/superpowers ]; then
  cd ~/.config/opencode/superpowers && git pull
else
  git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
fi

# 2) 创建目录
mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills

# 3) 清理旧链接（重复安装时安全）
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

# 4) 建立链接
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

然后重启 OpenCode。

四、手动安装（Windows）

Windows 的重点在“符号链接权限”。你需要满足其一：

  • 启用 Developer Mode（开发者模式），或
  • 用管理员权限运行终端。

建议优先用 PowerShell（命令更清晰）。

4.1 Command Prompt（管理员）

:: 1) 安装
git clone https://github.com/obra/superpowers.git "%USERPROFILE%\\.config\\opencode\\superpowers"

:: 2) 创建目录
mkdir "%USERPROFILE%\\.config\\opencode\\plugins" 2>nul
mkdir "%USERPROFILE%\\.config\\opencode\\skills" 2>nul

:: 3) 清理旧链接
del "%USERPROFILE%\\.config\\opencode\\plugins\\superpowers.js" 2>nul
rmdir "%USERPROFILE%\\.config\\opencode\\skills\\superpowers" 2>nul

:: 4) 插件 symlink（需要开发者模式或管理员）
mklink "%USERPROFILE%\\.config\\opencode\\plugins\\superpowers.js" "%USERPROFILE%\\.config\\opencode\\superpowers\\.opencode\\plugins\\superpowers.js"

:: 5) skills 用 junction（通常更稳）
mklink /J "%USERPROFILE%\\.config\\opencode\\skills\\superpowers" "%USERPROFILE%\\.config\\opencode\\superpowers\\skills"

4.2 PowerShell（管理员或开发者模式）

# 1) 安装
git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\\.config\\opencode\\superpowers"

# 2) 创建目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\\.config\\opencode\\plugins" | Out-Null
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\\.config\\opencode\\skills" | Out-Null

# 3) 清理旧链接
Remove-Item "$env:USERPROFILE\\.config\\opencode\\plugins\\superpowers.js" -Force -ErrorAction SilentlyContinue
Remove-Item "$env:USERPROFILE\\.config\\opencode\\skills\\superpowers" -Force -ErrorAction SilentlyContinue

# 4) 插件 symlink
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\\.config\\opencode\\plugins\\superpowers.js" -Target "$env:USERPROFILE\\.config\\opencode\\superpowers\\.opencode\\plugins\\superpowers.js" | Out-Null

# 5) skills junction
New-Item -ItemType Junction -Path "$env:USERPROFILE\\.config\\opencode\\skills\\superpowers" -Target "$env:USERPROFILE\\.config\\opencode\\superpowers\\skills" | Out-Null

五、验证安装是否成功

macOS / Linux：

ls -l ~/.config/opencode/plugins/superpowers.js
ls -l ~/.config/opencode/skills/superpowers

Windows（Command Prompt）：

dir /AL "%USERPROFILE%\\.config\\opencode\\plugins"
dir /AL "%USERPROFILE%\\.config\\opencode\\skills"

看到 <SYMLINK> 或 <JUNCTION> 即表示链接生效。

六、开始使用：列出并加载技能

6.1 列出当前可用 skills

在 OpenCode 中让它调用原生 skill 工具：

use skill tool to list skills

6.2 加载某个技能

use skill tool to load superpowers/brainstorming

加载后，你可以直接让它按该 skill 的工作方式来执行任务（例如：先问澄清问题、再拆
步骤、再写代码/写文档）。

七、skills 的来源与优先级（理解后更好排查）

OpenCode 会从这些位置发现 skills（优先级从高到低）：

  1. 项目内：.opencode/skills/
  2. 个人目录：~/.config/opencode/skills/
  3. Superpowers：~/.config/opencode/skills/superpowers/（通常是 symlink 指向仓库里的 skills/）

你可以把团队约定写成“项目 skill”，把通用习惯写成“个人 skill”。

八、更新与常见问题

8.1 更新

cd ~/.config/opencode/superpowers
git pull

更新后重启 OpenCode。

8.2 插件没生效

排查顺序建议：

  1. 插件文件是否存在：~/.config/opencode/superpowers/.opencode/plugins/superpowers.js
  2. 链接是否正确：~/.config/opencode/plugins/superpowers.js
  3. 看日志（更直接）：
opencode run "test" --print-logs --log-level DEBUG

8.3 Windows 报 Cannot find module

常见原因是 Git Bash 下 ln 行为不符合预期（可能变成复制文件）。
建议直接用 mklink + /J（junction），按本文 Windows 安装步骤重建链接。

九、结语

如果你已经把 OpenCode 用在日常开发里，Superpowers 的价值在于：
把“可复用的工作流”变成技能，并且跨项目一致。

参考文档（原文）：
https://github.com/obra/superpowers/blob/main/docs/README.opencode.md