Skip to content

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 目录路径

  1. 确认 Superpowers 的 skill 目录位置:
    bash
    echo $CLAUDE_PLUGIN_ROOT
    ls "$CLAUDE_PLUGIN_ROOT/skills/"
  2. 检查 Visual Companion 相关脚本是否存在:
    bash
    find "$CLAUDE_PLUGIN_ROOT" -name "*visual*companion*" -o -name "*companion*start*"
  3. 如果脚本存在但 Claude 找不到,考虑在 CLAUDE.md 中明确指定 skill 目录的绝对路径

预防:在使用 Superpowers 进行长时间自动化任务前,先手动验证 Visual Companion 可以正常启动,避免在计划执行中途失败。

Issue#1134