用途：skill-doctor 是 Claude Octopus 的环境诊断技能，用于在问题影响工作流前发现配置错误。适用于排查故障、安装或更新插件后、演示或重要工作流运行前，以及检查提供商认证、调度器、钩子和技能配置。首次配置应使用 /octo:setup，项目状态用 /octo:status，应用代码调试用 /octo:debug。
主要能力：运行 15 类检查，包括 providers（Claude Code 版本、Codex CLI、Antigravity CLI、Perplexity API key、Ollama、熔断器状态、回退历史）、companions、auth、config、updates、state、smoke、hooks、scheduler、skills、conflicts、agents、recurrence、cache、installation。可识别配置错误的提供商、过期的插件版本、无效插件组装、不可写状态、非终止运行记录、孤儿进程、损坏钩子等。
使用方式：先解析插件根目录，再运行诊断。完整诊断命令为 bash "$OCTO_PLUGIN_ROOT/scripts/orchestrate.sh" doctor --verbose。可按类别过滤，如 doctor providers、doctor auth、doctor config、doctor hooks、doctor scheduler、doctor skills、doctor cache、doctor installation 等。支持 --verbose 与 --json 输出。依赖检查用 bash "$OCTO_PLUGIN_ROOT/scripts/install-deps.sh" check，缺失时可用 install 安装。providers --live 会发起一次真实请求验证 AGY 能力，不应在启动钩子或例行预检中运行。
修复：发现可修复问题时必须用 AskUserQuestion 提供修复选项。稳定根修复需先 repair --dry-run 展示变更，用户明确授权后才可 repair --apply。缓存清理、过期 PID 清理、登录流程、包安装和插件更新均需显式确认。配置修复须使用校验过的临时文件与原子重命名。
限制：安装类别只报告稳定根缺失或不匹配，不自动修复。未知标志、未知类别或多个类别参数会以退出码 2 报错，不应重试为全量扫描。Windows Git Bash 下不提供 rtk init -g，钩子检查报告为跳过。远程会话中跳过提供商探测，不建议在远程会话内进行交互式登录。资料未提供具体收费与价格信息。