脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网络编程 → 其它综合 → 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-superpowersSuperpowers 使用指南
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 内验证

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

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

6.1 核心命令（斜杠快捷）

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

6.2 标准工作流（TDD）

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

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 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • 如果你有这33种症状了请离开电脑去走走吧!

    如果你有这33种症状了请离开电脑去走走吧!

    这篇文章主要介绍了如果你有这33种症状了请离开电脑去走走吧!本文是关注程序员、上班族身心健康的文章,需要的朋友可以参考下
    2014-09-09
  • 软件测试面试如何测试一个杯子

    软件测试面试如何测试一个杯子

    本文主要介绍软件测试面试如何测试一个杯子,这里帮大家整理了详细的面试资料，和面试需要准备的知识点，有兴趣的小伙伴可以参考下
    2016-08-08
  • 如何用Idea或者webstorm跑一个Vue项目(步骤详解)

    如何用Idea或者webstorm跑一个Vue项目(步骤详解)

    这篇文章主要介绍了如何用Idea或者webstorm跑一个Vue项目，本文分步骤给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2021-02-02
  • Windows下安装Git

    Windows下安装Git

    这篇文章介绍了Window下安装Git的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2022-04-04
  • Ceph集群CephFS文件存储核心概念及部署使用详解

    Ceph集群CephFS文件存储核心概念及部署使用详解

    这篇文章主要为大家介绍了Ceph集群CephFS文件存储核心概念及部署使用详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2022-10-10
  • Prometheus配置解析小结

    Prometheus配置解析小结

    本文主要介绍了Prometheus配置解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-05-05
  • Caffe图像数据转换成可运行leveldb lmdb文件

    Caffe图像数据转换成可运行leveldb lmdb文件

    这篇文章主要为大家介绍了Caffe图像数据转换成可运行leveldb lmdb文件教程，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2022-06-06
  • JAVA IDEA入门使用手册(新手小白必备)

    JAVA IDEA入门使用手册(新手小白必备)

    IDEA的每一个方面都是为了最大限度地提高开发人员的工作效率而设计的，本文主要介绍了JAVA IDEA入门使用手册，帮助新手更好的入门，感兴趣的可以了解一下
    2021-05-05
  • ChatGPT平替-ChatGLM环境搭建与部署运行效果

    ChatGPT平替-ChatGLM环境搭建与部署运行效果

    这篇文章主要介绍了ChatGPT平替-ChatGLM环境搭建与部署运行,本节将介绍环境搭建与基本部署效果，结合实例代码给大家介绍的非常详细，需要的朋友可以参考下
    2023-05-05
  • cnpm不是内部命令的解决方案：配置环境变量【推荐】

    cnpm不是内部命令的解决方案：配置环境变量【推荐】

    这篇文章主要介绍了cnpm不是内部命令的解决方案：配置环境变量的相关知识，本文给大家介绍的非常详细，具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-07-07

最新评论