Перейти к содержимому
TelegramGitHub

Claude AI Bible, глава 5: Как писать prompt

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

В четвёртой главе мы настроили аккаунт. Теперь автор учит просить Claude о работе так, чтобы получать готовый результат. Темы: пять частей сильного prompt, модель «постоянный приказ», system prompt, few-shot примеры, теги, формат, итерации, шаблоны и антипаттерны.

Пять блоков сверху: роль и контекст, задача, ограничения, формат, примеры. Стрелки ведут к блоку «Сильный prompt», от него к готовому ответу

Схема читается сверху вниз: пять частей собираются в один prompt. Если ответ плохой, ищите, какой части не хватает.

Одни продают «волшебные слова» за деньги, другие уверяют, что модели поймут любое бормотание. Автор считает, что правы обе стороны лишь наполовину. Prompt (текст-запрос к модели) решает, выбросите вы ответ или отправите клиенту, но тайных заклинаний нет.

Автор ведёт консалтинговую фирму и видел сотни новичков. Они пишут короткий размытый запрос, получают общий ответ и решают, что инструмент «скучный». Но скука возникает из-за запроса: кто дал размытое фото, получит размытую печать. Лучших результатов добиваются те, кто научился ясно говорить, что им нужно.

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

ЧастьЧто в ней
Роль и контекстКем Claude выступает и в какой ситуации работает
ЗадачаЧто сделать, выраженное глаголом, а не настроением
ОграниченияГраницы и запреты: что сделает ответ неправильным, даже если в остальном он хорош
ФорматКакой формы нужен ответ
ПримерыОдин-два образца хорошего ответа. Это самый недооценённый приём

Сравните запрос без единой части и запрос со всеми (наш пример вместо книжного):

Напиши что-нибудь про онбординг.
Ты — тимлид команды данных из 6 человек в интернет-магазине.
Напиши письмо, которое новый инженер данных получит в первый день.
Контекст: он выходит в понедельник в 10:00, его наставник — Ольга,
доступы к Snowflake и Airflow придут до обеда.
Ограничения: тепло, но без восторгов, без корпоративных слов,
до 150 слов, ничего о зарплате (это делает HR).
Формат: тема письма, текст, подпись от Ольги в одну строку.

На первый запрос придёт 500 слов пустой «воды». Второй длиннее не ради длины: каждая фраза снимает догадку, которую модели пришлось бы делать самой.

Самая дорогая привычка, по словам автора, — писать Claude как поисковику. Модель не ищет документ, а строит ответ на ваши слова, поэтому запрос из двух слов почти не задаёт ему цель. В девяти случаях из десяти виноват запрос, а исправить его дешевле всего.

Автор предлагает видеть в prompt standing order — постоянный приказ, который капитан оставляет вахтенному офицеру. Это письменная инструкция на время, пока капитан спит и спросить некого. Хороший приказ называет цель, границы («разбудите, если видимость упадёт ниже двух миль») и форму доклада, а о рутине молчит. На приказ «присматривайте за всем» офицер либо замрёт, либо начнёт импровизировать.

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

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

Слева тест постоянного приказа ведёт к блоку «Мало сказано», справа тест на перегруз ведёт к блоку «Перегруз». Стрелки «добавить нужное» и «убрать лишнее» сходятся к хорошему prompt в центре

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

User prompt — это сообщение, которое вы пишете сейчас. System prompt — постоянная инструкция над всем разговором, она влияет на каждый ответ. В API это отдельное поле, а в приложениях — пользовательские инструкции (custom instructions) и инструкции Project (о них в главе 7).

Правило простое: стабильное и повторяемое кладите в system prompt, конкретную просьбу — в user prompt. Пример автора — налоговый консультант, у которого правила ответа одни на все вопросы клиентов. Наш пример:

