Claude Code /doctor prompt-audit: как проверить CLAUDE.md и навыки на устаревшие инструкции и что аудит нашёл у нас

/doctor prompt-audit в Claude Code — это команда, которая поручает Claude прочитать ваши файлы инструкций (CLAUDE.md, AGENTS.md, навыки, команды и т. д.), найти устаревшие или противоречащие друг другу инструкции и предложить исправления. На выходе только отчёт и предлагаемые диффы: пока вы сами не попросите Claude что-то применить, в файлах не меняется ни один символ. Команда /checkup prompt-audit запускает ровно ту же проверку.

В статье разбираем, что именно проверяет аудит промптов, как его запускать и что делать с результатами. Опираемся на оригинальный текст официальной документации Claude Code (раздел «Audit your instruction files» на странице How Claude remembers your project, а также страницы Commands и Skills), на CHANGELOG и на руководство по аудиту, которое поставляется внутри Claude Code. Всё, что касается спецификации, сверено с первоисточниками по состоянию на 3 октября 2026 г. В разделах 7 и 8 — что получилось, когда мы прогнали аудит по файлам инструкций этого сайта (9 замечаний, 7 применено), и подводные камни, на которые мы наткнулись.

1. Что такое /doctor prompt-audit: поиск устаревших и противоречивых инструкций

Claude Code при каждом запуске загружает CLAUDE.md и другие файлы инструкций. Со временем эти файлы разрастаются, и в них копятся жёсткие формулировки, написанные для старых моделей, названия файлов и команд, которых уже нет, и правила, противоречащие другому файлу. /doctor prompt-audit — команда, которая поручает Claude искать именно это.

Если кратко пересказать официальную документацию:

• Что ищет: инструкции, написанные для старых моделей, ссылки на несуществующие файлы или команды, файлы, противоречащие друг другу.
• Что возвращает: отчёт о найденных проблемах и предлагаемые исправления в виде диффов. Пока вы не попросите Claude их применить, в файлах ничего не меняется.
• Как работает: через навык /claude-api, который входит в комплект Claude Code. Если вы отключили этот навык в настройках (через skillOverrides или включив disableBundledSkills), аудит недоступен.
• Версия: Claude Code v2.1.283 или новее. /checkup prompt-audit — та же команда.

Запись v2.1.283 в CHANGELOG добавляет /doctor prompt-audit (и /checkup prompt-audit) для проверки CLAUDE.md, навыков, агентов и команд на приёмы промптинга, рассчитанные на старые модели. В том же релизе аудит научили выносить устаревшие пути, устаревшие команды и конфликтующие файлы инструкций в начало отчёта и сохранять слова, задающие глубину размышлений (например, «think»), которые Claude Code официально поддерживает.

Почему устаревшие инструкции — это проблема? Встроенное руководство по аудиту объясняет так: современные модели следуют инструкциям точнее и буквальнее, чем прежние. Нагромождение «CRITICAL» и «MUST», добавленное, чтобы старая модель не пропустила правило, теперь бьёт слишком сильно: правило применяется там, где оно не нужно, и модель становится негибкой. Руководство прямо говорит, что цель — не сократить инструкции, а найти те, что больше не подходят к текущей модели, текущему проекту или другим вашим инструкциям.

2. Как пользоваться: просто введите команду, а охват сузьте путём

Внутри сессии Claude Code достаточно ввести:

/doctor prompt-audit

Без аргумента, согласно официальной документации, проверяются такие файлы:

Чтобы проверить только один файл или папку, передайте путь. Пример из официальной документации:

/doctor prompt-audit .claude/skills/deploy

По словам встроенного руководства, аудит устроен так, чтобы доходить до конца, не останавливаясь на вопросы. Охват и то, под какую модель проверять, он определяет сам — по вашему запросу и по самим файлам — и пишет эти допущения в начале отчёта. Если допущение неверно, запустите проверку ещё раз с более узким путём. Для файлов инструкций ориентиром обычно служит модель, которая выполняет аудит (а если навык или субагент закрепляет за собой свою модель — эта модель).

