验证安装：确保 Superpowers 正确加载

学完你能做什么

• 验证 Superpowers 在三大平台上的安装状态
• 检查技能和命令是否正确加载
• 快速诊断安装问题

---

你现在的困境

刚安装完 Superpowers，你可能会疑惑：

• 插件真的安装成功了吗？
• 为什么命令不出现？
• 技能真的在工作吗？
• 不同平台怎么验证？

别担心，每个平台的验证方法都不一样，但都很简单。本课教你在几分钟内确认安装状态。

---

什么时候用这一招

• ✅ 刚完成安装后
• ✅ 更新 Superpowers 后
• ✅ 疑似安装失败时
• ✅ 准备开始新项目前

---

🎒 开始前的准备

确保你已经：

• [ ] 完成了对应平台的安装步骤
• [ ] 重启了 AI 编码工具（Claude Code / OpenCode / Codex）
• [ ] 有基本的终端操作能力

---

核心思路

Superpowers 的验证核心是检查技能和命令是否可用：

平台	验证方式	检查内容
Claude Code	/help 命令	查看三个核心命令是否出现
OpenCode	符号链接检查	确认插件和技能链接正确
Codex	CLI 工具	查看可用技能列表

关键点：不同平台的验证方式不同，但目的都是确认技能系统正常工作。

---

跟我做

Claude Code 平台验证

第 1 步：检查命令是否出现

在 Claude Code 中输入：

/help

为什么

/help 命令会列出所有可用的斜杠命令，验证 Superpowers 的命令是否正确加载。

你应该看到以下三个核心命令：

命令	功能
/superpowers:brainstorm	交互式设计优化
/superpowers:write-plan	创建实施计划
/superpowers:execute-plan	批量执行计划

✅ 如果看到这三个命令，说明安装成功！

---

第 2 步：测试核心命令

输入：

/superpowers:brainstorm

为什么

验证命令不仅存在，而且能正常触发技能。

你应该看到：

• AI 不会直接开始写代码
• AI 会询问你的需求或任务
• AI 会进入 brainstorming 工作流程

✅ 如果 AI 开始问问题，说明技能系统正常工作！

---

OpenCode 平台验证

第 1 步：检查符号链接

打开终端，运行：

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

为什么

OpenCode 通过符号链接加载插件和技能，需要确认链接指向正确的位置。

你应该看到：

~/.config/opencode/plugins/superpowers.js -> ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js
~/.config/opencode/skills/superpowers -> ~/.config/opencode/superpowers/skills

✅ 如果看到符号链接（箭头 ->），说明链接创建成功！

---

第 2 步：重启并验证

重启 OpenCode，然后尝试使用技能。

为什么

OpenCode 需要在启动时加载插件，重启是必要的。

你应该看到：

• OpenCode 启动后无错误提示
• 使用 Skill 工具能访问 Superpowers 的技能

---

Codex 平台验证

第 1 步：运行 CLI 工具

打开终端，运行：

~/.codex/superpowers/.codex/superpowers-codex find-skills

为什么

Codex 的 CLI 工具会列出所有可用的技能，验证技能文件是否正确加载。

你应该看到：

一个技能列表，每个技能包含名称和描述，例如：

Available Superpowers Skills:

- brainstorming: Use when designing features - Activates before writing code...
- writing-plans: Use when implementing features with a spec - Breaks work into...
- test-driven-development: Use when implementing any feature - Enforces RED...
...

Total: X skills available

✅ 如果看到技能列表，说明安装成功！

---

第 2 步：测试技能加载

告诉 Codex：

Run ~/.codex/superpowers/.codex/superpowers-codex bootstrap

为什么

Bootstrap 命令会加载完整的技能上下文，验证技能内容是否正确。

你应该看到：

• Codex 加载完整的技能信息
• 显示技能数量和状态

---

检查点 ✅

根据你的平台，确认对应的检查点通过：

Claude Code 用户

