OpenCode Superpowers 插件安装与使用指南

验证结果应包含'->'，且指向正确的 superpowers 目录（比如 ~/.config/opencode/superpowers/…），说明链接创建成功。

激活与验证

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

重启 OpenCode

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

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

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

验证插件是否生效

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

do you have superpowers? 

若收到类似回复，说明验证成功：

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'，大概率是符号链接创建失败，重新执行注册插件和关联技能目录的命令，再重启 OpenCode 即可。

加载与使用技能

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

查看可用技能

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

use skill tool to list skills 

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

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

实战示例

用法很简单：先加载技能，再提出具体需求，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 会按'拆解需求→发散思路→收敛方案'的流程，给出结构化的思路，比如核心功能、技术选型、新手友好型设计细节，避免思路零散。

使用技巧

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

更新维护

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

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

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

常见问题

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

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

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

解决方案：重新执行注册插件和关联技能目录的符号链接命令，再重启 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 自动遵循软件工程最佳实践。

不管你是个人开发，还是小团队协作，这款插件都能帮你节省代码审查、调试、重构的时间，同时提升代码质量。按照上面的步骤，几分钟就能完成安装 + 激活，实际体验会有明显提升。