Superpowers 故障排查装完没反应、技能不触发、升级变了的完整排坑清单【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是给编码智能体Claude Code、Cursor、OpenCode 等装上一套会自动触发的开发技能头脑风暴、写计划、TDD、代码审查。这篇 Superpowers 排障指南只讲三类最常见的翻车现场——装完智能体没反应、技能点了不触发、升级后行为变了每类都给你一条真能跑通的命令和一句验收标准。 智能体装傻先确认引导注入成功Superpowers 靠每次会话开始时把 using-superpowers 技能注入模型上下文来工作。没注入时智能体不知道自己会这些但聊天一切正常所以很迷惑人。问它你有什么超能力它答不上来开个新会话直接问它What are your superpowers? 它能报出 brainstorming、test-driven-development 这些名字说明注入成功问题在下一阶段它一脸懵就是引导没进去。先手动跑一下钩子脚本bash hooks/session-start它模拟会话开始正常时输出一段包含 You have superpowers 的 JSON。看到 JSON说明脚本本身没坏去你的平台确认插件已装Claude Code 里敲/plugin看已装列表然后重启智能体再问一遍能报名字就修好了。注意手动跑脚本请用 bash用 sh 跑会冒出 Bad substitution 之类的语法报错那不是 bug。Windows 上没报错但就是没生效这是最隐蔽的一个坑钩子要靠 bash 执行机器上没有 Git Bash 时包装脚本会静默退出——插件照常安装成功注入只是没发生什么错都不报。在终端跑where bash没输出就说明 bash 缺失装一个 Git for Windows 就有了。验收标准where bash能打印路径且新会话里智能体能报出自己的技能。新版钩子明确声明用 bash 跑所以 Windows 上这一步不是可选的。 技能不触发先确认 skills 目录真被加载了技能全靠扫描skills/目录发现路径没接对就是装了个寂寞。让它做个东西它跳过 brainstorming 直接写代码先回到上一节那句你有什么超能力确认注入。注入正常仍不触发多半是平台侧配置子代理、文件读写这些工具没给智能体放开。OpenCode 用户有一条现成的自检./tests/opencode/run-tests.sh它跑插件加载和引导缓存两个免 LLM 的测试结尾看到 STATUS: PASSED 就说明加载链路完好问题回到智能体自己的权限或模型配置上。它说找不到这个技能先别慌Superpowers 自带 14 个技能名字和目录一一对应。如果你说的名字不在这个清单里它确实不存在——别自己编名字。仓库可以这样克隆下来核对git clone https://gitcode.com/GitHub_Trending/su/superpowersclone 后ls skills/就是全量技能名。若某个技能目录缺失或为空属于安装损坏用平台官方命令如/plugin install重装一次别手动拷文件——手动拷贝是在我机器上能用系列问题的根源。⏫ 升级后行为变了先对版本再读更新说明SDD 进度对不上状态目录突然变了从 6.2.0 起subagent-driven-development 的状态目录改成按计划文件划分.superpowers/sdd/计划文件名/。旧版本留下的账本不会被新版本认作当前计划的进度智能体看起来像失忆了。这是有意设计不是 bug。做法别手动合并旧账本让新计划自己生成状态目录终审通过后会自动清理。具体每项变更去 RELEASE-NOTES.md 对一眼。怎么确认这次升级真的装上了一条命令核对所有声明文件的版本号还顺带发现漂移bash scripts/bump-version.sh --check它逐个打印清单和包文件里的当前版本。每处都是同一个号比如 6.2.0说明升级完成哪个文件落后了就是那个平台装了一半对应重装一次插件再查。 修不好时怎么办先收齐信息再开口求助求助前把三样东西攥在手里一是平台名加版本以及bash scripts/bump-version.sh --check的输出二是出问题会话的完整记录标出哪句话开始不对三是自检命令的输出比如验证钩子bash tests/hooks/test-session-start.sh它逐条断言钩子输出的 JSON 形状全 PASS 就能排除注入端。顺带记一下brainstorming 可视化服务器的日志在.superpowers/brainstorm/会话号/state/server.log看到 Server failed to start within 5 seconds 通常是缺 node 或端口被占装好 node 重跑即可。去哪问问什么先去项目 issue 区搜含已关闭的大多数装不上早就被人踩过搜不到再开新 issue把上面三样信息贴全处理会快很多。实时提问可以找官方 Discord 社区。无论哪里先说清平台和--check查到的版本这是别人帮你定位的第一块拼图。顺手记下这 4 条下次少踩坑任何安装或升级之后先在新会话问一句你有什么超能力——一行验收能拦住八成装了个寂寞。Windows 先装 Git for Windows没有 bash钩子静默空转你连错都收不到。别手改智能体的全局配置文件。Superpowers 只靠各平台官方安装机制工作手动拷技能文件基本都会出岔子。开口求助前先按 docs/testing.md 跑一遍对应测试、贴上输出省你自己的时间也省维护者的。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Superpowers 故障排查：装完没反应、技能不触发、升级变了的完整排坑清单
Superpowers 故障排查装完没反应、技能不触发、升级变了的完整排坑清单【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是给编码智能体Claude Code、Cursor、OpenCode 等装上一套会自动触发的开发技能头脑风暴、写计划、TDD、代码审查。这篇 Superpowers 排障指南只讲三类最常见的翻车现场——装完智能体没反应、技能点了不触发、升级后行为变了每类都给你一条真能跑通的命令和一句验收标准。 智能体装傻先确认引导注入成功Superpowers 靠每次会话开始时把 using-superpowers 技能注入模型上下文来工作。没注入时智能体不知道自己会这些但聊天一切正常所以很迷惑人。问它你有什么超能力它答不上来开个新会话直接问它What are your superpowers? 它能报出 brainstorming、test-driven-development 这些名字说明注入成功问题在下一阶段它一脸懵就是引导没进去。先手动跑一下钩子脚本bash hooks/session-start它模拟会话开始正常时输出一段包含 You have superpowers 的 JSON。看到 JSON说明脚本本身没坏去你的平台确认插件已装Claude Code 里敲/plugin看已装列表然后重启智能体再问一遍能报名字就修好了。注意手动跑脚本请用 bash用 sh 跑会冒出 Bad substitution 之类的语法报错那不是 bug。Windows 上没报错但就是没生效这是最隐蔽的一个坑钩子要靠 bash 执行机器上没有 Git Bash 时包装脚本会静默退出——插件照常安装成功注入只是没发生什么错都不报。在终端跑where bash没输出就说明 bash 缺失装一个 Git for Windows 就有了。验收标准where bash能打印路径且新会话里智能体能报出自己的技能。新版钩子明确声明用 bash 跑所以 Windows 上这一步不是可选的。 技能不触发先确认 skills 目录真被加载了技能全靠扫描skills/目录发现路径没接对就是装了个寂寞。让它做个东西它跳过 brainstorming 直接写代码先回到上一节那句你有什么超能力确认注入。注入正常仍不触发多半是平台侧配置子代理、文件读写这些工具没给智能体放开。OpenCode 用户有一条现成的自检./tests/opencode/run-tests.sh它跑插件加载和引导缓存两个免 LLM 的测试结尾看到 STATUS: PASSED 就说明加载链路完好问题回到智能体自己的权限或模型配置上。它说找不到这个技能先别慌Superpowers 自带 14 个技能名字和目录一一对应。如果你说的名字不在这个清单里它确实不存在——别自己编名字。仓库可以这样克隆下来核对git clone https://gitcode.com/GitHub_Trending/su/superpowersclone 后ls skills/就是全量技能名。若某个技能目录缺失或为空属于安装损坏用平台官方命令如/plugin install重装一次别手动拷文件——手动拷贝是在我机器上能用系列问题的根源。⏫ 升级后行为变了先对版本再读更新说明SDD 进度对不上状态目录突然变了从 6.2.0 起subagent-driven-development 的状态目录改成按计划文件划分.superpowers/sdd/计划文件名/。旧版本留下的账本不会被新版本认作当前计划的进度智能体看起来像失忆了。这是有意设计不是 bug。做法别手动合并旧账本让新计划自己生成状态目录终审通过后会自动清理。具体每项变更去 RELEASE-NOTES.md 对一眼。怎么确认这次升级真的装上了一条命令核对所有声明文件的版本号还顺带发现漂移bash scripts/bump-version.sh --check它逐个打印清单和包文件里的当前版本。每处都是同一个号比如 6.2.0说明升级完成哪个文件落后了就是那个平台装了一半对应重装一次插件再查。 修不好时怎么办先收齐信息再开口求助求助前把三样东西攥在手里一是平台名加版本以及bash scripts/bump-version.sh --check的输出二是出问题会话的完整记录标出哪句话开始不对三是自检命令的输出比如验证钩子bash tests/hooks/test-session-start.sh它逐条断言钩子输出的 JSON 形状全 PASS 就能排除注入端。顺带记一下brainstorming 可视化服务器的日志在.superpowers/brainstorm/会话号/state/server.log看到 Server failed to start within 5 seconds 通常是缺 node 或端口被占装好 node 重跑即可。去哪问问什么先去项目 issue 区搜含已关闭的大多数装不上早就被人踩过搜不到再开新 issue把上面三样信息贴全处理会快很多。实时提问可以找官方 Discord 社区。无论哪里先说清平台和--check查到的版本这是别人帮你定位的第一块拼图。顺手记下这 4 条下次少踩坑任何安装或升级之后先在新会话问一句你有什么超能力——一行验收能拦住八成装了个寂寞。Windows 先装 Git for Windows没有 bash钩子静默空转你连错都收不到。别手改智能体的全局配置文件。Superpowers 只靠各平台官方安装机制工作手动拷技能文件基本都会出岔子。开口求助前先按 docs/testing.md 跑一遍对应测试、贴上输出省你自己的时间也省维护者的。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考