Руководство также сообщает, что аудит не читает файлы настроек Claude Code (.claude/settings*.json) и конфигурацию MCP (.mcp.json), потому что в них могут быть секреты. Проблемы с разрешениями и хуками — вне этой проверки; ими занимается обычный /doctor (см. раздел 6).

3. Что аудит считает «устаревшим»

Что именно проверяет аудит, записано в руководстве, которое поставляется с Claude Code (инструкции prompt-audit внутри навыка /claude-api). Мы прочитали файлы из комплекта v2.1.286: проверки делятся на четыре группы. Для файлов инструкций основную работу делают первые две.

Внутри группы 2 к «несуществующим путям и командам» руководство относится особенно строго. Аудит проверяет, существует ли в проекте каждый путь из ваших файлов инструкций и определены ли команды и флаги в ваших скриптах или конфигурации, — читая файлы, а не запуская команды. Всё, что расходится с реальным содержимым проекта, становится замечанием с высокой уверенностью.

Когда два файла противоречат друг другу, аудит с помощью git blame (записи о том, кто и когда написал каждую строку) определяет, какой из них новее, и предлагает подогнать старый под новый. Но если одна из сторон — запрет или правило безопасности, которое исправление ослабило бы, или если по истории нельзя понять, что новее, руководство велит исправление не предлагать, а просто сообщить об этом как о решении, которое принимает пользователь.

4. Что он не удаляет: это не аудит «сделать покороче»

Больше всего в этом аудите нам понравилось, что руководство прямо перечисляет, что удалять нельзя. Оно предупреждает: аудит, который режет всё подряд, наказывает именно тех, кто писал инструкции добросовестно, — и требует оставлять следующее, даже если формулировка совпадает с шаблоном:

• Контекст, который знает только автор: факты об аудитории, продукте и окружении, планка качества, ограничения и причины, стоящие за ними. Руководство прямо говорит, что контекст никогда не бывает лишним.
• Сам объём: ничего не вырезается только за то, что длинно. Вредят устаревшие инструкции, а не их количество.
• Точные шаги для хрупких операций: работа, у которой есть лишь одна безопасная процедура (команды удаления, сценарии аутентификации), может оставаться расписанной до мелочей.
• Запреты против сбоев, которые всё ещё случаются: если сбой воспроизводится и на текущих моделях, правило остаётся.
• Работающее дублирование: одно и то же в двух местах — вопрос вкуса в организации, а не предмет аудита, пока копии не противоречат друг другу.

Работает это и в обратную сторону. Если текущим моделям пойдёт на пользу дополнительная инструкция, аудит её предложит. А если ничего не нашлось, правильный результат — ничего не менять.

5. Как читать результаты: отчёт и предлагаемые диффы

Вы получаете две вещи: отчёт аудита и предлагаемые исправления в виде диффов. У каждого замечания в отчёте шесть полей:

В предлагаемые диффы попадают только замечания с высокой и средней уверенностью. Замечания с низкой уверенностью есть только в отчёте. Диффы разбиты на отдельный фрагмент для каждого замечания, так что можно выбрать только нужные.

Чтобы применить их, попросите Claude примерно так: «примени 1, 3 и 4». Руководство также оговаривает, что противоречия между файлами и переписывание текста, не совпадающего с проектом, не применяются по общей просьбе вроде «наведи порядок во всём». Любой, у кого есть права на запись в репозиторий, мог изменить и более новый текст, и сам проект, поэтому по замыслу каждое такое замечание проверяет человек.

6. Чем он отличается от /doctor, /claude-api prompt-audit и claude doctor

Похожих по названию вещей четыре. Сравним, что о них говорят официальная документация (Commands и Skills) и CHANGELOG:

