首页 > 网络编程 > 其它综合 > OpenCode 安装 superpowers

OpenCode 安装 superpowers 完全攻略

2026-04-22 09:19:07 作者：一个便士

本文介绍了如何在maccode安装超级编程技能superpowers,它让AI遵循测试驱动开发、代码规范等工程流程,生成高质量代码,文章详细讲解了maccode安装、验证、避坑等步骤,并提供了macos、linux、windows等平台的安装指南

OpenCode 安装 superpowers 技能

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

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

一、Superpowers 核心介绍

1.1 是什么

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

1.2 技能清单（14 个核心）

表格

类别	技能	功能
🧪 测试	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	自定义技能开发

二、环境准备（必看）

2.1 前提条件

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

2.2 安装方式（2 种）

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

三、方式 A：自动安装（推荐・2026 最新）

3.1 步骤 1：编辑配置文件

找到 OpenCode 配置文件：

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

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

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

3.2 步骤 2：重启 OpenCode

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

3.3 步骤 3：验证安装

在 OpenCode 聊天框输入：

Tell me about your superpowers

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

四、方式 B：手动安装（全平台通用・旧版兼容）

4.1 macOS / Linux 手动安装

步骤 1：克隆 Superpowers 仓库

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

步骤 5：重启 OpenCode → 完成

4.2 Windows 手动安装（CMD/PowerShell）

步骤 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：创建链接（管理员权限）

# 插件链接
mklink "%USERPROFILE%\.config\opencode\plugins\superpowers.js" ^
"%USERPROFILE%\.config\opencode\superpowers\.opencode\plugins\superpowers.js"
# 技能目录链接（ Junction，无需开发者模式）
mklink /J "%USERPROFILE%\.config\opencode\skills\superpowers" ^
"%USERPROFILE%\.config\opencode\superpowers\skills"

步骤 5：重启 OpenCode → 完成

五、安装验证（必做）

5.1 命令验证

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

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

5.2 OpenCode 内验证

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

六、基础使用（3 步上手）

6.1 核心命令（斜杠快捷）

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

6.2 标准工作流（TDD）

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

6.3 示例：生成登录模块

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

七、常见问题 & 避坑指南

7.1 安装失败

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

7.2 使用异常

问题：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

7.3 权限问题

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

八、更新与卸载

8.1 更新（手动版）

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

重启 OpenCode 生效

8.2 卸载

# 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%\.config\opencode\superpowers
del %USERPROFILE%\.config\opencode\plugins\superpowers.js
rmdir /s /q %USERPROFILE%\.config\opencode\skills\superpowers

九、总结

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

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

🔔 本文说明

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

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

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 后自动安装。

为什么 Windows 上用不了

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

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

macOS/Linux 正常，Windows 失败。

Windows 安装方式

安装步骤

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

更新

cd "$env:USERPROFILE\.config\opencode\superpowers"
git pull

卸载

# 删除插件文件
Remove-Item -Path "$env:USERPROFILE\.config\opencode\plugins\superpowers.js" -Force -ErrorAction SilentlyContinue
# 删除 skills 链接
Remove-Item -Path "$env:USERPROFILE\.config\opencode\skills\superpowers" -Force -ErrorAction SilentlyContinue
# 删除仓库
Remove-Item -Path "$env:USERPROFILE\.config\opencode\superpowers" -Recurse -Force -ErrorAction SilentlyContinue

验证

重启 OpenCode，输入：

Tell me about your superpowers

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

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

您可能感兴趣的文章:

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