41 added, 13 removed. Audit A to A.
---
name: clash-doctor
- description: Clash Verge 诊断与配置管理。网络诊断、配置 AI 工具路由规则（Claude/Codex/Cursor/Warp）、查看/克隆订阅配置、切换配置文件。当用户遇到网络问题、要配置代理规则、切换订阅、查看 Clash 配置时使用
+ description: >
+ Clash Verge 与 mihomo 诊断和 profile 管理。当用户遇到代理失败、需要配置
+ AI 工具路由、本地 Hub 拓扑、多机对齐、TUN 绕过、克隆或切换订阅，或同步后
+ 配置未生效时使用。进程线路使用 clash-routes，出口 IP 质量使用 ip-check。
+ 普通网络测速不使用。
allowed-tools: Bash, Read, Write, Edit, Glob, Grep
metadata:
- argument-hint: '[诊断域名 | profiles | clone <源> <目标> | setup-ai <订阅名> | switch <订阅名>]'
+ argument-hint: '[host | profiles | status | hub | align | roles | switch-check <name> | clone <src> <dst> | setup-ai <name> | switch <name> | rustdesk <IP> | bypass <IP>]'
---
# Clash Verge Diagnostics
- Use this skill for Clash Verge / Mihomo profile inspection, AI-tool route setup, active profile switching, and connectivity diagnosis.
+ Inspect Clash Verge or mihomo, manage profile-specific routing, and diagnose connectivity.
## Routing
- - Start here to confirm scope, safety boundaries, and the minimum workflow.
- - Load `references/full-guide.md` before executing detailed commands, applying templates, or relying on examples from this skill.
- - Keep the work limited to the user-requested target; do not add adjacent improvements unless the user asks.
+ - Confirm the target profile, constraints, requested access path, and done-when signal.
+ - Load `references/full-guide.md` for commands, templates, and diagnosis matrices.
+ - Load `references/local-hub.md` before `hub`, `align`, `roles`, `clone`, `setup-ai`, or `switch`, and whenever the user says a previous sync did not apply.
+ - Keep the change limited to the requested target.
- ## Quick Workflow
+ ## Safety
- 1. Confirm the target, available context, constraints, and done-when signal.
- 2. Read the relevant section of `references/full-guide.md` for task-specific details.
- 3. Execute the smallest reversible action that satisfies the request.
- 4. Verify with profile JSON/YAML parsing, Mihomo API or local connectivity probes, and a clear rollback path for any profile write.
- 5. Report changed files, commands run, evidence collected, and any remaining risk.
+ - Diagnose and align are read-only. Writes require a shown summary and explicit confirmation.
+ - Edit enhancement overlays or the confirmed local-hub YAML. Do not edit raw subscription dumps.
+ - `tun.route-exclude-address` is union-only. `DIRECT` is not a TUN bypass.
+ - Never invent or print node IPs, credentials, subscription UIDs, or machine hostnames.
+ - After an overlay or hub-YAML write, quit and reopen Clash Verge. `PUT /configs` does not re-merge overlays.
+ ## Modes
+
+ | Argument | Mode |
+ |---|---|
+ | empty or a hostname | diagnose |
+ | `profiles` / `list` / `ls` | list local and remote profiles |
+ | `status` | live kernel, TUN, and selected nodes |
+ | `hub` / `roles` | local-hub topology |
+ | `align` / `sync-check` | read-only multi-machine comparison |
+ | `switch-check` / `health` | pre-switch health |
+ | `clone` / `setup-ai` / `switch` | confirmed profile writes |
+ | `rustdesk` / `bypass` | TUN exclusion for a relay IP |
+
+ Resolve the named target before `setup-ai`. Apply airport-style enhancement overlays only when that target is `type: remote`; edit the named hub YAML when it is `type: local`.
+
+ ## Verify
+
+ - Parse the target YAML after every write.
+ - Query mihomo by trying both Unix sockets and then the configured HTTP controller; fall back on request failure, not socket existence alone.
+ - For routes, `chains[-1]` is the matched group and `chains[0]` is the dialed node.
+ - Report files changed, commands run, evidence, and remaining risk.
+
## References
- - `references/full-guide.md` - complete command patterns, examples, checklists, and edge cases.
+ - `references/full-guide.md` — commands, templates, and diagnosis matrix
+ - `references/local-hub.md` — hub ownership, node roles, alignment, and landmines