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

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

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

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 оркестратором.

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