Appearance
Claude Code Opus 反复找不到 Visual Companion 启动脚本
问题
使用 Claude Code Opus 时,Superpowers 的 Visual Companion(可视伴侣)功能频繁报告找不到启动脚本,表现为:
- Visual Companion 无法启动
- Claude 提示找不到
visual_companion_start.sh或类似脚本文件 - 在自动化程度较高的场景(全自动 agent 执行计划时)更容易触发
疑似原因:Opus 在执行 skill 时对路径的推断方式与其他模型略有不同,或者在 skill 目录变化后没有正确更新内部缓存的路径。
解决方案
立即绕过:当 Opus 提示找不到脚本时,可以直接问它"为什么无法在 skill 目录中找到这个脚本"(维护者的建议),这样能获取更多调试信息。
检查 skill 目录路径:
- 确认 Superpowers 的 skill 目录位置:bash
echo $CLAUDE_PLUGIN_ROOT ls "$CLAUDE_PLUGIN_ROOT/skills/" - 检查 Visual Companion 相关脚本是否存在:bash
find "$CLAUDE_PLUGIN_ROOT" -name "*visual*companion*" -o -name "*companion*start*" - 如果脚本存在但 Claude 找不到,考虑在
CLAUDE.md中明确指定 skill 目录的绝对路径
预防:在使用 Superpowers 进行长时间自动化任务前,先手动验证 Visual Companion 可以正常启动,避免在计划执行中途失败。
Issue:#1134