【AI开发】—— OpenCode Superpowers 插件安装+使用全指南

步骤4：安装完成验证

执行以下命令，检查两个符号链接是否创建成功：

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

✅ 成功标志：输出结果中包含'->'，且指向正确的superpowers目录（比如 ~/.config/opencode/superpowers/…），说明链接创建成功。

四、激活插件+验证安装（关键步骤）

安装完成后，必须重启OpenCode才能加载插件，这一步不能少！

步骤1：重启OpenCode

如果当前正在运行OpenCode，先退出，再重新启动：

# 退出当前OpenCode会话（若正在运行）exit# 重新启动OpenCode opencode 

重启后，Superpowers会自动注入上下文，无需额外配置。

步骤2：验证插件是否生效

重启OpenCode后，在会话中直接输入以下提问，就能快速验证：

do you have superpowers? 

✅ 验证成功：OpenCode会回复确认信息，类似这样：

Yes! I have Superpowers installed and ready to use. Available skills include: superpowers/brainstorming, superpowers/tdd, superpowers/debugging, superpowers/code-review, superpowers/refactoring.

❌ 若验证失败（无对应回复，或提示'unknown command'）：

大概率是符号链接创建失败，重新执行步骤2和步骤3的链接命令，再重启OpenCode即可。

五、Superpowers 基础使用教程（实战为王）

Superpowers的核心用法是'加载技能→提出需求'，所有操作都在OpenCode会话中完成，无需切换终端，非常便捷。

1. 查看所有可用技能

想知道有哪些技能可以用，输入以下指令：

use skill tool to list skills 

执行后，会列出所有内置技能，每个技能都有简要说明，方便你快速选择：

• superpowers/brainstorming：结构化头脑风暴，帮你发散需求思路；
• superpowers/tdd：测试驱动开发，先写测试用例，再实现功能；
• superpowers/debugging：代码调试，帮你定位并解决代码中的bug；
• superpowers/code-review：代码审查，优化代码可读性和性能；
• superpowers/refactoring：代码重构，在不改变功能的前提下优化代码结构。

2. 加载并使用技能（2个高频示例）

用法很简单：先加载技能，再提出具体需求，AI会严格按照技能对应的流程回复。

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

需求：写一个计算斐波那契数列的Python函数，要求遵循TDD流程。

# 加载TDD技能 use skill tool to load superpowers/tdd # 提出具体需求 Write a Python function to calculate Fibonacci numbers using TDD approach 

✨ 效果：AI会先编写完整的测试用例（覆盖边界条件，比如n=0、n=1、n为负数），再实现满足测试的最小功能，最后重构代码优化可读性，全程符合TDD规范，你不用再手动写测试。

示例2：用头脑风暴技能梳理项目思路

需求：梳理一个面向新手的Python AI代码助手的开发思路，重点关注易用性。

# 加载头脑风暴技能 use skill tool to load superpowers/brainstorming # 提出具体需求 Brainstorm ideas for a Python-based AI code assistant (focus on ease of use for beginners)

✨ 效果：AI会按'拆解需求→发散思路→收敛方案'的流程，给出结构化的思路，比如核心功能、技术选型、新手友好型设计细节，避免思路零散。

3. 技能使用小技巧

• 可以同时加载多个技能，比如'加载TDD+代码审查'，AI会同时遵循两个规范；
• 如果不需要某个技能，直接输入'unload skill superpowers/xxx'即可卸载；
• 提出需求时，越具体，AI的回复越精准（比如明确语言、场景、边界条件）。

六、后续更新方法（简单高效）

Superpowers会持续更新技能和功能，后续想更新插件，无需重新安装，只需拉取最新代码即可：

# 进入Superpowers安装目录cd ~/.config/opencode/superpowers # 拉取最新代码git pull # 重启OpenCode使更新生效exit&& opencode 

更新后，建议再次输入'do you have superpowers?'验证，确保新版本加载成功。

七、常见问题排查（避坑指南）

整理了3个安装使用中最容易遇到的问题，附上解决方案，帮你快速避坑：

问题1：重启OpenCode后，插件未生效

原因：符号链接创建失败，或OpenCode插件目录路径错误。

解决方案：重新执行步骤2和步骤3的符号链接命令，再重启OpenCode；若仍失败，检查OpenCode插件目录是否为 ~/.config/opencode/plugins/。

问题2：加载技能时提示'skill not found'

原因：技能目录链接错误，或Superpowers仓库克隆不完整。

解决方案：重新创建技能符号链接，或删除superpowers目录，重新克隆仓库。

问题3：终端执行git clone时提示'permission denied'

原因：当前用户无~/.config/opencode/目录的写入权限。

解决方案：执行 chmod -R 755 ~/.config/opencode/ 赋予权限，再重新克隆。

八、总结

Superpowers 插件的核心价值，是让AI编程从'快速打字'升级为'工程化开发'——它不需要你额外学习复杂的操作，安装完成后，只需加载对应技能，就能让AI自动遵循软件工程最佳实践。

不管你是个人开发，还是小团队协作，这款插件都能帮你节省代码审查、调试、重构的时间，同时提升代码质量。

按照上面的步骤，5分钟就能完成安装+激活，赶紧去试试吧！如果遇到其他问题，欢迎在评论区留言交流～

💡 最后提示：Superpowers和Oh My OpenCode可以同时安装，前者负责规范流程，后者负责自动化编排，组合使用能解锁更强大的AI编程能力！