Путаница возникает из-за того, что /doctor сам тоже работает с CLAUDE.md. Разница — в цели. /doctor стремится уменьшить то, что загружается всегда (убрать дубли, вырезать то, что Claude и так видит в коде, перенести в места, которые загружаются только по необходимости). /doctor prompt-audit проверяет, не устарело ли содержимое и не противоречит ли оно само себе. Терминальный claude doctor аудит промптов не запускает.

Если Claude не следует вашим инструкциям потому, что они вообще не загружаются, этот аудит не поможет. Как проверить, что загружается, мы разбирали в статье «Почему ИИ игнорирует правила: проверяем CLAUDE.md, Cursor Rules и AGENTS.md», а как измерить, сколько контекста занимают файлы инструкций, — в статье «Claude Code: что на самом деле съедает ваш контекст».

7. Проверили на себе: аудит CLAUDE.md и AGENTS.md этого сайта

3 октября 2026 г. мы запустили /doctor prompt-audit на файлах инструкций, с которыми разрабатываем этот сайт. Запуск — в десктопном приложении Claude Code (встроенный Claude Code 2.1.286, модель Opus 5.5). Наши файлы инструкций — AGENTS.md (основные правила, общие для Claude Code и Codex) и CLAUDE.md (импортирует его и добавляет заметки, специфичные для Claude Code), вместе около 10 700 знаков. Правил, навыков или команд в .claude/ мы не держим.

Первое, что удивило: промптинга, написанного под старые модели, почти не нашлось. Ни одного «думай шаг за шагом», ни одного пошагового сценария. Большинство замечаний попали в группу 2 из раздела 3 (хрупкие файлы конфигурации).

Единственное замечание с высокой уверенностью оказалось настоящим расхождением. Добавляя инструменты проверки, мы вписали их названия в список, но забыли переписать пояснение рядом. При каждой загрузке файла Claude мог неверно понять, к чему относится «оба», а мы на глаз этого не заметили.

В отчёте также было отмечено, что аудит убедился: каждый путь, каждое название инструмента и каждая упомянутая заметка в файлах инструкций действительно существуют. Он даже сверил версию PHP (совпадает с конфигурацией Docker) и число шагов в процедуре (совпадает со списком в другом файле).

Предложенные Claude диффы мы не приняли как есть: применяли их только после того, как сверили каждый с исходными файлами. Больше всего размышлений потребовали пять замечаний средней уверенности. Аудит предлагал удалить записи об инцидентах, но именно эти записи — доказательная база, которая не даёт повторять те же ошибки, поэтому мы перенесли их, а не удалили. Если даты и счётчики уже были в другом файле, мы просто убрали их из файлов инструкций; две записи, которых больше нигде не было, скопировали в файл с записями. В итоге файлы инструкций сократились с примерно 10 700 знаков всего на 40 с небольшим. Объём почти не изменился — исчезли только противоречия.

Учтите, что это один запуск на одном проекте. Текст аудита пишет модель, поэтому повторный запуск на тех же файлах может дать другое число замечаний или другие формулировки. Проект, где в .claude/ много навыков и команд, скорее всего, получит совсем другие замечания.

8. Недостатки и подводные камни

По опыту использования и по официальной документации и руководству — пять вещей, о которых стоит помнить:

• Расходует ваш лимит использования: Claude читает и проверяет файлы инструкций внутри сессии, поэтому это списывается из лимита, как любая другая работа. Об отдельной оплате официальная документация ничего не говорит.
• Не применяйте замечания вслепую: Claude может не знать, зачем было написано правило. В нашем случае, прими мы предложение «удалить записи об инцидентах» как есть, мы бы выбросили доказательства, которые защищают от повторных ошибок.
• Результаты от запуска к запуску разные: аудит пишет модель, поэтому число и формулировки замечаний могут каждый раз меняться. Один чистый прогон — не доказательство, что в файле нет проблем.
• Файлы настроек он не смотрит: settings.json и .mcp.json не читаются, поэтому проблемы с разрешениями, хуками и MCP не всплывут. Для этого есть /doctor.
• Он не гарантирует правильность содержания: несуществующие пути и противоречия он ловит, но верна ли ваша политика, не оценивает. Это решение за вами.

