Промпт, который работает

Чем промпт для агента отличается от промпта для чата?

В браузерном ChatGPT ты пишешь «напиши мне X», получаешь текст в окно чата. Локальный AI-агент в твоей папке: выполняет действия: читает файлы, пишет файлы, запускает процессы, отвечает в твоём стиле.

Это другая порода задачи. И если ты пишешь агенту в стиле «напиши мне X», он вернёт тебе текст в чат, а не сделает работу. Или сделает не то.

"напиши мне КП клиенту
по разработке бота для
Telegram, цена средняя"

context: транскрипт встречи
         в ./inbox/2026-05-04.md
role:    мой sales-ассистент
task:    заполни шаблон КП
         в ./projects/X/proposal.md
rules:   цены не выдумывай,
         ставь TODO
format:  markdown в файле +
         summary в чат

Дальше: разбор каждого из 5 параметров, шаблон для копипасты, 3 типичные ошибки и 5 про-приёмов. Можешь читать по порядку, можешь прыгать по оглавлению.

Пять параметров, и промпт перестаёт быть лотереей.

Один параметр пропущен: агент потерян. Особенно rules. Вот как это выглядит на чек-листе перед запуском:

$ ./prompt --check
        ✓context : пути указаны
        ✓role    : sales-аналитик
        ✓task    : 4 шага
        ✗rules   : пропустил
        ✓format  : markdown + summary
        [result]: агент удалил лишние файлы 💀

Из каких пяти параметров состоит промпт для агента?

prompt(
  context: "что у меня / кто я / что хочу",
  role: "кем должен быть AI",
  task: "что конкретно сделать",
  rules: ["что не трогать", "лимиты"],
  format: "в каком виде отдать",
)

Это не код, который ты запускаешь. Это структура мысли. Пишешь промпт хоть голосом, хоть руками, но в нём должны быть все 5 слотов.

Дальше: по карточке на каждый параметр. С примерами «до / после» прямо из реальных задач.

context

Где у тебя что лежит. И что вообще происходит.

Правило: указывай пути к файлам, не вставляй контент в промпт. Агент сам прочитает. Контекстное окно сэкономишь, и он увидит свежие данные.

"проанализируй мои продажи
за май"

context:
  - данные за май:
    ./data/sales_2026-05.csv
  - формат строк:
    дата | менеджер | сумма | статус
  - моя позиция: РОП в SaaS-стартапе

Если контекст уже описан в CLAUDE.md твоего проекта, не дублируй. Просто скажи «работаем по контексту проекта X».

role

Кем должен быть агент в этой конкретной задаче.

Правило: одна задача = одна роль. Не пиши «универсальный помощник»: агент будет средне всё. Чем уже роль, тем точнее результат.

role: "помощник, который
       во всём разбирается"

role: ты: мой email-ассистент.
     сортируешь входящие
     на 3 категории
     и пишешь черновики ответов
     в моём стиле общения.

Хорошая роль = одна функция + ограничение зоны. «Email-ассистент» лучше чем «коммуникатор-универсал».

task

Что сделать. По шагам. Глаголами.

Правило: глагол → объект → результат. Если шагов несколько: нумеруй. «разберись»: мусорный глагол. «прочитай», «создай», «сохрани»: рабочие.

task: "разберись с почтой
       и сделай всё нормально"

task:
  1. прочитай ./inbox/2026-05-04.txt
  2. рассортируй на 3 категории:
     A: нужен мой ответ
     B: отдать менеджеру
     C: игнор
  3. для A → черновик в ./drafts/
  4. для B → заметка
     ./drafts/forward.md

Если шагов больше 5: разбей на два промпта или на два запуска агента. Меньше: меньше шансов «потеряться».

rules

Что нельзя. И где остановиться.

Правило: для деструктивных действий требуй подтверждение. «удали», «отправь», «опубликуй»: всегда с «дождись моего да».

"почисти эту папку"

rules:
  - не удаляй файлы без подтверждения
  - перед удалением → список
    в ./review_to_delete.md
  - не трогай файлы вне ./inbox/
  - если упомянуты финансы/юр.вопросы
    → помять "Срочно глазами"
  - сохраняй мой стиль из ./about_me/

Это самый недооценённый параметр. Без него агент может удалить, переписать, отправить не то. Половина «AI-агент сломал мой проект» историй: это пропущенный rules.

format

В каком виде отдать результат. И куда.

Правило: файл vs чат. Длинный артефакт: в файл. Сводка о сделанном: в чат. Не всё в чат.

"отдай красиво"

format:
  - черновики ответов:
    ./drafts/email_NN.md (markdown)
  - в чат: 1 строка summary
    типа "обработал 23 письма,
    A: 5, B: 12, C: 6, требуют твоих
    глаз: 2"
  - длина одного ответа: ≤ 5 строк

Если не указал format: агент чаще всего вывалит всё в чат гигантским полотном. Будешь скроллить, искать что куда.

Чем отличается один и тот же запрос с формулой и без?

Задача: разобрать входящую почту за день и подготовить черновики ответов.

"Глянь мою почту и ответь
на важное по-нормальному"

────────────────
[result]:
агент пишет 30 ответов в чат
полотном, без сортировки,
не понятно что отправлено,
что черновик. ничего не
сохранено в файлы.
            [time spent]: 40 мин на разбор хаоса в ответ

context: ./inbox/2026-05-04.txt
         ./about_me/communication.md
         ./projects/ (текущие проекты
         для контекста писем)