System prompt:
Ты — ревьюер SQL в команде данных, которая работает на DuckDB и dbt.
Объясняй так, чтобы понял аналитик без опыта в инженерии.
Если ответ зависит от данных, которых ты не видишь, скажи об этом.
Никогда не придумывай названия таблиц и колонок.
User prompt:
Почему этот запрос считает выручку дважды?
SELECT o.order_id, SUM(p.amount) FROM orders o
JOIN payments p USING (order_id) JOIN items i USING (order_id)
GROUP BY 1;

System prompt пишут один раз, и каждый следующий запрос остаётся коротким, а поведение — одинаковым в сотне разговоров.

Сверху блок system prompt, пунктирные стрелки идут от него к трём user prompt, каждый ведёт к своему ответу

Совет автора: пишите system prompt во втором лице («Ты…», «Ты никогда…») и сведите жёсткие правила в список из трёх-четырёх пунктов. Модель надёжнее следует нескольким чётким правилам, чем стене мягких пожеланий: если важно всё, то не важно ничего.

Совет «думай шаг за шагом» (chain of thought) долго помогал: модели показывали ход мысли. Современные модели рассуждают сами, когда задача этого требует, так что фраза стала привычкой, которая почти ничего не даёт. Лучше описать форму рассуждения: выписать варианты с плюсами и минусами, сначала назвать допущения или выступить за другую сторону.

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

Здесь нет «думай по шагам», зато описано, какими должны быть шаги. Для глубокого обдумывания есть extended thinking, о нём — следующая глава.

Главная привычка главы: не только объясняйте, но и показывайте. Few-shot примеры — это один-два образца нужного ответа внутри prompt, а запрос без примеров называют zero-shot. Тон хорошего ответа трудно описать словами, а по двум удачным образцам Claude сразу уловит тон, длину и ритм. Пример автора — письмо клиенту с отказом в возврате денег: с примерами ответ звучит как ваша компания, а не как безликая справочная. Наша версия:

Ответь аналитику в нашем стиле. Два прошлых ответа, которые нам нравятся:
Пример 1: «Привет, Игорь! Спасибо за запрос. Посмотрела: витрины
по возвратам пока нет, а в этом спринте мы её не успеем. Понимаю,
что ждал другого. Могу дать сырую таблицу returns с описанием полей —
прислать?»
Пример 2: «Привет, Марина! Хороший вопрос. Данные за 2023 год лежат
в архиве, и запрос к нему займёт пару дней. Если хватит последних
12 месяцев, сделаю сегодня — подойдёт?»
Теперь ответь Денису: он просит ежечасный дашборд по складам,
а данные у нас обновляются раз в сутки.

Задание автора: найдите два своих удачных текста (ответы, сводки, статусы), попросите третий и сравните с ответом без примеров.

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

Ниже сообщение пользователя и наши заметки. Напиши ответ по фактам
из заметок, но никогда не цитируй и не раскрывай сами заметки.
<user_message>
Дашборд продаж опять пустой! Завтра совет директоров.
</user_message>
<internal_notes>
Ночная загрузка упала из-за смены схемы в CRM. Перезапуск в 9:40,
данные будут к 11:00. Не называть источник сбоя.
</internal_notes>

Здесь граница видна, поэтому запрет «не раскрывать заметки» становится выполнимым. Если же кусок один, теги — просто украшение: вреда нет, но такое украшение приучает думать, что форма заменяет мысль.

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

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

Сравни три оркестратора — Airflow, Dagster и Prefect — для команды
данных из пяти человек. Выведи таблицу с колонками: Инструмент,
Для чего лучше, Порог входа, Один реальный минус. В каждой ячейке
до десяти слов. После таблицы одно предложение: что выбрал бы ты и почему.

Такой ответ можно сразу вставить в документ.

Первый prompt — черновик. Не переписывайте его целиком, меняя пять вещей сразу: так не понять, что помогло. Меняйте одно условие за раз, как при подборе рецепта. В чате часто хватает подсказки: «сделай теплее», «сократи вдвое».