Само руководство рассматривает удаления как гипотезы, а не выводы. Убрав инструкцию, нужно на реальной работе проверить, что поведение, которое она обеспечивала, не сломалось.

9. Когда запускать аудит промптов

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

• Когда переходите на новое поколение моделей: проверьте, не остались ли жёсткие формулировки и обходные решения для старых моделей
• После крупной переработки файлов инструкций: как в нашем случае, новые правила и старые пояснения легко расходятся
• Когда файлы инструкций общие для нескольких инструментов, например Claude Code и Codex: так проще заметить противоречия между AGENTS.md и CLAUDE.md

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

Итоги

/doctor prompt-audit — команда, которая ищет в ваших файлах инструкций (CLAUDE.md, AGENTS.md, навыки и другие) формулировки для старых моделей, несуществующие пути и команды и противоречащие правила, а затем возвращает отчёт и предлагаемые диффы. Она доступна в Claude Code v2.1.283 и новее, и пока вы не попросите, ничего не меняется.

Руководство по аудиту защищает от удаления контекст, причины и запреты против сбоев, которые всё ещё случаются, — чтобы проверка не превратилась в аудит «сделать покороче». Когда мы прогнали его по файлам инструкций этого сайта, устаревшего промптинга почти не нашлось, зато обнаружилось пояснение, которое мы забыли переписать после добавления правила, — настоящее расхождение.

Безопасный подход — сверять каждое замечание с исходным файлом и переносить, а не удалять, текст, у которого есть причина. Один запуск после смены модели или переработки файлов инструкций может поймать противоречия, которые вы пропустили на глаз.

FAQ

Q. /doctor prompt-audit сам перепишет мой CLAUDE.md?

A. Нет. Официальная документация говорит, что он возвращает отчёт и предлагаемые исправления, а в файлах ничего не меняется, пока вы не попросите Claude их применить. Даже тогда можно выбирать по одному предложению.

Q. Чем /doctor prompt-audit отличается от /checkup prompt-audit?

A. Ничем. /checkup — псевдоним /doctor, а запись v2.1.283 в CHANGELOG указывает /doctor prompt-audit вместе с /checkup prompt-audit.

Q. Проверяется ли AGENTS.md для Codex?

A. Да. Официальная документация называет AGENTS.md наряду с CLAUDE.md и CLAUDE.local.md среди файлов, которые проверяются без аргумента. Если эти два файла у вас общие, аудит хорошо находит и противоречия между ними.

Q. Я ввёл команду, но аудит не запускается.

A. Сначала проверьте версию: /doctor prompt-audit требует v2.1.283 или новее. Если версия подходящая, а команда всё равно не работает, проверьте, не отключили ли вы встроенный навык /claude-api в настройках (skillOverrides или disableBundledSkills). Учтите также, что claude doctor, введённый в терминале, только диагностирует установку и этот аудит не запускает.

Q. Можно ли проверить системный промпт приложения, которое я сделал на API?

A. Да, но для этого используйте /claude-api prompt-audit (v2.1.221 или новее). Он проверяет ваши промпты, описания инструментов и код вызовов API на приёмы, рассчитанные на старые модели, и предлагает диффы.

Источники

• Документация Claude Code: How Claude remembers your project (раздел «Audit your instruction files»)
• Документация Claude Code: Commands (строки /doctor и /claude-api)
• Документация Claude Code: Skills (подкоманды встроенного навыка /claude-api и требуемые версии)
• Claude Code: CHANGELOG (v2.1.283)
• Руководство prompt-audit в навыке /claude-api, входящем в комплект Claude Code v2.1.286 (проверено на нашем компьютере)

Все источники проверены в оригинале 3 октября 2026 г. Встроенное руководство обновляется с каждым релизом Claude Code, поэтому состав проверок может меняться от версии к версии.