{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Узнайте, как писать идеальные промпты для AI-ассистентов и получать качественный код с первой попытки. Полное руководство по промпт-инжинирингу для разработчиков: от простого текста до структурированных XML-запросов и управления контекстом.","type":"unstyled","key":"7pk2p"},{"data":{"image":{"id":"68f39f00fada3048da3c4cd8"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"cmhvg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Многие считают, что для генерации кода с помощью ИИ достаточно бросить в чат запрос в свободной форме. Иногда это работает. Но если вы хотите получать предсказуемый, качественный и готовый к использованию код, такой подход быстро покажет свою неэффективность. Настало время говорить с машиной на её языке — языке структуры.","type":"unstyled","key":"82teq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":35,"style":"BOLD"}],"text":"Этот подход, который можно назвать VibeCode, — не про абстрактные идеи, а про точность инструкций. Качество кода, сгенерированного AI-ассистентом, напрямую зависит от качества вашего промпта. В этой статье мы разберем, почему структурированные запросы работают лучше простого текста и как применять продвинутые техники промпт-инжиниринга в ежедневной работе.","type":"unstyled","key":"bqriq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"От Plain Text к структуре: почему простой текст не всегда работает","type":"header-two","key":"5vq67"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Существует миф: чтобы попросить ИИ написать код, достаточно набросать запрос «как есть». Но такой подход — лотерея. Модель может неверно истолковать ваши намерения, забыть важные детали или выдать код, который придется долго дорабатывать.","type":"unstyled","key":"dipnq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Почему ИИ «понимает» структурированный промпт (с тегами, отступами, чёткими блоками) лучше?","type":"unstyled","key":"t971"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"BOLD"}],"text":"Ясность ролей. Когда вы явно прописываете Ты senior Java-разработчик, ИИ не гадает, в каком стиле писать. Он сразу активирует нужную модель поведения, использует правильные конвенции и паттерны.","type":"ordered-list-item","key":"efoa4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"Разделение задач. Отдельный блок с требованиями, примером и заданием помогает модели не путать условие с контекстом. Это как дать инженеру не мешок с деталями, а подробный чертёж со схемой сборки.","type":"ordered-list-item","key":"9c758"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"Контроль формата. Хотите получить ответ в JSON, код с комментариями или готовый к компиляции модуль? Укажите это в теге . ИИ не будет добавлять лишних пояснений, если вы просите только код.","type":"ordered-list-item","key":"9f4et"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Практический пример: от хаоса к порядку","type":"header-three","key":"5qbaa"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сравним два подхода на простой задаче.","type":"unstyled","key":"9l8p2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":0,"style":"BOLD"}],"text":"Вариант 1: Plain Text","type":"unstyled","key":"f3i9u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Напиши на Java метод, который проверяет, является ли строка палиндромом. Игнорируй регистр и пробелы. С использованием StringBuilder.","type":"blockquote","key":"13i9q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Результат будет, скорее всего, рабочим, но может потребовать доработок: добавления комментариев, правильного именования и обертывания в класс.","type":"unstyled","key":"a7uqi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":35,"offset":0,"style":"BOLD"}],"text":"Вариант 2: Структурированный промпт","type":"unstyled","key":"4asm4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n Ты senior Java-разработчик, который строго следует code convention\n и пишет надежный production-ready код.\n\n\n\n Напиши публичный статический метод для проверки,\n является ли строка палиндромом.\n\n\n\n - Название метода: 'isPalindrome'\n - Параметры: 'String input'\n - Возвращаемый тип: 'boolean'\n - Игнорировать регистр символов (привести к нижнему регистру).\n - Удалить все не-буквенные символы (пробелы, знаки препинания).\n - Использовать 'StringBuilder' для разворота строки.\n - Добавить JavaDoc комментарий.\n - Продемонстрировать работу метода в методе 'main'.\n\n\n\n Предоставь готовый к компиляции Java-код класса 'PalindromeChecker'\n без лишних объяснений.\n","type":"blockquote","key":"fhq3s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Второй вариант гарантированно даст более точный и готовый к использованию результат. Меньше правок — быстрее работа.","type":"unstyled","key":"4f2t4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":0,"style":"BOLD"}],"text":"Важно: Не стоит усложнять без необходимости. Для простых задач вроде \"напиши регулярное выражение для email\" или \"объясни этот код\" достаточно простого текста. Используйте сложные форматы там, где они действительно экономят ваше время","type":"unstyled","key":"604b7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Анатомия продвинутого промпта: управление контекстом","type":"header-two","key":"er6qr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Когда задача выходит за рамки одного метода, промпт становится сложнее. Рассмотрим пример запроса на изменение бизнес-логики в существующем проекте.","type":"unstyled","key":"g61o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"70lsn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"62v8a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Цель: Внести изменения в API/бизнес-логику модуля модерации.","type":"blockquote","key":"fo1f5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Модуль: Модуль модерации 'moderation'.","type":"blockquote","key":"aor7i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Важно: не пишите тесты на этом этапе.","type":"blockquote","key":"6g9nm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Смотри архитектурные правила в @RULES.md.","type":"blockquote","key":"dd9e0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"aj7vm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"80lp1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"## Измените API POST /api/moderation/approve/{id} \"Одобрить Post для публикации\":","type":"blockquote","key":"8g5ml"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"- При публикации добавьте необязательный параметр даты и времени.","type":"blockquote","key":"fkvpr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"- Если параметр не указан, сохраните текущее время и дату в поле 'scheduledAt'.","type":"blockquote","key":"2k9g6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"- Просмотрите и используйте компоненты модуля 'moderation'.","type":"blockquote","key":"7itsj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"5lcuc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"2j99c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@ModerationController","type":"blockquote","key":"c410f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@ModerationService","type":"blockquote","key":"1ujlh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@PostRepository","type":"blockquote","key":"5hpcl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@PostEntity","type":"blockquote","key":"booab"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"bgc30"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"b4ntn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@RULES.md","type":"blockquote","key":"ab9e5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"9131h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"blockquote","key":"dpngf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"de0h7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Давайте разберем этот промпт по блокам:","type":"unstyled","key":"bh7pk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":0,"style":"BOLD"}],"text":": Задает общую картину. Мы указываем цель, рабочий модуль и важные ограничения (не писать тесты). Ссылка на @RULES.md помогает ИИ сразу понять архитектуру проекта.","type":"unordered-list-item","key":"sv07"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":0,"style":"BOLD"}],"text":": Содержит четкие, пошаговые инструкции. Вместо абстрактного \"хочу фичу\" мы декомпозируем задачу на конкретные шаги. Если задача объемная, разбивайте её на независимые части.","type":"unordered-list-item","key":"c4qms"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":0,"style":"BOLD"}],"text":": Перечисляет файлы, которые ИИ-агент должен проанализировать. В зависимости от инструмента это могут быть пути к файлам или их содержимое, вставленное в промпт (помните об ограничении на количество токенов).","type":"unordered-list-item","key":"7nvcd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":0,"style":"BOLD"}],"text":": Самый интересный блок. Сюда мы передаем артефакты проектирования — документы, описывающие правила и архитектуру приложения.","type":"unordered-list-item","key":"brqku"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@RULES.md: Контекст — это ключ","type":"header-three","key":"c66gg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Файл @RULES.md — это ваш способ «обучить» ИИ архитектуре проекта за несколько секунд. Он может содержать:","type":"unstyled","key":"15igi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":0,"style":"BOLD"}],"text":"Общие принципы: Описание модулей, их изоляции и способов взаимодействия (например, через события).","type":"unordered-list-item","key":"d7nr4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"}],"text":"Структуру каталогов: Визуальное представление проекта помогает ИИ ориентироваться в кодовой базе.","type":"unordered-list-item","key":"2dlof"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"BOLD"}],"text":"Правила именования: *Service.java в service/, *Controller.java в api/ и так далее. Это снижает вероятность того, что ИИ создаст файл не в том месте.","type":"unordered-list-item","key":"abe7m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"BOLD"}],"text":"Правила для тестов: Описание структуры тестовых директорий и используемых инструментов.","type":"unordered-list-item","key":"btjv4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Предоставив эту информацию, вы избавляете модель от необходимости сканировать весь проект и гадать, как он устроен.","type":"unstyled","key":"8sg2b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Модульная архитектура и когнитивная нагрузка","type":"header-two","key":"c76nr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Почему модульный подход так хорошо сочетается с генерацией кода ИИ? Ответ кроется в ограничениях контекста. У AI-ассистента есть лимит по токенам, а у человека — по вниманию. Модульная архитектура снижает когнитивную нагрузку для обоих.","type":"unstyled","key":"9roil"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Когда система разбита на изолированные домены (fetcher, processor, moderation), вы можете сфокусировать и себя, и ИИ на одном небольшом фрагменте логики, будучи уверенным, что изменения не сломают что-то в другом месте.","type":"unstyled","key":"bfg8j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":17,"style":"BOLD"}],"text":"Это идеально для vibe coding:","type":"unstyled","key":"c85fj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"BOLD"}],"text":"Изолированность: Чтобы \"потрогать\" фичу, вы работаете только в её модуле.","type":"unordered-list-item","key":"28h50"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"BOLD"}],"text":"Лёгкий рефакторинг: Можно переписать логику в одном модуле, не затрагивая остальные.","type":"unordered-list-item","key":"eskrq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"BOLD"}],"text":"Меньше когнитивной нагрузки: Ваш мозг (и контекст ИИ) оперирует не гигантским монолитом, а управляемым куском системы.","type":"unordered-list-item","key":"dqh6g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"PromptOps: Стандартизация промптов для командной работы","type":"header-two","key":"44ers"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":124,"style":"BOLD"}],"text":"Когда с ИИ работает целая команда, возникает проблема: как обеспечить единообразие и предсказуемость результатов? Решение — PromptOps, или стандартизация промптов.","type":"unstyled","key":"f0gnk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":3,"offset":29,"style":"BOLD"},{"length":9,"offset":54,"style":"BOLD"}],"text":"Основная идея — использовать XML как единый формат, а XSD-схемы для его валидации. XSD становится не просто валидатором, а контрактом и триггером для AI-модели:","type":"unstyled","key":"94hao"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":0,"style":"BOLD"}],"text":"Стандартизация входа: Модель получает только предсказуемые и валидные по схеме XML.","type":"unordered-list-item","key":"410m1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":0,"style":"BOLD"}],"text":"Триггеры внутри схемы: Если в XSD указано, что элемент может иметь значения CREATED | PROCESSING | PUBLISHED, это чёткий сигнал для модели, что других статусов не существует.","type":"unordered-list-item","key":"2gluc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"BOLD"}],"text":"Расширяемость: Добавили в схему новый обязательный элемент — теперь он должен быть во всех промптах.","type":"unordered-list-item","key":"3l65o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":30,"offset":33,"style":"BOLD"}],"text":"Фактически, XSD становится вашим DSL (domain-specific language) для общения с ИИ, а процесс можно автоматизировать, генерируя XML-промпты прямо из задач в Jira.","type":"unstyled","key":"bm1c7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Локальные правила и AI-артефакты","type":"header-two","key":"9bskr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ИИ может генерировать не только код, но и артефакты — например, техническую документацию по реализованной фиче. Эти документы можно хранить прямо в модулях (/rules/) и использовать в дальнейшем.","type":"unstyled","key":"ammi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Представьте, что после реализации обработки ошибок в модуле модерации ИИ сгенерировал ERROR_HANDLING_MODERATION.md с описанием всех исключений, кодов ошибок и бизнес-правил. Этот документ становится бесценным источником контекста для следующих задач. Вы можете дать его тестировщику (или AI-тестировщику) с задачей: \"Посмотри ERROR_HANDLING_MODERATION.md и напиши тесты, покрывающие операцию approve\".","type":"unstyled","key":"9hcjq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Осторожно: Тестирование кода, написанного ИИ","type":"header-two","key":"8bsfc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Кажется логичным: ИИ написал фичу — пусть сам и покроет её тестами. Но здесь кроется ловушка. Если ИИ при написании тестов будет видеть собственный сгенерированный код, он просто \"подгонит\" тесты под реализацию, а не проверит её корректность.","type":"unstyled","key":"5id1s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"BOLD"}],"text":"Правильное решение: тестирование должно опираться на спецификацию. Давайте ИИ только требования и сценарии использования, но не сам код. Так тесты будут действительно проверять логику работы и выявлять ошибки, а не превращаться в формальность.","type":"unstyled","key":"bic74"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Заключение: от количества кода к качеству мысли","type":"header-two","key":"6ut4h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":0,"style":"BOLD"}],"text":"VibeCode — это не магия, превращающая абстракции в готовые фичи, а инженерная дисциплина, в основе которой лежат точные спецификации. Практика показывает, что качество итогового продукта напрямую зависит от того, насколько ясно сформулированы требования и контекст.","type":"unstyled","key":"93u6k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ценность хорошего специалиста в эпоху ИИ только растёт. Глубокое понимание архитектуры и принципов проектирования становится фундаментом для эффективной работы с AI-инструментами. Новичкам же придётся быстрее осваивать концепции, которые раньше были доступны только специалистам высокого уровня.","type":"unstyled","key":"3jvff"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как бы мы ни сопротивлялись, разработка с помощью ИИ — это уже не будущее, а наша повседневность. И неважно, как вы это назовете, — VibeCode или как-то еще. Этот поезд уже летит.","type":"unstyled","key":"f6hie"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"1m448"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"f9kbg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"bxbQMfCFzh3jrterDhYZ"}],"entityMap":{}},"mentions":[]}