OpenCode Superpowers 插件安装与使用全指南

五、Superpowers 基础使用教程

1. 查看所有可用技能

use skill tool to list skills

常用技能：

• superpowers/brainstorming：结构化头脑风暴；
• superpowers/tdd：测试驱动开发；
• superpowers/debugging：代码调试；
• superpowers/code-review：代码审查；
• superpowers/refactoring：代码重构。

2. 加载并使用技能

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

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

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

效果：AI 会先编写完整的测试用例，再实现满足测试的最小功能，最后重构代码优化可读性。

示例 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. 技能使用小技巧

• 可以同时加载多个技能；
• 不需要某个技能时，直接输入'unload skill superpowers/xxx'卸载；
• 提出需求时，越具体，AI 的回复越精准。

六、后续更新方法

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

更新后建议再次输入'do you have superpowers?'验证。

七、常见问题排查

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

原因：符号链接创建失败，或 OpenCode 插件目录路径错误。 解决方案：重新执行步骤 2 和步骤 3 的符号链接命令，再重启 OpenCode。

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

原因：技能目录链接错误，或 Superpowers 仓库克隆不完整。 解决方案：重新创建技能符号链接，或删除 superpowers 目录，重新克隆仓库。

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

原因：当前用户无~/.config/opencode/目录的写入权限。 解决方案：执行 chmod -R 755 ~/.config/opencode/ 赋予权限，再重新克隆。

八、总结

Superpowers 插件的核心价值，是让 AI 编程从'快速打字'升级为'工程化开发'。安装完成后，只需加载对应技能，就能让 AI 自动遵循软件工程最佳实践。不管你是个人开发，还是小团队协作，这款插件都能帮你节省代码审查、调试、重构的时间，同时提升代码质量。按照上面的步骤，即可完成安装 + 激活。

注：Superpowers 可与 Oh My OpenCode 同时安装，前者负责规范流程，后者负责自动化编排。