Сначала уточни, потом делай: как настроить навык Claude против додумываний

Что заложить в навык «сначала уточни»

Чтобы Claude меньше додумывал, настрой уточнение сложных вариантов через AskUserQuestion, проверку полученных ответов и работу по предоставленным документам. Дополнительно разреши признавать неуверенность и потребуй отзывать утверждения, для которых не нашлось подтверждающей цитаты.

Уточнение выбора и проверка фактов решают разные задачи

AskUserQuestion предназначен в том числе для сложных вариантов, которые трудно выбрать без контекста. Это подходящий механизм для момента, когда выполнение зависит от решения пользователя: сначала нужно получить ответ, а затем проверить, что он действительно получен.

Проверка утверждений устроена иначе. Claude можно попросить найти подтверждающую цитату для каждого утверждения уже подготовленного ответа. Если цитату найти не удалось, утверждение нужно отозвать. Здесь предмет проверки не предпочтение пользователя, а основание для написанного.

Что представляет собой сам навык

Навык состоит из каталога, в котором как минимум находится файл skill.md. Этот файл служит основой навыка; в его начале должны быть обязательные поля name и description. По описанию Claude определяет, когда навык следует вызвать.

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

• Для сложного решения предусмотрите вопрос с контекстом выбора.
• Для фактического ответа задай границу: использовать предоставленные документы.
• Для проверки результата потребуй подтверждающие цитаты.

Что проверить до создания и включения навыка

По условиям на дату проверки, 10 октября 2026 года, навыки доступны на Free, Pro, Max, Team и Enterprise при включённом выполнении кода. Возможность пользоваться навыками и возможность записывать их с экрана имеют разные условия доступа.

Доступ в Claude, Claude Code и API

Начни с проверки выполнения кода: для навыков это необходимое условие. Указание тарифа в списке поддерживаемых планов не заменяет эту настройку. В справке перечислены Free, Pro, Max, Team и Enterprise вместе с требованием включить выполнение кода.

Для пользователей Claude Code навыки также описаны как доступные в бета-версии. В API доступ распространяется на пользователей, которые используют инструмент выполнения кода. Эти условия относятся к соответствующим средам, а не к записи рабочего процесса с экрана.

Когда подходит запись рабочего процесса

На дату проверки запись навыка доступна на Pro, Max и Team в Cowork в Claude для Mac. В чате, на Windows, на Free и Enterprise этот способ недоступен. Если твоя среда входит в исключения, не ориентируйся на инструкцию с кнопкой записи.

Перед записью справка предлагает обновить Claude для Mac до последней версии. Это отдельный подготовительный шаг: сначала обновление приложения, затем работа с записью. Конкретный номер версии в этой инструкции не требуется подставлять самостоятельно.

1. Проверь, включено ли выполнение кода для использования навыков.
2. Сопоставь свой план и среду с условиями записи.
3. Обнови Claude для Mac перед записью рабочего процесса.

Ограничения из описанных инструкций на 10 октября 2026 года

Как подготовить файл навыка и архив

Если создаёшь навык через файлы, начни с каталога и skill.md. Затем подготовь обязательные сведения о навыке и упакуй каталог в ZIP. В справке отдельно оговорены ограничения полей и расположение папки внутри архива.

Какие поля нужны в начале файла

Файл skill.md должен начинаться с YAML frontmatter, то есть блока метаданных в начале файла. В этом блоке обязательны name и description. Первое поле задаёт понятное человеку имя навыка, второе описывает его назначение и помогает Claude определить момент вызова.

На дату проверки имя ограничено 64 символами, описание — 200 символами. Для description особенно важен смысл: это не просто подпись в списке навыков. Если Claude не использует навык в ожидаемой ситуации, справка рекомендует дорабатывать именно описание.

В каком порядке собрать пакет

Имя папки должно совпадать с именем навыка. При упаковке нужно сохранить предусмотренную структуру: папка навыка находится непосредственно в корне ZIP-архива. Дополнительная вложенность не соответствует указанному в справке требованию к пакету.

1. Создай каталог навыка.
2. Создай в каталоге файл skill.md.
3. Добавь в начало файла YAML frontmatter с name и description.
4. Проверь длину имени и описания.
5. Сопоставь имя папки с именем навыка.
6. Создай ZIP-архив папки навыка.
7. Проверь расположение папки в корне архива.

