用途：诊断并修复 TinyFish 的 MCP 注册、认证与连通性问题。核心是运行 TinyFish CLI 自带的 doctor（CLI 0.22+），执行它无法完成的一项检查，并依据返回结果处理。不要手工编辑配置文件，所有修复都走 CLI。
主要能力：运行 npx -y @tiny-fish/cli@latest doctor 后，stdout 输出 JSON，含 schema_version、cli_version、ok_harnesses、ok_cli、checks[]、harnesses[]、repairs[]。先读 schema_version：本技能描述版本 3；高于 3 时停止解读字段，改展示 --pretty 输出；低于 3 时只读 checks[] 和退出码。ok_harnesses 表示智能体能否访问 TinyFish，ok_cli 表示 CLI 自身凭据是否可用，两者独立。退出码 0 为无 harness 检查失败，1 为有 harness 检查失败，2 为 doctor 无法运行（stdout 为空，原因在 stderr）。warn 不算失败，也不改变退出码。
使用方式：无 shell 的环境（如 Claude.ai、Desktop、Cowork）无法运行 npx，可跳过命令检查并把命令交给用户自行运行。第二步是 doctor 无法完成的部分：不带 --harness 运行，读取与当前智能体匹配的 harnesses[] 条目，先看 detected；未安装的会显示 detected: false、registered: "no"，并非故障。先统计 TinyFish 服务器数量，再用一次廉价查询调用 search，看哪个服务器应答。接着执行修复：只运行 repairs[] 中出现的命令，运行前先展示；命令以 tinyfish 开头时，无全局安装则替换为 npx -y @tiny-fish/cli@latest；保持顺序，auth-login 在 connect 之前。有用户在场用 npx -y @tiny-fish/cli@latest doctor --fix，非交互用 npx -y @tiny-fish/cli@latest doctor --fix --yes；unattended_safe: false 的修复交给用户，不要运行，跳过不等于已修复。OAuth 凭据失败需在 harness 内重新认证：OpenCode 用 opencode mcp auth tinyfish，Claude Code 用 /mcp 或 claude mcp login tinyfish，Grok 在 Grok Build 中 /mcps 选择 tinyfish 按 i，OpenClaw 与 Cursor 先用 tinyfish auth login 再 tinyfish connect <harness>；Codex、Hermes 无登录命令，首次使用工具时触发浏览器登录。
适用场景与限制：适用于排查 TinyFish 注册、认证与连通故障的智能体环境。限制：doctor 只识别 claude-code、codex、cursor、grok、hermes、openclaw、opencode，其他环境无对应条目；doctor 只看名为 tinyfish 的服务器，看不到同级注册。仍未解决时，按原样附上 doctor 的 stdout JSON，不要自建报告或粘贴配置内容；随后可在 https://github.com/tinyfish-io/tinyfish-cookbook/issues 提交。