Superpowers 安装指南5 分钟修好 Claude Code 技能库报错【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers插件显示装好了AI 却一个技能都不加载安装时还报Plugin not found这篇文章带你按「确认环境 → 安装 → 排错 → 升级 → 验证」的顺序把 Superpowers 这个技能库插件的常见安装报错逐个过一遍。每个报错都给出原因和解法不用对着英文文档猜。装之前 · 30 秒确认你的环境这节解决为什么你复制的安装命令不生效因为不同客户端装法不一样。Claude Code两个安装入口Claude Code 自带插件系统不用你手动摆弄文件。你有两个入口可选官方市场直接一条命令安装Superpowers 自建市场需要先注册再安装命令见下文「装的时候」一节。✅ 自检在对话里输入/plugin确认能打开插件管理界面。Codex、OpenCode 等其他客户端各自装一份在 A 客户端装好不等于 B 客户端也有。Superpowers 要在每个客户端里单独安装。比如 OpenCode 走自己的插件管理器在opencode.json的plugin数组里登记一行 superpowers 的 git 包然后重启。这一行具体怎么写见 OpenCode 安装说明。Codex 则可以直接在它的插件市场里搜索 Superpowers 安装。Windows终端差异先看一眼Windows 上钩子的执行依赖 Git Bash——它是 Git for Windows 附带的一套小型命令行环境没装它安装会「看似成功、实际没生效」。另外 cmd.exe、PowerShell、Git Bash 三个终端的行为各有差别项目已为每种终端准备了差异说明安装前先确认你用的是哪个终端。✅ 自检运行git --version能出结果且确认机器上有 Git Bash。装的时候 · 一条命令与高频报错这节解决该敲哪条命令以及最常碰到的两个错误。最常见的路径是走 Superpowers 自建市场两行搞定/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace⚠️ 看到Plugin not found意思是客户端在已注册的市场里找不到这个包。原因通常是只敲了 install、漏了前面那行 add。解法补跑 add 那行再装一次。看到脚本里有^M之类的怪字符、或者脚本干脆不执行多半是 Windows 的 CRLF 行尾在捣乱。仓库已强制 LF 行尾本地克隆若被污染删掉重新克隆即可git clone https://gitcode.com/GitHub_Trending/su/superpowers✅ 自检重新克隆后重启客户端启动日志里不再出现 CRLF 相关报错。装完了却不好使 · 按报错对症查这节解决安装成功、技能却不生效的三个高频症状。先看报错再对号入座。Plugin hook error钩子执行失败现象会话启动时报Plugin hook errorAI 像没装过技能库一样。原因hook钩子就是在特定时机自动运行的一小段脚本。这里指hooks/目录里的 session-start 脚本负责在每个新会话开始时把「技能库使用手册」塞进 AI 的上下文。这一步失败AI 就是「装了但不知道自己有技能」。解法把 Superpowers 升到最新版——旧版本在部分终端环境下的钩子执行问题已在后续版本逐一修复更新日志里有完整记录。✅ 自检重启客户端、新开一个会话启动日志里没有 hook 报错。Bad substitution默认的 sh 是 dash现象Ubuntu/Debian 用户会在会话启动日志里看到Bad substitution。原因这类系统默认的/bin/sh是 dash不认 bash 的专属语法老版本的钩子脚本恰好用了这类写法。解法官方脚本已改写为 POSIX 兼容写法升级到最新版本即可。✅ 自检升级后新开一个会话日志中不再出现该报错。技能未找到查路径和注册现象AI 表示找不到指定技能或技能列表是空的。原因通常是两处之一——技能文件没落到客户端会读取的路径或插件注册不完整。当前版本首次运行会把技能包自动克隆到~/.config/superpowers/skills/不需要手工复制老版本留下的手工软链接要按官方文档清理否则会互相干扰。解法重启客户端仍不生效就跳到下面「验证安装」一节跑一遍自带的结构校验脚本定位。✅ 自检直接问 AI「列出你已加载的技能」输出非空即正常。从旧版本升级 · 不丢数据的迁移步骤这节解决从老安装切到新版本怎么保住已有的技能文件。三步走先手动备份旧技能目录一条命令几秒钟cp -r ~/.config/superpowers/skills ~/superpowers-skills-backup在客户端的插件管理器里执行插件更新。下次会话启动时当前版本会自己完成技能包的克隆与更新旧目录还会被自动备份成.bak文件无需手工跑任何初始化脚本。如果你用的是 OpenCode 老的「克隆仓库 软链接」装法先删掉旧软链接和旧目录再按 OpenCode 安装说明 改用插件管理器登记。老文档里提到的 setup-personal-superpowers 钩子已被内置初始化机制取代遇到也不用管。 自检升级完成后看一眼~/.config/superpowers/下的.bak备份和你的手动备份目录都在。验证安装 · 跑一遍项目自带的测试脚本这节解决如何确认「真的装好了」而不是靠感觉。项目的 测试脚本目录 按客户端分好了验证脚本。以 OpenCode 为例标准流程是先执行环境初始化脚本再跑整套用例source tests/opencode/setup.sh bash tests/opencode/run-tests.sh初始化脚本会用临时目录搭一个隔离的测试环境不碰你的真实配置整套用例里的插件加载校验会检查安装结构是否完整。Claude Code 用户则用 claude-code 测试套件它需要本机已装 claude 命令行。 自检跑完看末尾汇总出现STATUS: PASSED且没有 FAILED。还没解决三条求助路径这节解决按上面步骤走通后仍有问题往哪里找答案。查官方文档docs/ 里有各客户端的安装与使用说明更新日志记录了历史 bug 和修复方式可以确认你的问题是否已被修掉。提交 issue把客户端类型、Superpowers 版本、完整报错原文写进项目的 issue 跟踪系统信息越全回复越快。让 AI 自己查Superpowers 内置了系统化调试技能见 技能目录在对话里直接说「帮我排查技能为什么没加载」它会按步骤检查并给出结论。保持 Superpowers 在最新版本遇到问题时把报错原文保存下来——下次排查就不用对着模糊的记忆猜了。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考