Что учесть при использовании API Skills

Для API Skills действует отдельное ограничение: дополнительные пакеты нельзя устанавливать во время выполнения. Зависимости должны быть заранее установлены в контейнере. Если навык опирается на такие пакеты, проверка окружения нужна до запуска соответствующей работы.

Как сформулировать правила против неподтверждённых ответов

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

Разреши признать неуверенность

Явно разреши Claude сообщать о неуверенности. По рекомендациям Anthropic, такой приём может существенно уменьшить количество ложных сведений. Практическая формулировка правила: «Если не уверен в ответе, прямо сообщи об этом». Это разрешение не заменяет последующую проверку утверждений.

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

Поставь цитаты перед выводами или после ответа

Для документов длиннее 20k токенов, то есть единиц текста, используемых моделью, рекомендовано сначала извлечь дословные цитаты и затем выполнять задачу. Сохрани условие по длине: в источнике этот порядок предложен для работы с длинными документами.

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

• Разреши Claude явно признавать неуверенность.
• Ограничи фактическую основу предоставленными документами.
• Для документов длиннее 20k токенов запроси дословные цитаты перед выполнением задачи.
• Потребуй отозвать утверждения без подтверждающих цитат.

Как расположить инструкции и примеры

В описанной Microsoft схеме сообщения распределяются между ролями system, user и assistant: инструкции управления чатом, пользовательский ввод и ответы. Источник описывает одно системное сообщение, расположенное первым; это правило нужно понимать в рамках представленной схемы.

Пользовательское сообщение может содержать запрос, примеры или инструкции. Примеры рекомендуется размещать до инструкций либо после них, не перемежая эти части. Few-shot в источнике означает несколько пар запросов и дословных образцов ответов.

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

Как задавать уточнения, на которые удобно ответить

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

Сколько вопросов и вариантов предусмотреть

В описании интерактивных команд рекомендуется предлагать от 2 до 4 вариантов ответа. Это рекомендация к устройству выбора, а не повод расширять перечень до длинного каталога. Для самостоятельной формулировки пользователя предусмотрен автоматический вариант Other.

За вызов инструмента можно задать от 1 до 4 вопросов. У краткого заголовка вопроса есть отдельное ограничение: не более 12 символов. Эти параметры относятся к описанному AskUserQuestion; условия приведены на дату проверки, 10 октября 2026 года.

• Используй AskUserQuestion для сложных вариантов, требующих контекста.
• Предложи от 2 до 4 вариантов ответа.
• Ограничь краткий заголовок вопроса 12 символами.
• Соблюдай диапазон от 1 до 4 вопросов за вызов.

Когда разрешать несколько ответов

Параметр multiSelect: true разрешает выбрать несколько вариантов. Используй его для совместимых ответов, которые можно сочетать. Для взаимоисключающих вариантов источник прямо рекомендует не использовать multiSelect.

В приведённом примере множественного выбора пользователь может не отметить ничего, выбрать часть пунктов или весь набор. Это важная особенность интерпретации ответа: отсутствие выбранных пунктов в таком примере предусмотрено самим устройством выбора.

Что делать с ответом вне предложенного списка

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

Для пути к файлу, числа или имени предусмотрен более прямой способ: аргументы команды. Источник рекомендует их для простых значений. Не превращай такую передачу данных в сложный выбор без необходимости в контексте.

Что делать после уточнения, прежде чем выполнять задачу

Сам вызов AskUserQuestion ещё не завершает уточнение. В примере после него предусмотрена проверка полученных ответов, а затем проверка конфигурации: доступны ли зависимости, совместимы ли настройки и отсутствуют ли конфликты.

Проверь, получен ли пригодный ответ

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

При этом различай некорректный ответ и допустимое отсутствие выбранных пунктов. В примере multiSelect разрешено не выбрать ничего. Оценивать результат нужно с учётом типа вопроса, а не считать отсутствие отметок автоматическим основанием для ошибки.

Проверь совместимость выбранной конфигурации

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

1. Проверь получение ответов после AskUserQuestion.
2. При пустых или некорректных ответах предложи повторную попытку либо ручной ввод конфигурации.
3. Заверши выполнение при указанной ошибке сбора ответов.
4. При пригодных ответах проверь доступность необходимых зависимостей.
5. Проверь совместимость настроек.
6. Проверь отсутствие конфликтов.

