basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    КонфигИИПромпты

    Промпт по блокам: контекст, материалы, задача, формат, примеры

    Промпт работает, когда в нём есть то, чего модель не может угадать: для кого результат, на чём основываться, что считать готовым и в каком виде отдать. Разбираем промпт на проверку compose-файла по блокам; в конце — привычки из 2023 года, которые новым моделям мешают.

    Из чего состоит промпт

    Порядок блоков — от постоянного к конкретному: сначала кто мы и для чего, потом материалы, в конце — задача и формат. Длинные материалы стоят до вопроса: так модель отвечает точнее («Длинный документ — в начало»). Теги вида <compose> — не специальный синтаксис, а метки, которые модель хорошо различает; имена любые.

    Промпт по блокам

    промпт: проверка 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», и модель сама поймёт исключения («Правило в промпте — с причиной вместо капса»).