Почему этот гайд

Чат-промпт не равно агент-промпт.

В браузерном 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 про-приёмов. Можешь читать по порядку, можешь прыгать через sticky-навигацию справа.

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

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

Формула

Промпт = вызов функции. 5 именованных параметров.

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

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

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

Param 01 / 05

context

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

ПРАВИЛО: указывай пути к файлам, не вставляй контент в промпт. Агент сам прочитает. Контекстное окно сэкономишь, и он увидит свежие данные.
Плохо
"проанализируй мои продажи за май"
Хорошо
context:   - данные за май:     ./data/sales_2026-05.csv   - формат строк:     дата | менеджер | сумма | статус   - моя позиция: РОП в SaaS-стартапе

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

Param 02 / 05

role

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

ПРАВИЛО: одна задача = одна роль. Не пиши «универсальный помощник» — агент будет средне всё. Чем уже роль, тем точнее результат.
Плохо
role: "помощник, который во всём разбирается"
Хорошо
role: ты — мой email-ассистент.      сортируешь входящие      на 3 категории      и пишешь черновики ответов      в моём стиле общения.

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

Param 03 / 05

task

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

ПРАВИЛО: глагол → объект → результат. Если шагов несколько — нумеруй. «разберись» — мусорный глагол. «прочитай», «создай», «сохрани» — рабочие.
Плохо
task: "разберись с почтой и сделай всё нормально"
Хорошо
task:   1. прочитай ./inbox/2026-05-04.txt   2. рассортируй на 3 категории:      A — нужен мой ответ      B — отдать менеджеру      C — игнор   3. для A → черновик в ./drafts/   4. для B → заметка      ./drafts/forward.md

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

Param 04 / 05

rules

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

ПРАВИЛО: для деструктивных действий требуй подтверждение. «удали», «отправь», «опубликуй» — всегда с «дождись моего да».
Плохо
"почисти эту папку"
Хорошо
rules:   - не удаляй файлы без подтверждения   - перед удалением → список     в ./review_to_delete.md   - не трогай файлы вне ./inbox/   - если упомянуты финансы/юр.вопросы     → помять "Срочно глазами"   - сохраняй мой стиль из ./about_me/

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

Param 05 / 05

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 минут vs 8 минут. Та же модель, тот же агент, та же задача. Разница — в структуре промпта.

Что не работает

3 ошибки, которые убивают промпт.

  • «Подразумеваемый контекст»

    Ты знаешь, что у тебя в голове и на экране — агент не знает. «Обнови мой сайт» — какой? где код? что обновить? Агент догадается неправильно.

    укажи путь к репо, что именно менять, какие файлы трогать
  • «Без rules»

    «Разбери папку» — агент в своём праве удалить, переместить, переписать что угодно. Утром ты найдёшь пустую папку.

    всегда rules: «не удаляй без подтверждения», «список к ./review.md»
  • «Один параметр на всё»

    «Сделай отчёт по продажам красиво и понятно для босса» — смешал task, format, role в одну фразу. Агент выберет один аспект, остальное проигнорит.

    разбей на 5 параметров. Один параметр — одна функция.
Про-приёмы

5 мини-секретов от тех, кто уже там.

  • 1
    Голос вместо печати

    Длинный контекст быстрее наговорить, чем напечатать. OpenWhisper или native dictation макОС — агенту всё равно как пришёл текст. Скорость ×3.

  • 2
    Один параметр на раз

    Если результат не то — меняй один параметр (обычно context или task), а не пиши новый промпт с нуля. Агент быстрее «подкрутит», чем переучится.

  • 3
    Ссылка, а не копипаста

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

  • 4
    Шаблон под себя

    Сохрани свой промпт-шаблон в файле prompt-template.md, переиспользуй и улучшай. Через месяц у тебя будет личный промпт-арсенал под 5–10 типовых задач.

  • 5
    «Дождись да»

    Для деструктивных действий (удалить, отправить, опубликовать) — всегда добавляй в rules «дождись моего да перед действием». Агент покажет план, ты утвердишь.

Шаблон

Скопируй. Вставь. Заполни плейсхолдеры.

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

─── COPY → PASTE ───
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 заложил? а куда сохранить?»

Claude Code Codex ChatGPT OpenWhisper
Источники и вдохновение
  1. Anthropic. Claude Prompting Guide. docs.anthropic.com/claude/docs/prompt-engineering
  2. Anthropic. Engineering Effective Tools. anthropic.com/engineering
  3. Karpathy A. State of GPT (Microsoft Build 2023). youtube.com/watch?v=bZQun8Y4L2A
  4. Авторские наблюдения по учебной выборке программ Tripwire и «Интегратор 3.0» онлайн-академии onAI / Opus.club.

Этот гайд — часть «Арсенала» клуба Строго на Opus.club. Бесплатные шпаргалки и инструменты для тех, кто заходит в тему AI-агентов.

─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─

Понравилось? Подпишись на @strogo_na_opuse в Telegram — там я выкладываю следующие выпуски Арсенала и кейсы из реальных задач.