• [ ] /help 中看到 /superpowers:brainstorm 等三个命令
• [ ] /superpowers:brainstorm 能正常触发
• [ ] AI 会进入技能工作流，不会直接写代码

OpenCode 用户

• [ ] ~/.config/opencode/plugins/superpowers.js 是符号链接
• [ ] ~/.config/opencode/skills/superpowers 是符号链接
• [ ] OpenCode 启动无错误
• [ ] 能使用 Skill 工具访问 Superpowers 技能

Codex 用户

• [ ] find-skills 命令显示技能列表
• [ ] bootstrap 命令能加载完整上下文
• [ ] 技能数量正确（应该是 14 个核心技能）

---

踩坑提醒

Claude Code：命令不出现

症状：/help 中看不到 Superpowers 命令

可能原因和解决：

1. 插件未正确安装

   • 重新运行：/plugin install superpowers@superpowers-marketplace

2. 需要重启

   • 完全退出 Claude Code 并重新打开

3. 市场未注册

   • 检查是否先注册了市场：/plugin marketplace add obra/superpowers-marketplace

---

OpenCode：符号链接不存在

症状：ls -l 显示文件或目录不存在

可能原因和解决：

1. Superpowers 未克隆

   • 检查目录：ls -l ~/.config/opencode/superpowers
   • 重新运行安装步骤

2. 链接创建失败

   • 确保你有创建符号链接的权限（Windows 需要 Developer Mode 或管理员权限）
   • 重新运行链接创建命令

3. OpenCode 未重启

   • 完全退出 OpenCode 并重新打开

---

Codex：CLI 工具无法执行

症状：运行 superpowers-codex 时提示权限错误或找不到命令

可能原因和解决：

1. 文件权限问题

   chmod +x ~/.codex/superpowers/.codex/superpowers-codex

2. Node.js 未安装

   • 确保安装了 Node.js 14 或更高版本
   • 运行：node --version

3. Superpowers 未克隆

   • 检查目录：ls -l ~/.codex/superpowers
   • 重新运行安装步骤

---

通用问题：技能数量不对

症状：显示的技能数量少于 14 个

解决：

1. 确认使用最新版本

   • Claude Code：/plugin update superpowers
   • OpenCode/Codex：cd ~/.config/opencode/superpowers && git pull

2. 检查技能目录

   ls ~/.config/opencode/superpowers/skills

   应该看到 14 个技能目录

3. 检查旧版技能残留

   • 如果有 ~/.config/superpowers/skills，说明是旧版本
   • 需要迁移或删除旧版本

---

本课小结

通过本课，你学会了：

1. ✅ Claude Code 验证：使用 /help 检查命令可用性
2. ✅ OpenCode 验证：检查符号链接和重启验证
3. ✅ Codex 验证：使用 CLI 工具列出技能
4. ✅ 常见问题排查：针对各平台的常见问题提供了解决方案

核心原则：

• 不同平台的验证方式不同，但目标都是确认技能系统正常工作
• 遇到问题时，先检查符号链接、文件权限和版本更新
• 重启是验证成功的关键步骤

---

下一课预告

下一课我们学习 技能调用规则与优先级。

你会学到：

• 技能系统的核心规则（1% 原则）
• 技能优先级和调用流程
• 刚性技能与柔性技能的区别

---

附录：源码参考

点击展开查看源码位置

更新时间：2026-02-01

功能	文件路径	行号
命令定义	commands/brainstorm.md	全文件
命令定义	commands/write-plan.md	全文件
命令定义	commands/execute-plan.md	全文件
SessionStart 钩子	hooks/session-start.sh	1-53
Codex CLI	.codex/superpowers-codex	全文件
OpenCode 插件	.opencode/plugins/superpowers.js	全文件

关键常量：

• 插件版本：4.1.1（来自 .claude-plugin/plugin.json:4）

关键函数：

• escape_for_json()：SessionStart 钩子中的 JSON 转义函数（hooks/session-start.sh:21-37）