# Скилл /doctor для Claude Code

Разбираем новые правила работы с Claude Code, как сократить шум и расходы на контекст, а также использовать официальный навык /doctor для аудита инструкций, плагинов и проекта.

## Очисти контекст Claude Code: меньше правил, быстрее и точнее

Современные модели Claude 5 требуют не разрастания инструкций, а чистого контекста с правилами только для подтверждённых ошибок. Системный промт, Claude.md, skills, память, описания инструментов и текущий запрос одновременно влияют на работу агента; их конфликты и шум увеличивают расход токенов и ухудшают ответы. Проведи аудит через Skill /doctor, сократи ежедневные skills и разнеси знания по правильным местам: редкие процедуры — в skills, безусловные действия — в hooks. Важно не удалять правило вслепую: оставляй его, только если без него ошибка действительно возвращается.

врезка `// Важно`: текст «Раздутые Claude.md и skills могут заставить модель пропускать важные инструкции: полезные правила тонут в шуме, а конфликты между ними увеличивают время рассуждений и расход токенов.»

## 01 Что формирует контекст агента

- Системный промт: Это предзаполненные правила поведения модели, которые задаёт Anthropic; изменять их нельзя.
- Правила проекта: Claude.md добавляет инструкции репозитория. В Claude Code Work одновременно могут действовать правила из файла Claude.md и настройки проекта в приложении.
- Skills: Агент читает skills и выбирает подходящие по описанию того, когда их применять.
- Память: В контекст также попадает память: встроенная или подключённая через системы наподобие RMS и OpenClaw.
- Инструменты: Перед текущим запросом учитываются описания доступных инструментов и способ их работы.
- Текущий запрос: Твой промт — только один из слоёв контекста; остальные слои уже задают рамки выполнения задачи.

> Качество работы зависит не от объёма правил, а от чистоты и непротиворечивости всего контекста.

## 02 Почему длинные инструкции мешают

- Конфликт: Системный промт, Claude.md и текущий запрос могут требовать разного. Модель тратит токены на разрешение противоречий и выдаёт результат хуже.
- Зажатость: Старые правила часто фиксируют ограничения моделей, которые уже исчезли. Агент продолжает следовать устаревшим запретам и путается.
- Цена: Claude.md загружается при каждом новом запросе. Файл на 1000 строк заметно расходует лимит контекста и стоимость подписки.
- Шум: Правила для редких сценариев — например, одноразовой настройки email-шаблонов — не должны постоянно занимать контекст.
- Игнорирование: Чем больше второстепенного текста, тем выше риск, что реально важная инструкция будет проигнорирована.

> Не превращай Claude.md в склад всех когда-либо полезных решений.

## 03 Новая логика настройки Claude

- Самостоятельность: Формулируй требуемый результат и позволяй модели самой выбрать способ выполнения, а не заранее расписывай каждый запрет и шаг.
- Файлы: Не загружай все материалы сразу: подключай файлы только тогда, когда они нужны для конкретной задачи.
- Инструменты: Повторяющуюся информацию указывай один раз в описании инструмента, а проверку и способ реализации поручай агенту.
- Память: Не веди ручное логирование всех действий по умолчанию: автопамять и адаптация к повторным правкам во многих случаях уже справляются.
- Референсы: Заменяй бедные спеки богатыми референсами: кодом, тестами и фактами.
- Правило: Не пиши «никогда не делай X», пока нет конкретного случая, когда модель реально ошиблась именно на X.

> Меньше правил — больше самостоятельного суждения модели.

## 04 Когда правило действительно нужно

- Основание: Добавляй правило только после повторяющейся, наблюдаемой ошибки, которая мешает работе.
- Проверка: Перед сохранением инструкции спроси: если убрать эту строку, начнёт ли Claude ошибаться? Если ответ чаще всего «нет», строку убирай.
- Редкая задача: Инструкцию для действия, которое выполняется иногда, переноси из Claude.md в skill.
- Без исключений: Действие, которое должно выполняться всегда и без исключений, оформляй hook, а не обычным правилом.
- Реальный пример: Если редактор текста стабильно вносит нежелательное изменение в каждом посте, зафиксируй именно это конкретное ограничение.

> Фиксируй реальные ошибки, а не предполагаемые риски.

## 05 Аудит через Skill /doctor

- Назначение: Skill /doctor проверяет здоровье установки и приводит в порядок skills, Claude.md, MCP-серверы, плагины, медленные hooks и дубли.
- Результат: После аудита оставляй в документации только подводные камни, обоснованные решения, договорённости команды и сведения, необходимые проекту.
- Неиспользуемое: Удаляй skills и под-skills, которые не применяются в текущем проекте или читают ненужные файлы.
- Пример: В контент-системе из 63 skills фактически использовалась только часть; неиспользуемые элементы подлежат удалению.
- Применение: Проверяй не только кодовые базы: аудит подходит и для репозиториев баз знаний, включая структуры с графами знаний.

> Аудит должен сокращать контекст до решений, которые реально помогают выполнять задачи.

## 06 Лимиты и сокращение ежедневных skills

- Обрезка: Описание skill вместе с блоком о том, когда его использовать, обрезается на границе лимита символов.
- Листинг: На весь листинг skills отводится только 1% окна контекста.
- Токены: После сжатия доступны 25 000 входных и 5 000 выходных токенов.
- Риск: Слишком длинное описание skill не делает задачу понятнее: важные детали могут быть пропущены, а модель начинает путаться.
- Приоритет: Особенно сокращай skills, которые запускаются каждый день: лишний контекст ежедневно накапливает ожидание и снижает качество.

> Длинный ежедневный skill превращает каждую задачу в лишнее ожидание.

## 07 Шесть шагов очистки

- Контекст: Запусти просмотр контекста и выясни, что именно сейчас занимает место в Claude.
- /doctor: Запусти Skill /doctor и изучи его аудит skills, Claude.md, MCP-серверов, плагинов, hooks и дублей.
- Claude.md: Пройди файл построчно и удали каждую инструкцию, без которой ошибки не начинают происходить чаще.
- Skills: Перенеси в skills инструкции, которые нужны лишь время от времени, а не на каждом запросе.
- Hooks: Перенеси в hooks действия, обязательные всегда и без исключений.
- Дубли: Объедини два skills, выполняющих одну функцию, в один; при необходимости оставь один skill оркестратором.

> Убирай всё, что не меняет результат, и сохраняй только проверенные ограничения.

---

Источник: https://localhost:3000/m/%D1%81%D0%BA%D0%B8%D0%BB%D0%BB-doctor-%D0%B4%D0%BB%D1%8F-claude-code