Промты для ChatGPT: как написать техническую инструкцию без “воды”

Вы просите ChatGPT написать техническую инструкцию - и получаете три абзаца вступления, пять предложений о «важности темы» и заключение, которое повторяет вступление. Знакомо? Проблема не в модели - проблема в промпечати. В этой статье разберем, как составить промт, который заставит ChatGPT писать четко, структурировано и без единого лишнего слова.

содержание

Почему ChatGPT «льет воду» в технических текстах

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

Три признака «водяного» технического текста

  • Пустое вступление. «Настройка программного обеспечения является важным шагом...» - никакой конкретики, только заполнение пространства.
  • Дублирование. Один и тот же шаг описывается дважды: в перечне и в итоге.
  • Размытые глаголы. «Можно рассмотреть», «стоит учесть», «рекомендуется» вместо конкретных действий.

Как модель определяет «достаточность» ответа

Без явных ограничений в промти ChatGPT ориентируется на «средний» объем похожих текстов в своих обучающих данных. Для технических инструкций этот «средний» текст в сети - это блог-посты с SEO-набивкой, а не лаконичная документация. Именно поэтому модель воспроизводит этот паттерн по умолчанию. Ваша задача - задать другой шаблон через правильно составленный промпт.

Структура эффективного промпитания для технической инструкции

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

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

Роль и аудитория - первый параметр точности

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

Формат вывода: шаги, таблицы, чеклисты

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

Ограничения и запреты в тексте промпута

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

Готовые шаблоны промптов для технической документации

Ниже - четыре шаблона под разные форматы технической документации. Каждый можно копировать и подставлять свои данные в квадратных скобках.

Шаблон 1: пошаговая инструкция

Ты - технический писатель с опытом составления документации для SaaS-продуктов. Напиши пошаговую инструкцию по [НАЗВАНИЕ ДЕЙСТВИЯ] для [АУДИТОРИЯ].Формат: - нумерованный список шагов - каждый шаг: одно предложение-действие + одно предложение-объяснение (если нужно) - после каждого шага - ожидаемый результат в формате «Результат: ... »Ограничения: - без вступительного абзаца - без итогового абзаца - избегай слов: «стоит», «можно», «рекомендуется», «важно» - максимум [КОЛИЧЕСТВО] шагов - язык: украинский

Шаблон 2: технический FAQ

Ты - технический автор службы поддержки. Составь FAQ по [ТЕМА] для [ПРОДУКТ / СЕРВИС].Формат: - [КОЛИЧЕСТВО] вопросов и ответов - каждый вопрос: формулировка от первого лица («Как мне...», «Что делать, если...») - каждый ответ: максимум 3 предложения, без вступления - если есть шаги - нумерованный мини-список внутри ответаОграничения: - не повторять одну мысль дважды - без фраз «Конечно», «Хороший вопрос», «Безусловно» - без общих советов, которые не касаются продукта - язык: украинский

Шаблон 3: описание API или интерфейса

Ты - технический писатель со специализацией в API-документации. Опиши эндпоинт / функцию [НАЗВАНИЕ] для [АУДИТОРИЯ: разработчики / QA / аналитики].Структура ответа: 1. Назначение (1 предложение) 2. параметры - таблица: Название | Тип | Обязательный | Описание 3. Пример запроса (код в блоке) 4. Пример ответа (код в блоке) 5. Возможные ошибки - таблица: Код | Причина | РешениеОграничения: - без маркетинговых формулировок - без объяснений «что такое API» - технический уровень: [junior / middle / senior] - язык: украинский

Шаблон 4: инструкция пользователя (User Manual)

Ты - UX-писатель с опытом в B2C-продуктах. Напиши раздел руководства пользователя «[НАЗВАНИЕ РАЗДЕЛА]» для [ПРОДУКТ].Аудитория: [ОПИСАНИЕ: пенсионеры / студенты / малый бизнес / т.д.] Уровень технических знаний: минимальный / средний / продвинутыйФормат: - короткий подзаголовок раздела (H3) - нумерованные шаги с глаголами в повелительном наклонении («Нажмите», «Выберите», «Введите») - после каждых 3-4 шагов - блок «Внимание:» или «Подсказка:» (если есть что добавить) - скриншот-плейсхолдеры в формате [СКРИНШОТ: описание]Ограничения: - предложения не длиннее 15 слов - без пассивного залога - без технического жаргона (или с объяснением в скобках) - язык: украинский

Примеры промптов для технического контента - до и после

Лучший способ понять разницу - увидеть два промпта рядом и сравнить, что они дают. Ниже - два реальных кейса с объяснением, что именно изменилось.

Пример 1: инструкция по настройке ПО

Слабый промпт - до:

Напиши инструкцию по установке Docker на Ubuntu.

Что даст: вступление о «важности контейнеризации», общее описание Docker без конкретных команд, или наоборот - команды без объяснений, итог-повторение.

Улучшенный промпт - после:

Ты - DevOps-инженер, который пишет внутреннюю документацию для команды разработчиков (middle-уровень, знают Linux, впервые настраивают Docker).Задание: пошаговая инструкция установки Docker Engine на Ubuntu 22.04 LTS. Формат: - нумерованные шаги, начиная с обновления пакетов - после каждого шага - команда в блоке кода - после команды - одно предложение: что эта команда делает - отдельный блок «Проверка установки» в конце Ограничения: - без вступления о Docker и контейнеризации - без итогового абзаца - не объяснять базовые Linux-команды (cd, sudo) - язык: украинский

Что изменилось: роль задает контекст экспертизы, аудитория определяет уровень объяснений, явный формат убирает «творческую свободу», а запреты снимают конкретные паттерны воды.

инструкция по установке Docker Engine на Ubuntu 22.04 LTS

Пример 2: описание технического процесса

Слабый промпт - до:

Объясни, как работает CI/CD pipeline.

Что даст: три абзаца о «преимуществах автоматизации», общее определение без привязки к конкретному стеку, возможно - список инструментов без объяснения, когда и зачем их применять.

Улучшенный промпт - после:

Ты - senior DevOps. Напиши техническое описание CI/CD pipeline для внутренней вики команды. Аудитория: junior-разработчики, которые впервые настраивают пайплайн на GitHub Actions.Структура: 1. Что происходит при каждом git push (4-5 строк) 2. этапы pipeline - таблица: Этап | Инструмент | Что проверяет | Время выполнения 3. Что происходит при падении build - 3 шага 4. Что происходит при успешном деплое - 2 шагаОграничения: - без введения и заключения - без раздела «Что такое CI/CD» - без сравнения с Jenkins, GitLab CI - язык: украинский

техническое описание CI/CD pipeline для внутренней вики команды

Как настроить ChatGPT на технический стиль письма

Кроме разовых промпов, есть инструменты для системной настройки: кастомные инструкции в интерфейсе ChatGPT и few-shot примеры непосредственно в промпете. Разберем оба варианта.

System prompt для технического копирайтера

В ChatGPT Plus (и через API) можно задать системный промпт - постоянные инструкции, действующие в каждом запросе сессии. Вставьте этот шаблон в поле «Custom instructions → How should ChatGPT respond»:

Ты - технический писатель со стандартами Microsoft Writing Style Guide и Google Developer Documentation Style Guide.Правила для каждого ответа: - начинай с действия или факта, никогда с вступления - используй повелительное наклонение для шагов («Нажмите», «Откройте», «Введите») - предложения не длиннее 20 слов - одна мысль - одно предложение - избегай: «стоит», «можно», «рекомендуется», «важно отметить», «следует отметить» - избегай повторения тезисов в заключении - если не указан формат - используй нумерованный список - язык ответа: украинский, если не указано иное

Few-shot: передаем стиль через примеры

Few-shot - это когда вы показываете модели один-два примера желаемого результата непосредственно в промпечати. Этот метод особенно эффективен, когда нужен очень специфический стиль - например, внутренний tone of voice компании. Структура few-shot промпута:

Пиши технические шаги в таком стиле:ПРИМЕР 1: Шаг: включение двухфакторной аутентификации Результат: «1. откройте Настройки → Безопасность. 2. Нажмите «Включить 2FA». 3. Отсканируйте QR-код в приложении-аутентификаторе. Результат: следующий вход потребует код из приложения. »ПРИМЕР 2: Шаг: сброс пароля Результат: «1 На странице входа нажмите «Забыли пароль?». 2 Введите email аккаунта. 3. Откройте письмо и нажмите ссылку для сброса. Срок действия ссылки: 15 минут. »Теперь напиши в таком же стиле: Шаг: [ВАШ ШАГ]

Распространенные ошибки при составлении промптов для инструкций

Даже после прочтения этой статьи есть пять ошибок, на которые натыкаются чаще всего. Вот они с конкретными исправлениями.

ОшибкаПочему возникаетКак исправить
Слишком общее задание («напиши инструкцию»)Модель не знает, что считать «готовым»Указать конкретный формат и количество элементов
Пожелания вместо запретов («пиши четко»)«Четко» - субъективное понятиеКонкретные запреты: «без вступления», «без слова “стоит”»
Нет указания на аудиториюМодель выбирает «средний» уровень объясненийОписать читателя: опыт, контекст, цель
Нет роли для моделиМодель отвечает как «общий ассистент»Добавить роль в начале: «Ты - технический писатель...»
Промпт без примера форматаМодель выбирает формат сама, часто неудачноПоказать структуру: «формат: нумерованный список, каждый шаг - одно предложение»

Итог: промпт-инженерия для технических текстов

Качественная техническая инструкция от ChatGPT - это результат правильно составленного промпута, а не счастливого случая. Пять элементов, которые делают промпт эффективным: роль, аудитория, формат, ограничения и (при необходимости) few-shot примеры. Убрать любой - и модель заполнит пробел «безопасными» обобщениями.

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

Ответить

Ваш адрес email не будет опубликован. Обязательные поля помечены *