role: email-ассистент. сортирует
      и пишет черновики в моём стиле

task:  1. прочитай весь inbox
       2. категории A/B/C
       3. A → черновики
       4. B → заметка менеджеру

rules: - ничего не отправляй сам
       - финансы/юр → "Срочно глазами"
       - стиль из communication.md

format: - драфты в ./drafts/email_NN.md
         - 1 строка summary в чат
         - ответ ≤ 5 строк
────────────────
[result]: 23 файла в drafts/,
         summary в чате,
         2 помечены "Срочно глазами"
            [time spent]: 8 мин на ревью + send

В этом примере: 40 минут против 8 минут. Цифры иллюстративные, это не замер. Та же модель, тот же агент, та же задача. Разница: в структуре промпта.

Какие три ошибки убивают промпт?

• «Подразумеваемый контекст». Ты знаешь, что у тебя в голове и на экране, агент не знает. «Обнови мой сайт»: какой? где код? что обновить? Агент догадается неправильно. Что делать: укажи путь к репо, что именно менять, какие файлы трогать
• «Без rules». «Разбери папку»: агент в своём праве удалить, переместить, переписать что угодно. Утром ты найдёшь пустую папку. Что делать: всегда rules: «не удаляй без подтверждения», «список к ./review.md»
• «Один параметр на всё». «Сделай отчёт по продажам красиво и понятно для босса», смешал task, format, role в одну фразу. Агент выберет один аспект, остальное проигнорит. Что делать: разбей на 5 параметров. Один параметр: одна функция.

Какие пять приёмов ускоряют работу с промптами?

• Голос вместо печати. Длинный контекст быстрее наговорить, чем напечатать. Программа распознавания речи, например Whisper от OpenAI, или встроенная диктовка macOS: агенту всё равно, как пришёл текст.
• Один параметр на раз. Если результат не то, меняй один параметр (обычно context или task), а не пиши новый промпт с нуля. Агент быстрее «подкрутит», чем переучится.
• Ссылка, а не копипаста. Не вставляй контент в промпт. Сошлись на путь: агент сам прочитает. Сэкономишь контекстное окно и получишь работу со свежими данными.
• Шаблон под себя. Сохрани свой промпт-шаблон в файле prompt-template.md, переиспользуй и улучшай. Через месяц у тебя будет личный промпт-арсенал под 5-10 типовых задач.
• «Дождись да». Для деструктивных действий (удалить, отправить, опубликовать), всегда добавляй в rules «дождись моего да перед действием». Агент покажет план, ты утвердишь.

Какой шаблон промпта взять за основу?

Универсальный скелет промпта под любую агент-задачу. Подставь свои данные вместо [плейсхолдеров] в блоке ниже.

context:
  - где данные: [путь к файлу или папке]
  - что в них: [структура / формат]
  - кто я и какая ситуация: [короткий бэкграунд]

role:
  ты: [конкретная узкая роль для этой задачи]

task:
  1. [действие глаголом]
  2. [действие глаголом]
  3. [действие глаголом]

rules:
  - не [что нельзя трогать или менять]
  - перед деструктивным действием → [требование подтверждения]
  - стиль / тон: [ссылка на файл с примерами]

format:
  - артефакт сохрани в: [путь к выходному файлу]
  - в чат: [короткое summary что сделал]
  - длина / форма: [ограничение если есть]

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

Как выглядит промпт для отчёта по продажам?

context:
  - данные: ./data/sales_2026-05.csv
  - формат: дата | менеджер | сумма | статус | комментарий
  - я: РОП в SaaS-стартапе, 11 человек в подчинении
  - на планёрке в пн рассказываю что было, что меняем

role:
  ты, мой sales-аналитик. выдаёшь сводку для управленческих решений,
  не для маркетинга. суть, не воду.

task:
  1. прочитай sales_2026-05.csv
  2. посчитай: общая сумма, по менеджеру, конверсия, средний чек
  3. найди 2-3 аномалии (резкое падение/рост, странные паттерны)
  4. сформулируй 2-3 рекомендации к планёрке
  5. сохрани отчёт в ./reports/sales_2026-05_planepka.md

rules:
  - не делай выводы из < 5 наблюдений
  - если данные неполные → пометь "TODO: уточнить у X"
  - не трогай ничего вне ./reports/
  - тон: внутренний документ, без воды и эмодзи

format:
  - markdown, разделы: ИТОГИ / ПО МЕНЕДЖЕРАМ / АНОМАЛИИ / РЕКОМЕНДАЦИИ
  - максимум 1 страница A4
  - в чат: 1 строка типа "отчёт готов в ./reports/..., 2 аномалии, 3 рекомендации"

Один такой промпт вместо 30 минут «сядь, открой Excel, посчитай, поищи аномалии, напиши вывод».

Как прокачивать промпты дальше?

Эта формула из 5 параметров: рабочий минимум. Через неделю у тебя появятся свои находки: типичные роли под свою профессию, любимые формулировки rules, удобные форматы вывода.

Цель: не запомнить шаблон. Цель: чтобы при следующей задаче в голове сама всплывала проверка: «а контекст указал? а rules заложил? а куда сохранить?»

Источники

• Anthropic. Prompt engineering, документация Claude. docs.claude.com/en/docs/build-with-claude/prompt-engineering/overview
• Anthropic. Блог Engineering. anthropic.com/engineering
• Karpathy A. State of GPT (Microsoft Build 2023). youtube.com/watch?v=bZQun8Y4L2A