23:40, 14 февраля. Пятый черновик за день ушёл клиенту в Берлин. Ответ пришёл через четыре минуты: «Всё ещё слишком сухо, добавь примеры».
Я закрыл ноутбук и просто сидел в темноте.
Три недели я переписывал техническую документацию для немецкого стартапа. Фикс был закрыт, переделки не оплачивались, и каждый новый комментарий клиента просто съедал мои часы.
Я пробовал всё что знал. Менял структуру. Добавлял заголовки. Делал текст короче, потом длиннее. Просил Claude «сделать более живым» - и получал тот же академический тон, только с другими словами.
Проблема была не в инструменте. Проблема была в том, как я его спрашивал.
Я формулировал задачи примерно так: «Перепиши этот раздел, сделай его понятным и добавь примеры». Звучит нормально, правда? Но это всё равно что сказать художнику «нарисуй красиво». Инструкция есть, результата нет.
ChatGPT, Claude, любая модель - они не читают твои мысли. Они отвечают ровно на тот вопрос, который ты задал. Если вопрос размытый - ответ будет размытым. Я три недели задавал размытые вопросы и удивлялся, почему документация выходит деревянной.
И самое болезненное - я не понимал, что именно делаю не так. Просто чувствовал что что-то не так. Это худшее состояние для работы.
Я собрал промпты по этой теме в PDF. Забери бесплатно: https://t.me/airozov_bot
Я не мог спать. Листал Twitter и наткнулся на чужой промпт. Человек писал что-то про документацию, и в его примере была конструкция: «напиши от лица инженера, который объясняет другу за кофе».
Я скопировал, подставил свой раздел, нажал Enter.
Через 40 секунд получил текст, который не нужно было переписывать.
Клиент ответил утром одним словом: «Идеально». Без правок. Впервые за три недели.
Так что конкретно изменилось в промпте - вот три вещи, которые я с тех пор использую в каждом сложном задании.
Роль + контекст + ограничение. Не просто «объясни», а «объясни как инженер с 10 годами опыта, который пишет для коллеги без технического бэкграунда, максимум 3 абзаца». Роль задаёт тон. Контекст задаёт глубину. Ограничение убирает воду.
Пример нужного результата прямо в промпте. Это меняет всё. Вместо «напиши живо» я пишу «напиши в таком стиле: [вставляю 2-3 предложения из текста который мне нравится]». Модель понимает точно что я хочу - не интерпретирует, а копирует паттерн.
Итерация через уточнение, не через переписывание. Раньше я получал плохой результат и начинал промпт заново. Теперь я пишу «хорошо, но вот эта часть слишком формальная - переделай только её, сохрани всё остальное». Это экономит примерно 40% времени на каждой задаче где нужна итерация.
Эти три вещи я применяю сейчас на каждом проекте. Не только для документации - для кода, для писем клиентам, для технических спецификаций. Результат стабильный: первый черновик который не надо переписывать с нуля.
Большинство гайдов учат тебя техникам. Chain-of-thought, few-shot prompting, role prompting. Я тоже их знаю. Они работают.
Но настоящий инсайт не в технике.
Я потратил три недели не потому что не знал конструкцию «объясни как инженер за кофе». Я потратил три недели потому что не понимал, какую задачу реально решаю.
Я думал что решаю задачу «написать понятную документацию». На самом деле задача была «передать ощущение разговора с экспертом, а не чтение мануала». Это разные задачи. И промпт для них нужен разный.
Промпт-инжиниринг - это не про то как правильно написать инструкцию. Это про то как правильно сформулировать задачу для себя. Если ты понимаешь что именно хочешь получить - промпт пишется за минуту. Если не понимаешь - ты будешь переписывать его бесконечно и получать «почти то».
Я видел людей которые покупают курсы по промптингу за $200-400 и всё равно получают плохие результаты. Потому что курс учит шаблонам, а не мышлению. Шаблон без понимания задачи - это просто другой способ задать неправильный вопрос.
С тех пор у меня есть привычка: перед тем как писать промпт, я трачу 2 минуты и пишу в блокноте «что конкретно должен почувствовать человек который прочитает этот текст». Не что он должен узнать - что почувствовать. Это звучит странно для технической работы, но именно это даёт нужное направление.
Каждый день разбираю один такой инструмент в Telegram: https://t.me/yevheniirozov
Возьми любую задачу которую ты уже несколько раз переделывал и никак не можешь закрыть.
Зайди на claude.ai и напиши вот так:
«Ты [конкретная роль - например "старший разработчик" или "редактор Forbes"]. Тебе нужно [задача] для [кто будет читать]. Вот пример тона который мне нравится: [2-3 предложения из любого текста который ты считаешь хорошим]. Напиши [что именно], максимум [ограничение по объёму или формату].»
Это не магия. Это просто правильный вопрос.
Разница между тем что ты получишь сейчас и тем что получал раньше - это и есть промпт-инжиниринг на практике.
• [Один промпт заменил мне 3 часа работы каждый день](https://telegra.ph/Odin-prompt-zamenil-mne-3-chasa-raboty-kazhdyj-den-04-29-2)
• [Как я сэкономил на дизайнере с одним промптом в Midjourney](https://telegra.ph/Kak-ya-sehkonomil-na-dizajnere-s-odnim-promptom-v-Midjourney-04-29)
• [Зачем платить дизайнеру, если Midjourney делает это за вас?](https://telegra.ph/Zachem-platit-dizajneru-esli-Midjourney-delaet-ehto-za-vas-04-29)
[teletype] Я установил Claude Code за 5 минут и сразу начал работать
Почему все усложняют установку Claude Code, если это 5 минут?
Почему все усложняют установку Claude Code, если это 5 минут?