OpenCode安装superpowers完全攻略

目录

• OpenCode 安装 superpowers 技能
• 一、Superpowers 核心介绍
• 1.1 是什么
• 1.2 技能清单（14 个核心）
• 二、环境准备（必看）
• 2.1 前提条件
• 2.2 安装方式（2 种）
• 三、方式 A：自动安装（推荐・2026 最新）
• 3.1 步骤 1：编辑配置文件
• 3.2 步骤 2：重启 OpenCode
• 3.3 步骤 3：验证安装
• 四、方式 B：手动安装（全平台通用・旧版兼容）
• 4.1 macOS / Linux 手动安装
• 步骤 1：克隆 Superpowers 仓库
• 步骤 2：创建目录（不存在则新建）
• 步骤 3：清理旧链接（避免冲突）
• 步骤 4：创建符号链接（核心）
• 步骤 5：重启 OpenCode → 完成
• 4.2 Windows 手动安装（CMD/PowerShell）
• 步骤 1：克隆仓库
• 步骤 2：创建目录
• 步骤 3：清理旧链接
• 步骤 4：创建链接（管理员权限）
• 步骤 5：重启 OpenCode → 完成
• 五、安装验证（必做）
• 5.1 命令验证
• 5.2 OpenCode 内验证
• 六、基础使用（3 步上手）
• 6.1 核心命令（斜杠快捷）
• 6.2 标准工作流（TDD）
• 6.3 示例：生成登录模块
• 七、常见问题 & 避坑指南
• 7.1 安装失败
• 7.2 使用异常
• 7.3 权限问题
• 八、更新与卸载
• 8.1 更新（手动版）
• 8.2 卸载
• 九、总结
• 🔔 本文说明
• Open Code教程（五）| Skills 之 Superpowers 安装
• 官方安装方式
• 为什么 Windows 上用不了
• Windows 安装方式
• 安装步骤
• 更新
• 卸载
• 验证

软件地址： https://github.com/obra/superpowers?tab=coc-ov-file

Superpowers 是 OpenCode 生态中最强大的工程化 AI 编程技能库，能让 AI 严格遵循 TDD（测试驱动开发）、代码规范、工程流程，输出可直接上线的工业级代码，彻底解决 AI 编码 “堆屎山” 问题。本文提供 macOS/Linux/Windows 全平台安装、验证、使用、避坑 完整文档，可直接发布。

• 定位：AI 编程「工程化规范引擎」，给 OpenCode 装上14+ 专业开发技能
• 核心能力：TDD 测试驱动、系统化调试、代码审查、分支管理、并行代理、需求澄清
• 工作原理：通过插件注入系统提示 + 技能目录链接，让 AI 自动遵守开发铁律
• 适用场景：后端 / 前端 / 小程序 / 数据库项目，追求零 BUG、可维护、工程规范的开发

表格

类别	技能	功能
🧪 测试	test-driven-development	先写测试→再写代码→重构（RED-GREEN-REFACTOR）
	verification-before-completion	完成前必须提供验证证据
🐞 调试	systematic-debugging	四阶段调试：根因→分析→验证→修复
🤝 协作	requesting-code-review	主动发起代码审查
	receiving-code-review	合理响应审查意见
	finishing-a-development-branch	分支合并 / PR / 丢弃规范流程
	dispatching-parallel-agents	多任务并行代理调度
	brainstorming	需求澄清、苏格拉底式对话
	writing-plans	生成精确开发计划（文件路径 + 代码 + 验证）
	executing-plans	批量执行开发计划
	code-structure	项目结构规范
	naming-conventions	命名规范
	error-handling	错误处理规范
🧩 元技能	using-superpowers	Superpowers 使用指南
	writing-skills	自定义技能开发

• 已安装 OpenCode.ai（最新版）
• 已安装 Git（克隆仓库用）
• Windows：开启 开发者模式 或 管理员权限（创建符号链接）