Как включить навык и понять, что он вызывается

После загрузки навык нужно включить в Customize > Skills. Затем справка рекомендует проверить его несколькими разными промптами, которые должны приводить к вызову навыка, и посмотреть, загружается ли он.

Проверь срабатывание на разных формулировках

Не ограничивай проверку одной формулировкой запроса. В справке прямо предложены несколько разных промптов, которые должны активировать навык. Такая проверка относится к ожидаемым случаям использования, поэтому заранее сопоставь запросы с назначением, записанным в description.

Для подтверждения загрузки источник предлагает просмотреть рассуждения Claude. Смысл этого шага конкретен: установить, что навык загружается. Если он не используется там, где ожидается, следующая рекомендованная правка касается описания навыка.

1. Включи загруженный навык в Customize > Skills.
2. Отправь несколько разных запросов, которые должны его активировать.
3. Проверь загрузку навыка указанным в справке способом.
4. Доработай description, если ожидаемого вызова не происходит.

Отдели вызов навыка от достоверности ответа

Подтверждение загрузки отвечает на вопрос, используется ли навык. Для проверки содержания результата есть другие рекомендации: поиск цитат, повторные запросы на проверку и сравнение нескольких ответов на одинаковый промпт. Применяй эти проверки к тексту ответа отдельно.

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

Как записать рабочий процесс в Cowork

Другой описанный способ создания навыка — запись рабочего процесса в Cowork в Claude для Mac. После завершения Claude анализирует запись и предлагает навык. У этого пути есть отдельные требования к доступу, разрешениям и содержимому экрана.

Подготовь экран и разрешения

При первой записи Claude запрашивает разрешения macOS: Accessibility для отслеживания мыши и клавиатуры и Screen recording для видимости экрана. macOS может потребовать перезапустить Claude. Это разрешения для описанного механизма записи.

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

Запусти запись и выполни процесс

Начать можно через кнопку «+» в поле ввода с выбором Record a skill. Альтернативный маршрут проходит через Customize > Skills, кнопку Add и пункт Record your screen. Выбери подходящий маршрут запуска записи.

1. Открой Cowork в Claude для Mac.
2. Нажми «+» в поле ввода.
3. Выбери Record a skill.
4. Нажми Start recording.
5. Выполни задачу привычным способом.
6. Нажми Done после завершения.

Как работают звук, завершение и отсчёт

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

На дату проверки запись может длиться около 10 минут. Примерно за минуту до конца появляется обратный отсчёт. Когда он достигает нуля, запись останавливается, а записанное отправляется Claude так же, как после нажатия Done.

Если запись не нужно использовать, нажми Discard: этот вариант удаляет её, ничего не создавая. Done, напротив, завершает запись для дальнейшей обработки. Различай эти действия до завершения демонстрации.

Прочитай предложение перед сохранением

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

Save сохраняет новый предложенный навык, Dismiss отклоняет предложение. Сохранение предложения и завершение записи — разные действия в описанном процессе: сначала Claude анализирует материал, затем показывает результат для решения пользователя.

Какие ограничения записи и среды нельзя упустить

Условия использования навыков, записи экрана и выполнения в API относятся к разным сценариям. Проверяй подходящее ограничение для своего способа работы, не перенося условия Cowork на использование навыков в целом.

Что сохраняется после демонстрации

Видео и аудио записи не сохраняются. Однако после обработки остаётся набор скриншотов из сессии. Их можно посмотреть, раскрыв шаг Recorded demonstration в задаче Cowork. Поэтому отсутствие сохранённого видео не означает отсутствие сохранённых изображений экрана.

Скриншоты хранятся в задаче Cowork. Удаление этой задачи удаляет находящиеся в ней скриншоты записи. Это конкретно описанное действие для удаления изображений; не подменяй его предположением, что сохранение или отклонение навыка решает ту же задачу.

Когда нужен другой путь создания

Если работаешь на Windows, в чате, на Free или Enterprise, описанная запись навыка недоступна. При этом перечень планов с доступом к навыкам шире. Разделяй ограничение способа создания и доступность самой функции.

Если выполняешь API Skills и рассчитываешь установить зависимости по ходу работы, такой порядок не соответствует ограничению среды. Пакеты должны быть заранее установлены в контейнере. Проверь это до запуска навыка, которому они нужны.