Цикл: черновик prompt, ответ Claude, проверка «что не так?». Если есть проблема, одна правка и снова ответ. Если всё хорошо, prompt уходит в библиотеку

Удачный prompt сохраните: у сильного пользователя есть растущая библиотека готовых запросов. Пример автора: координатор логистики в Роттердаме много раз в день вставляла одну длинную инструкцию, чтобы превращать письма перевозчиков в записи об отгрузке. Инструкцию за 20 минут перенесли в system prompt внутри Project. Время на задачу упало примерно с четырёх минут до одной, а записи стали единообразнее. Вывод автора: хороший prompt — это актив.

Большинство запросов укладывается в несколько форм:

ШаблонЧто делаетГлавное
ПреобразованиеПереводит вход из одной формы в другую: заметки в сводку, расшифровку в задачиОписать и вход, и выход
КритикаОценивает текст по названным критериямДать критерии, чтобы отзыв был структурным
РольСтавит Claude в конкретную роль, чтобы ответ учитывал знания этой областиСм. раздел о system prompt
Варианты и выборПросит несколько вариантов, потом лучший с объяснениемПодходит для открытых задач
Сначала вопросыПросит модель задать вопросы до начала работыДопущения всплывают заранее

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

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

Антипаттерн — это привычка, которая выглядит разумно, но только тратит время. Автор называет четыре:

  1. Размытое «расскажи про». На «расскажи про маркетинг» придёт статья из энциклопедии. Добавьте цель и адресата: для кого это и какое решение оно поддержит.
  2. Перегруз. Просьба тонет в абзацах вступлений и оговорок. Оставьте то, что меняет результат, остальное уберите.
  3. Противоречивые ограничения. «Подробно, но коротко» модель не выполнит ни так, ни так. Решите, какое ограничение главнее.
  4. Судить о модели по плохому запросу. Большинство жалоб «AI не умеет X» исчезают, как только X описан нормально.

Итог автора: ремесло prompting — это умение сказать, чего вы хотите, так ясно, чтобы толковый незнакомец справился без вас.

  • В сильном prompt до пяти частей, и плохой ответ обычно значит, что одной не хватает.
  • Пишите prompt как постоянный приказ: точно, самодостаточно и без лишнего.
  • Стабильные правила храните в system prompt, а конкретную задачу пишите в user prompt.
  • Вместо «думай по шагам» описывайте, из каких шагов должно состоять рассуждение.
  • Когда описание не помогает, покажите один-два few-shot примера.
  • Теги нужны только там, где есть что разделять.
  • К каждому «не делай» добавляйте «делай», а длину задавайте проверяемо.
  • Меняйте prompt по одной правке и сохраняйте удачные.
ТерминЗначение
system promptПостоянная инструкция над всем разговором
standing orderПостоянный приказ: prompt, который работает без уточнений
few-shot примерыОдин-два образца нужного ответа внутри prompt
zero-shotЗапрос без примеров
chain of thoughtМодель рассуждает по шагам перед ответом
антипаттернПривычка, которая выглядит разумно, но тратит время
  • Ставьте Claude задачу как новому инженеру: таблица, grain, ожидаемый результат.
  • Правила команды (диалект SQL, «не придумывай колонки») держите в system prompt или в Project.
  • Храните удачные описания таблиц и ответы на запросы данных как few-shot примеры.
  • Разделяйте тегами логи, SQL и сообщение пользователя.
  1. Как по плохому ответу понять, какой части prompt не хватает?
  2. Какие ошибки ловят тест постоянного приказа и тест на перегруз?
  3. Когда правило стоит перенести в system prompt?
  4. Почему примеры передают тон лучше, чем его описание?
  5. Почему запрет работает хуже прямого указания?

Предыдущая: Планы, цены и приватность. Следующая: Продвинутые приёмы и управление рассуждением.