• 方式 A（推荐・新版）：opencode.json 配置自动安装（1 行配置）
• 方式 B（兼容・旧版）：手动克隆 + 符号链接（全平台通用）

找到 OpenCode 配置文件：

• macOS/Linux：~/.config/opencode/opencode.json
• Windows：%USERPROFILE%.configopencodeopencode.json

添加 plugin 字段（无则新增，有则追加）：

{
  "plugin": [
    "superpowers@git+https://github.com/obra/superpowers.git"
  ]
}

• 完全退出 OpenCode（进程结束）
• 重新启动 → 自动下载、安装、注册所有技能

在 OpenCode 聊天框输入：

Tell me about your superpowers

✅ 成功：返回 Superpowers 技能列表、功能说明❌ 失败：重启 OpenCode 或检查配置文件格式

# 克隆（已存在则更新）
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

mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills

rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

# 插件链接
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js
# 技能目录链接
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

git clone https://github.com/obra/superpowers.git %USERPROFILE%.configopencodesuperpowers

mkdir "%USERPROFILE%.configopencodeplugins" 2>nul
mkdir "%USERPROFILE%.configopencodeskills" 2>nul

del "%USERPROFILE%.configopencodepluginssuperpowers.js" 2>nul
rmdir "%USERPROFILE%.configopencodeskillssuperpowers" 2>nul

# 插件链接
mklink "%USERPROFILE%.configopencodepluginssuperpowers.js" ^
"%USERPROFILE%.configopencodesuperpowers.opencodepluginssuperpowers.js"
# 技能目录链接（ Junction，无需开发者模式）
mklink /J "%USERPROFILE%.configopencodeskillssuperpowers" ^
"%USERPROFILE%.configopencodesuperpowersskills"

# 检查插件链接
ls -l ~/.config/opencode/plugins/superpowers.js
# 检查技能链接
ls -l ~/.config/opencode/skills/superpowers

✅ 成功：显示 -> 指向 Superpowers 目录

1. 输入 /skills list → 看到 superpowers/xxx 技能列表
2. 输入 /brainstorm → 触发需求澄清对话
3. 输入 /write-plan → 生成开发计划
4. 输入 /execute-plan → 批量执行代码

/brainstorm       # 需求澄清（苏格拉底式对话）
/write-plan       # 生成开发计划（文件+代码+测试）
/execute-plan     # 执行计划（自动写代码+跑测试）
/skill list       # 查看所有 Superpowers 技能
/skill superpowers/test-driven-development  # 调用TDD技能

1. 需求阶段：/brainstorm → 明确功能、技术栈、边界
2. 计划阶段：/write-plan → 生成精确任务清单
3. 开发阶段：/execute-plan → AI 自动写测试→代码→重构
4. 验收阶段：自动验证、代码审查、分支管理

# 1. 需求
/brainstorm 开发用户登录模块：手机号+密码、JWT 认证、错误处理、测试用例
# 2. 计划
/write-plan 基于上述需求，生成 TDD 开发计划
# 3. 执行
/execute-plan 按计划编写代码、单元测试、集成测试

• 问题：链接创建失败（Windows）✅ 解决：以管理员身份运行 CMD/PowerShell
• 问题：克隆慢✅ 解决：用 Gitee 镜像：https://gitee.com/mirrors/superpowers.git
• 问题：技能不显示✅ 解决：完全重启 OpenCode（结束进程）

• 问题：AI 不遵守 TDD✅ 解决：开头必加 /brainstorm 或 /skill using-superpowers
• 问题：命令无效✅ 解决：检查 /skills list 是否有 superpowers 技能
• 问题：旧版本冲突✅ 解决：清理旧链接 → 重新安装

rm -rf ~/.config/opencode/superpowers
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

• Windows：必须管理员权限或开发者模式创建符号链接
• macOS/Linux：确保 ~/.config/opencode 目录有读写权限

# macOS/Linux
cd ~/.config/opencode/superpowers && git pull
# Windows
cd %USERPROFILE%.configopencodesuperpowers && git pull

