跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI

OpenCode Superpowers 插件安装与使用指南

OpenCode Superpowers 插件将软件工程最佳实践植入 AI 生成逻辑,提升代码质量与效率。安装需克隆仓库至配置目录并创建符号链接,重启后验证生效。支持 TDD、调试、重构等技能加载,通过指令调用实现自动化工程化开发流程,无需额外学习复杂操作即可规范 AI 编码习惯。

ArchDesign发布于 2026/3/27更新于 2026/10/2698 浏览
OpenCode Superpowers 插件安装与使用指南

OpenCode Superpowers 插件介绍

Superpowers 插件将软件工程最佳实践(TDD、代码审查、重构)植入 AI 生成逻辑,让 AI 从代码工具转变为工程伙伴。核心价值包括规范 AI 开发流程、技能化拆解任务、轻量无负担及兼容性强。

前置准备

  1. 已安装 OpenCode(任意稳定版本);
  2. 具备基础终端操作能力(git、ln 命令);
  3. 网络正常,可访问 GitHub。

详细安装步骤

步骤 1:克隆仓库

将 Superpowers 仓库克隆到 OpenCode 的默认配置目录:

git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
步骤 2:注册插件

创建符号链接以加载插件:

mkdir -p ~/.config/opencode/plugins
ln -sf ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/
步骤 3:关联技能目录

链接技能目录确保 AI 能调用内置技能:

mkdir -p ~/.config/opencode/skills
ln -sf ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers
步骤 4:验证安装

检查符号链接是否创建成功:

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

成功标志为输出中包含指向正确 superpowers 目录的箭头。

激活插件与验证

安装完成后必须重启 OpenCode 才能加载插件。

  1. 退出当前会话并重新启动:
exit
opencode
  1. 在会话中输入以下指令验证:
do you have superpowers?

若回复确认信息则安装成功。

基础使用教程

1. 查看所有可用技能

输入以下指令列出内置技能:

use skill tool to list skills

常用技能包括:

  • superpowers/brainstorming:结构化头脑风暴
  • superpowers/tdd:测试驱动开发
  • superpowers/debugging:代码调试
  • superpowers/code-review:代码审查
  • superpowers/refactoring:代码重构
  • 2. 加载并使用技能

    先加载技能,再提出具体需求。

    示例 1:用 TDD 技能开发 Python 函数

    use skill tool to load superpowers/tdd
    Write a Python function to calculate Fibonacci numbers using TDD approach
    

    AI 会先编写测试用例,再实现功能,最后重构代码。

    示例 2:用头脑风暴技能梳理思路

    use skill tool to load superpowers/brainstorming
    Brainstorm ideas for a Python-based AI code assistant (focus on ease of use for beginners)
    
    3. 使用技巧
    • 可同时加载多个技能;
    • 不需要时输入 unload skill superpowers/xxx 卸载;
    • 需求越具体,AI 回复越精准。

    后续更新方法

    进入安装目录拉取最新代码并重启:

    cd ~/.config/opencode/superpowers
    git pull
    exit && opencode
    

    常见问题排查

    1. 插件未生效:重新执行符号链接命令并重启 OpenCode。
    2. 提示 skill not found:检查技能目录链接或重新克隆仓库。
    3. git clone 权限 denied:执行 chmod -R 755 ~/.config/opencode/ 赋予权限。

    总结

    Superpowers 插件通过加载对应技能,让 AI 自动遵循软件工程最佳实践,节省代码审查、调试、重构时间,提升代码质量。

    目录

    1. OpenCode Superpowers 插件介绍
    2. 前置准备
    3. 详细安装步骤
    4. 步骤 1:克隆仓库
    5. 步骤 2:注册插件
    6. 步骤 3:关联技能目录
    7. 步骤 4:验证安装
    8. 激活插件与验证
    9. 基础使用教程
    10. 1. 查看所有可用技能
    11. 2. 加载并使用技能
    12. 3. 使用技巧
    13. 后续更新方法
    14. 常见问题排查
    15. 总结

    更多推荐文章

    查看全部
    • 通过 Ambari API 添加服务时解决 CSRF 保护错误的方法
    • Java JDK 安装与环境配置教程(Windows + macOS 通用)
    • 基于 AI 的实时视频字幕翻译播放器 LLPlayer 使用指南
    • 10 款 AI 生成 PPT 工具深度测评与选购指南
    • OpenClaw 配置飞书机器人完整指南
    • 《Agent Runtime 工程化》第十二章 二开毕业项目:12.5 PR 级交付标准
    • VS Code 禁用 GitHub Copilot 代码补全的方法
    • 基于 Node.js + Vue3 的社区物业管理平台技术架构与设计
    • WSDL 详解:WebService 接口描述语言入门
    • Python 抽象类与接口实现指南
    • GitHub 学生开发者包认证全流程指南
    • SSM + Vue 实战:在线投稿系统的搭建与踩坑记录
    • Windows 本地部署 Fooocus 并通过内网穿透实现公网访问
    • 飞算 JavaAI 专业版功能实测与部署指南
    • Python 异步服务器 Uvicorn 核心介绍
    • 简单的解压缩算法 (多语言实现)
    • 企业微信外部群“群机器人”主动推送消息实现指南
    • ComfyUI 安装与模型管理指南
    • 《Agent Runtime 工程化》第四章 工具系统设计:4.1 Tool Registry 的真正职责
    • SeargeSDXL AI 绘画工作流使用指南

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online