Из чего состоит промпт
Порядок блоков — от постоянного к конкретному: сначала кто мы и для чего, потом материалы, в конце —
задача и формат. Длинные материалы стоят до вопроса: так модель отвечает точнее («Длинный документ — в начало»). Теги
вида <compose> — не специальный синтаксис, а метки, которые модель хорошо различает; имена любые.
Промпт по блокам
Проверяем docker-compose для сервера, на котором живут сайты. Сервер один,
админ один, правки выкатываются вручную. Цель — найти то, что сломается
при перезапуске или откроет лишнее наружу.Контекст: кто читает ответ и зачем. Модель подстраивает глубину и тон под читателя — «админ-одиночка, сервер с живыми сайтами» даёт другие советы, чем «учебный стенд». Роль одной фразой тоже работает, но факты о ситуации дают больше, чем звание.
<environment>
Ubuntu 24.04, Docker 29, Compose v5.6, Traefik 3.7 в соседнем стеке,
внешняя сеть proxy.
</environment>
<compose>
services:
memos:
image: neosmemo/memos:stable
ports:
- "5230:5230"
volumes:
- ./data:/var/opt/memos
…
</compose>Материалы — в тегах, до вопроса. Всё, на что модель должна опираться: файл целиком, версии, вывод команды. Без них она отвечает по общей памяти о похожих файлах. Версии — обязательно: синтаксис compose и Traefik менялся («Дата, версии и окружение — в промпт»).
Найди проблемы, которые:
- открывают порт или данные наружу;
- ломают сервис при перезапуске или обновлении образа;
- расходятся с тем, как устроены соседние стеки за Traefik.
Стиль и порядок ключей не трогаем.Задача и критерий готовности. Не «посмотри файл», а что именно искать и когда остановиться. Если нужен список — говорим, сколько пунктов и как их упорядочить.
Образ на конкретную версию не закрепляем: обновления ставим осознанно
через `stable`, и это решение уже принято.Ограничения — с причиной. Причина даёт модели правило для случаев, которых мы не перечислили. Без неё — либо игнорирует, либо применяет слишком широко («Правило в промпте — с причиной вместо капса»).
Ответ — таблица: | строка | что не так | чем грозит | как исправить |.
Строки — по убыванию риска. Исправление — готовый фрагмент YAML.
Ничего не нашли по пункту — так и пиши, не добавляй мелочи для объёма.Формат ответа — показываем, а не описываем. Таблица, JSON или список с полями: так ответ можно читать глазами за минуту или разобрать скриптом («JSON по схеме»).
<example>
| `ports: "5230:5230"` | порт открыт на всех интерфейсах, мимо Traefik | сервис доступен по IP без HTTPS и защиты | `"127.0.0.1:5230:5230"` или убрать `ports`, оставить сеть proxy |
</example>Пример ответа — одна строка нужного вида. Пример задаёт длину, детализацию и тон точнее любого описания. Два-три примера — если случаи разные («Пример вместо описания»).
Если для вывода не хватает данных (например, конфига Traefik) — скажи,
чего не хватает, а не предполагай. Не уверен в версии ключа — пометь.Разрешение не знать и спросить. Без него модель заполняет пробелы догадками. С ним — честно помечает, где не уверена, и сначала задаёт вопросы, если данных мало («Сначала вопросы и план»).
Ты — эксперт мирового уровня по DevOps с 20-летним опытом.«Звание» вместо контекста. Новые модели от «эксперта мирового уровня» не умнеют, а пишут увереннее и длиннее. Работает факт о ситуации из первого блока.
ОБЯЗАТЕЛЬНО!!! НИКОГДА не меняй порты. Это КРИТИЧЕСКИ ВАЖНО.Капс и угрозы. Привычка времён моделей, которые пропускали инструкции. Новые модели читают их буквально и перегибают: «НИКОГДА» распространяется туда, куда не задумывалось.
Давай подумаем шаг за шагом.«Думай шаг за шагом». На рассуждающих моделях размышление включено и управляется effort («Размышление — под задачу»); фраза ничего не добавляет. На старых моделях без размышления она помогала.
Короче — когда можно
Не каждому запросу нужны все блоки. «Переведи на английский, тон README» — достаточно. Блоки добавляем по мере того, как ответ промахивается: не тот уровень — контекст, выдумывает — материалы, не тот вид — формат и пример.
Как проверить
Отправляем один и тот же промпт три раза в новых чатах. Если ответы совпадают по сути и по виду — промпт задаёт задачу однозначно. Если каждый раз другая структура или другие находки — не хватает формата или критерия готовности; дописываем блок и повторяем.
Если не работает
Ответ про всё сразу, а нужное — в одном абзаце из десяти
- Причина
- Нет критерия готовности и формата: модель не знает, что важно, и покрывает всё.
- Делаем
- Блок «задача» с тем, что считаем результатом, и блок «формат» с ограничением длины.
Модель путает, где наш вопрос, а где вставленный текст
- Причина
- Материал и инструкция слиты в один абзац; в материале есть фразы, похожие на просьбы.
- Делаем
- Материалы — в тегах
<compose>…</compose>, инструкция — отдельно, после них.
После «НИКОГДА не меняй порты» модель отказывается трогать даже опечатку в порту
- Причина
- Новые модели выполняют инструкции буквально, а капс читают как приказ высшего приоритета.
- Делаем
- Пишем причину вместо капса: «порты не меняем — на них настроен firewall», и модель сама поймёт исключения («Правило в промпте — с причиной вместо капса»).