重启 OpenCode 生效

# macOS/Linux
rm -rf ~/.config/opencode/superpowers
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
# Windows
rmdir /s /q %USERPROFILE%.configopencodesuperpowers
del %USERPROFILE%.configopencodepluginssuperpowers.js
rmdir /s /q %USERPROFILE%.configopencodeskillssuperpowers

Superpowers 是 OpenCode 必备的工程化增效插件，彻底解决 AI 编码不规范、难维护、BUG 多的痛点。推荐优先用方式 A（自动安装），1 行配置搞定；Windows / 旧版用方式 B（手动）。

下一步：安装后直接用 /brainstorm 启动你的第一个 TDD 项目，体验 AI 工业级编码！

• 版本：2026.04 最新（适配 OpenCode 最新版）
• 平台：macOS/Linux/Windows 全覆盖
• 来源：官方文档 + 实测验

扩展：Open Code教程（五）| Skills 之 Superpowers 安装

相关链接：https://github.com/obra/superpowers/blob/main/.opencode/INSTALL.md

// opencode.json
{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

重启 OpenCode 后自动安装。

Bun 在 Windows 上下载 git 包时存在 SSL 证书验证问题：

error: UNABLE_TO_VERIFY_LEAF_SIGNATURE downloading tarball superpowers@github:obra/superpowers

macOS/Linux 正常，Windows 失败。

# 1. 克隆仓库（删除旧的，重新克隆）
Remove-Item -Path "$env:USERPROFILE.configopencodesuperpowers" -Recurse -Force -ErrorAction SilentlyContinue
git clone --depth 1 https://github.com/obra/superpowers.git "$env:USERPROFILE.configopencodesuperpowers"
# 2. 创建目录（公共目录，不存在才创建）
if (-not (Test-Path "$env:USERPROFILE.configopencodeplugins")) {
    New-Item -ItemType Directory -Path "$env:USERPROFILE.configopencodeplugins" | Out-Null
}
if (-not (Test-Path "$env:USERPROFILE.configopencodeskills")) {
    New-Item -ItemType Directory -Path "$env:USERPROFILE.configopencodeskills" | Out-Null
}
# 3. 复制插件文件（直接覆盖，确保最新）
Copy-Item -Path "$env:USERPROFILE.configopencodesuperpowers.opencodepluginssuperpowers.js" -Destination "$env:USERPROFILE.configopencodepluginssuperpowers.js" -Force
# 4. 创建链接（已存在则重建，确保指向正确）
if (Test-Path "$env:USERPROFILE.configopencodeskillssuperpowers") {
    Remove-Item -Path "$env:USERPROFILE.configopencodeskillssuperpowers" -Force
}
New-Item -ItemType Junction -Path "$env:USERPROFILE.configopencodeskillssuperpowers" -Target "$env:USERPROFILE.configopencodesuperpowersskills" | Out-Null

cd "$env:USERPROFILE.configopencodesuperpowers"
git pull

# 删除插件文件
Remove-Item -Path "$env:USERPROFILE.configopencodepluginssuperpowers.js" -Force -ErrorAction SilentlyContinue
# 删除 skills 链接
Remove-Item -Path "$env:USERPROFILE.configopencodeskillssuperpowers" -Force -ErrorAction SilentlyContinue
# 删除仓库
Remove-Item -Path "$env:USERPROFILE.configopencodesuperpowers" -Recurse -Force -ErrorAction SilentlyContinue

重启 OpenCode，输入：

Tell me about your superpowers

到此这篇关于OpenCode 安装 superpowers 完全攻略的文章就介绍到这了,更多相关OpenCode 安装 superpowers 内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！

到此这篇关于OpenCode 安装 superpowers 完全攻略的文章就介绍到这了,更多相关OpenCode 安装 superpowers 内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

您可能感兴趣的文章:

• IntelliJ IDEA AI Assistant 携带OpenCode保姆级安装教程