OpenCode Superpowers 插件安装与工程化使用指南

成功标志是输出中包含 "->" 且指向正确的 superpowers 目录。

激活与验证

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

1. 重启服务

退出当前会话并重新启动：

exit
opencode

2. 验证生效

重启后，在会话中输入以下指令快速验证：

do you have superpowers?

若回复确认信息（如 "Yes! I have Superpowers installed..."），则说明插件已就绪。若提示 "unknown command"，请重新检查符号链接步骤。

核心用法

Superpowers 的核心用法是'加载技能→提出需求'，所有操作都在 OpenCode 会话中完成。

查看可用技能

输入以下指令列出所有内置技能及其说明：

use skill tool to list skills

常见技能包括：

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

加载并使用技能

用法是先加载技能，再提出具体需求。

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

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

AI 会先编写完整的测试用例，再实现最小功能，最后重构代码，全程符合 TDD 规范。

示例 2：用头脑风暴梳理思路

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 和代码审查；
• 不需要时输入 unload skill superpowers/xxx 卸载；
• 需求描述越具体，AI 回复越精准。

更新与维护

Superpowers 持续更新，无需重新安装，只需拉取最新代码：

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

更新后建议再次验证插件状态。

常见问题排查

问题 1：重启后插件未生效 原因通常是符号链接失败或路径错误。请重新执行链接命令，并检查 OpenCode 插件目录是否为 ~/.config/opencode/plugins/。

问题 2：加载技能提示'skill not found' 检查技能目录链接是否正确，或尝试删除 superpowers 目录后重新克隆仓库。

问题 3：git clone 提示'permission denied' 当前用户可能无写入权限。执行 chmod -R 755 ~/.config/opencode/ 赋予权限后再试。

总结

Superpowers 插件的核心价值在于让 AI 编程从'快速打字'升级为'工程化开发'。它不需要额外学习复杂操作，安装后加载对应技能，即可让 AI 自动遵循软件工程最佳实践。对于个人开发或小团队协作，它能有效节省代码审查、调试、重构的时间，同时提升代码质量。按照上述步骤，几分钟即可完成安装与激活。