• Для просмотра сохранённых изображений раскрой Recorded demonstration.
• Для удаления скриншотов записи удали содержащую их задачу Cowork.
• Для API Skills проверь предварительную установку зависимостей.

Почему уточнения нужны и при высокой автономности агента

В исследовании Anthropic агент определён как система ИИ с инструментами для действий: выполнения кода, вызова внешних API и отправки сообщений другим агентам. Материал опубликован 18 февраля 2026 года и охватывает миллионы взаимодействий в Claude Code и публичном API.

Продолжительность работы не заменяет контроль решения

В исследовании медианная длительность хода Claude Code составляет около 45 секунд и в рассматриваемые месяцы колебалась между 40 и 55 секундами. Это характеристика наблюдавшихся взаимодействий, а не установленное время выполнения твоего запроса.

Для самых продолжительных ходов картина другая: с октября 2025 по январь 2026 длительность на 99.9-м процентиле выросла с менее 25 до более 45 минут. Показатель относится к указанной части распределения, поэтому его нельзя подставлять вместо медианной длительности.

Опытные пользователи и одобряют, и прерывают

По данным исследования, пользователи с менее чем 50 сессиями применяют полное автоодобрение примерно в 20% случаев. К 750 сессиям доля превышает 40%. Это наблюдение об использовании режима, а не рекомендация включать его для конкретной задачи.

Пользователи примерно с 10 сессиями прерывают Claude в 5% ходов, более опытные — примерно в 9%. В материале также указано, что настройки Claude Code по умолчанию требуют ручного одобрения каждого действия. Эти сведения относятся к описанному состоянию и наблюдениям исследования.

Сложность задачи связана с частотой уточнений

На наиболее сложных задачах Claude Code запрашивает уточнения более чем вдвое чаще, чем на задачах минимальной сложности. Это наблюдение согласуется с назначением AskUserQuestion для выбора, требующего контекста: уточнения особенно уместны там, где решение сложнее.

Большинство действий агентов в публичном API исследователи оценили как малорисковые и обратимые. Сохрани границы этого вывода: он касается большинства оценённых действий в публичном API и не является оценкой конкретной операции в твоём процессе.

Что проверить, если навык не помог

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

Исправь конкретную причину сбоя

Если навык не вызывается, вернись к description. Если ответ пользователя пустой или некорректный, используй предусмотренную повторную попытку либо ручной ввод. Если выбранные настройки не подходят окружению, проверь зависимости, совместимость и конфликты.

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

Для собственного приложения учитывай контекст разговора

Если собираешь агента в приложении, материал Microsoft описывает Agent Framework с инструментами для системных инструкций и сохранения состояния разговора между ходами. Это отдельная возможность для разработки агента, которую не следует смешивать с загрузкой пользовательского навыка в Claude.

Указанная дата обновления материала Microsoft — 13 марта 2026 года. Правила о ролях, примерах и подсказках формата в этом гайде относятся к описанию из этого материала. При работе с конкретной средой сверяй её актуальную документацию.

Что сверить на официальных страницах перед запуском

Перед использованием проверь актуальные условия своего сценария: доступность навыков на плане, требования к выполнению кода и возможность записи в Cowork. Условия здесь приведены на 10 октября 2026 года; для записи отдельно проверь ограничения среды и длительности.

После изменений снова используй несколько разных промптов для проверки вызова. Затем проверь фактический ответ цитатами или последующим запросом на проверку. Это разные части проверки, и обе предусмотрены рекомендациями источников.

Частые вопросы

Источники и проверка

• claude-code/plugins/plugin-dev/skills/command-development/references/interactive-commands.md at main · anthropics/claude-code, github.com (первоисточник). Прочитано 10 октября 2026.
• Measuring AI agent autonomy in practice, anthropic.com (первоисточник). Прочитано 10 октября 2026.
• How to create custom skills | Claude Help Center, support.claude.com (первоисточник). Прочитано 10 октября 2026.
• Reduce hallucinations, platform.claude.com (первоисточник). Прочитано 10 октября 2026.
• Prompt engineering concepts - .NET, learn.microsoft.com. Прочитано 10 октября 2026.

Подготовлено с помощью ИИ по первоисточникам и проверено автоматически: факты, числа и цитаты сверены с источниками. Человек статью перед выходом не читал. Если нашёл ошибку, напиши через контакты.