OpenCode 安装 superpowers 技能

软件地址 https://github.com/obra/superpowers?tabcoc-ov-fileSuperpowers是 OpenCode 生态中最强大的工程化 AI 编程技能库能让 AI 严格遵循 TDD测试驱动开发、代码规范、工程流程输出可直接上线的工业级代码彻底解决 AI 编码 “堆屎山” 问题。本文提供macOS/Linux/Windows 全平台安装、验证、使用、避坑完整文档可直接发布 CSDN。一、Superpowers 核心介绍1.1 是什么定位AI 编程「工程化规范引擎」给 OpenCode 装上14 专业开发技能核心能力TDD 测试驱动、系统化调试、代码审查、分支管理、并行代理、需求澄清工作原理通过插件注入系统提示 技能目录链接让 AI 自动遵守开发铁律适用场景后端 / 前端 / 小程序 / 数据库项目追求零 BUG、可维护、工程规范的开发1.2 技能清单14 个核心表格类别技能功能 测试test-driven-development先写测试→再写代码→重构RED-GREEN-REFACTORverification-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.jsonWindows%USERPROFILE%\.config\opencode\opencode.json添加plugin字段无则新增有则追加json{ plugin: [ superpowersgithttps://github.com/obra/superpowers.git ] }3.2 步骤 2重启 OpenCode完全退出 OpenCode进程结束重新启动 →自动下载、安装、注册所有技能3.3 步骤 3验证安装在 OpenCode 聊天框输入plaintextTell me about your superpowers✅ 成功返回 Superpowers 技能列表、功能说明❌ 失败重启 OpenCode 或检查配置文件格式四、方式 B手动安装全平台通用・旧版兼容4.1 macOS / Linux 手动安装步骤 1克隆 Superpowers 仓库bash运行# 克隆已存在则更新 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创建目录不存在则新建bash运行mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills步骤 3清理旧链接避免冲突bash运行rm -f ~/.config/opencode/plugins/superpowers.js rm -rf ~/.config/opencode/skills/superpowers步骤 4创建符号链接核心bash运行# 插件链接 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克隆仓库cmdgit clone https://github.com/obra/superpowers.git %USERPROFILE%\.config\opencode\superpowers步骤 2创建目录cmdmkdir %USERPROFILE%\.config\opencode\plugins 2nul mkdir %USERPROFILE%\.config\opencode\skills 2nul步骤 3清理旧链接cmddel %USERPROFILE%\.config\opencode\plugins\superpowers.js 2nul rmdir %USERPROFILE%\.config\opencode\skills\superpowers 2nul步骤 4创建链接管理员权限cmd# 插件链接 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 命令验证bash运行# 检查插件链接 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 核心命令斜杠快捷plaintext/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 示例生成登录模块plaintext# 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技能问题旧版本冲突✅ 解决清理旧链接 → 重新安装bash运行rm -rf ~/.config/opencode/superpowers rm -f ~/.config/opencode/plugins/superpowers.js rm -rf ~/.config/opencode/skills/superpowers7.3 权限问题Windows必须管理员权限或开发者模式创建符号链接macOS/Linux确保~/.config/opencode目录有读写权限八、更新与卸载8.1 更新手动版bash运行# macOS/Linux cd ~/.config/opencode/superpowers git pull # Windows cd %USERPROFILE%\.config\opencode\superpowers git pull重启 OpenCode 生效8.2 卸载bash运行# 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 全覆盖来源官方文档 实测验