К основному содержанию
скилл CX Codex

clash-doctor — скилл для Claude Code: что делает и как установить

Скилл clash-doctor диагностирует сетевые сбои в Clash Verge и mihomo, правит маршруты для ИИ-инструментов и настраивает исключения TUN.

MIT 142 установок ★ 300 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add majiayu000/spellbook --skill clash-doctor -a claude-code
Открыть на GitHub

Что делает clash-doctor

Скилл проверяет состояние ядра mihomo, активные профили и цепочки узлов через сокеты Unix или HTTP-контроллер. В режиме диагностики и сверки конфигураций между машинами агент работает строго в режиме чтения. Изменения вносятся только после подтверждения пользователем.

Запись затрагивает оверлеи расширений для удалённых профилей или локальный YAML хаба. Сырые дампы подписок скилл не меняет, а при настройке обхода TUN использует параметр tun.route-exclude-address.

После сохранения оверлея или YAML-файла хаба Clash Verge нужно перезапустить вручную, так как запрос PUT /configs не пересобирает оверлеи на лету.

Какие задачи решает

  • разобрать сбой прокси и проверить статус ядра mihomo
  • настроить маршрутизацию трафика для ИИ-сервисов в профиле
  • добавить IP-адрес релея в исключения TUN через bypass
  • сравнить топологию и роли узлов на нескольких машинах
  • переключить или клонировать рабочий профиль без ручной правки дампов

Примеры запросов агенту

  • Проверь статус ядра mihomo и активные узлы через clash-doctor
  • Настрой маршруты для ИИ-инструментов в профиле remote-work через clash-doctor setup-ai
  • Добавь IP-адрес 192.168.1.50 в исключения TUN с помощью clash-doctor bypass

Как установить clash-doctor

1Через Skills CLI (Vercel)

npx skills add majiayu000/spellbook --skill clash-doctor -a claude-code

2Вручную: положить файлы

~/.claude/skills/clash-doctor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/clash-doctor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о clash-doctor

Как установить clash-doctor в Claude Code?

Выполните команду npx skills add majiayu000/spellbook --skill clash-doctor -a claude-code в терминале.

Что делает clash-doctor?

Скилл управляет профилями Clash Verge и mihomo, находит причины ошибок подключения, сверяет конфигурации узлов и готовит правила обхода TUN.

Почему после изменения оверлея требуется перезапуск Clash Verge?

Вызов PUT /configs не применяет заново правила объединения оверлеев, поэтому приложение необходимо закрыть и открыть снова.

Исходный текст

SKILL.md · MIT
---
name: clash-doctor
description: >
  Clash Verge 与 mihomo 诊断和 profile 管理。当用户遇到代理失败、需要配置
  AI 工具路由、本地 Hub 拓扑、多机对齐、TUN 绕过、克隆或切换订阅,或同步后
  配置未生效时使用。进程线路使用 clash-routes,出口 IP 质量使用 ip-check。
  普通网络测速不使用。
allowed-tools: Bash, Read, Write, Edit, Glob, Grep
metadata:
  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

Inspect Clash Verge or mihomo, manage profile-specific routing, and diagnose connectivity.

## Routing

- 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.

## Safety

- 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` — commands, templates, and diagnosis matrix
- `references/local-hub.md` — hub ownership, node roles, alignment, and landmines

© majiayu000 · MIT · majiayu000/spellbook

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
tunnel-doctor daymade Скилл tunnel-doctor для Claude Code диагностирует сбои соединения и низкую скорость на маршрутах через Tailscale, прокси, TUN, DNS и SSH-туннели. Запускается первым при проблемах с подключением через туннель или прокси. CX Codex +1 741установок network-troubleshooting Mindrally Скилл network-troubleshooting для Claude Code разбирает сетевые сбои в командах и сервисах. Запускается при ошибках DNS, TLS, прокси, соединения или тайм-аутах реестра пакетов. CX Codex +1 131установок discover-networking rand Скилл discover-networking распознаёт задачи по сетям и подключению, затем помогает находить подходящие скиллы из набора cc-polymath. Пригодится при работе с протоколами, VPN и устойчивостью соединений. CX Codex +1 120установок check-bin-obj-clash dotnet Скилл check-bin-obj-clash для Claude Code и ещё пяти платформ находит конфликты путей OutputPath и IntermediateOutputPath в проектах MSBuild. Разбирает гонки записи файлов и сбои параллельной сборки .NET. CX Codex +1 4 500установок bim-clash-detection datadrivenconstruction Скилл bim-clash-detection для Claude Code автоматически выявляет геометрические конфликты между элементами BIM-модели. Помогает обнаружить проблемы координации на этапе проектирования. CX Codex +1 184установок clash-resolution-analyzer datadrivenconstruction Скилл clash-resolution-analyzer для Claude Code разбирает отчёты о коллизиях в BIM. Он расставляет приоритеты пересечений, находит системные паттерны и назначает ответственные разделы проекта. CX Codex +1 115установок

Из того же набора13

Весь набор →
product-ux-expert Скилл product-ux-expert для проверки интерфейсов по эвристикам Нильсена, построения карт пути пользователя и аудита доступности по WCAG 2.2 AA. CX Codex +1 212установок prd-master Скилл prd-master помогает писать техспецификации, юзер-стори и критерии приёмки. Структурирует требования по RICE и MoSCoW и задаёт измеримые цели. CX Codex +1 166установок observability-sre Скилл observability-sre помогает настраивать наблюдаемость, SLO и процессы реагирования на инциденты. Подключайте его при работе с Prometheus, Grafana и OpenTelemetry. CX Codex +1 165установок database-patterns Скилл database-patterns задаёт правила связки PostgreSQL и Redis: выбор типов, индексы, работу с JSONB, стратегии кэширования и защиту от cache stampede. CX Codex +1 162установок trip-planner Скилл trip-planner для Claude Code составляет подробные планы поездок по дням: с адресами, временем в пути и вечерними списками сборов. Планирует отпуска и автопутешествия. CX Codex +1 134установок auth-security Скилл auth-security для Claude Code задаёт правила безопасной авторизации по OAuth 2.1 и RFC 9700: PKCE, ротацию refresh-токенов и строгую проверку JWT. CX Codex +1 117установок devops-excellence Скилл devops-excellence задаёт строгие правила DevOps: запрещает root в контейнерах, убирает секреты из сборки и настраивает OIDC в GitHub Actions. CX Codex +1 114установок golang-web Скилл golang-web для Claude Code, Codex и других сред кодинга, задающий архитектуру веб-приложений на Go. Он выстраивает структуру проекта, управляет зависимостями и задаёт стандарты обработки ошибок. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой