Анатомия рабочего промта: 4 блока, которые меняют результат
Роль
Кто отвечает: «Ты — ментор бэкенд-разработчика с 10-летним опытом», «Ты — техписьменник, пишущий для джуниоров». Роль задаёт тон, глубину и терминологию.
Контекст
Что известно: стек проекта, уровень твоей подготовки, формат результата, ограничения. Без контекста ИИ даёт общий совет уровня «изучи документацию».
Задача
Чёткий глагол: «напиши», «разбери», «сравни», «сгенерируй», «переведи на русский», «найди ошибку». Одна задача — один промт.
Формат
Как выдать: «маркдаун-таблица», «список из 5 пунктов», «код с комментариями», «письмо на 3 абзаца», «пошаговый чек-лист». Формат экономит время на правках.
Библиотека по категориям: выбери свою боль
Отчёты и документы
Еженедельные отчёты, планы стажировки, постулаты по проекту, саммари встреч.
8 промтов →Код и дебаг
Скелеты функций, разбор чужого кода, поиск багов, рефакторинг, тесты, коммиты.
10 промтов →Быстрое обучение
Планы обучения, шпаргалки, объяснения концепций, сравнение технологий, ментальные модели.
7 промтов →Почта и коммьюникация
Письма ментору, запросы на код-ревью, отказы, просьбы о помощи, фоллоу-апы.
6 промтов →Анализ данных и SQL
SQL-запросы, интерпретация метрик, построение графиков, выявление аномалий, A/B-тесты.
5 промтов →Разбор категории: отчёты и документы
1
Еженедельный отчёт по шаблону
Роль: Ты — менеджер проектов, пишущий отчёты для стейкхолдеров.
Контекст: Я практикант [роль], неделя [номер]. Стек: [стек]. Задачи недели: [список].
Задача: Напиши еженедельный отчёт по структуре: 1) Ключевые достижения (3-5 пунктов, с метриками где возможно). 2) Блокеры и риски. 3) План на следующую неделю. 4) Вопросы к ментору.
Формат: Маркдаун, деловой стиль, без воды, 1 экран.
2
План стажировки (Roadmap)
Роль: Ты — тьютор, составляющий ИПР для практиканта.
Контекст: Стажировка [длительность], цель: [цель]. Мой уровень: [junior/middle]. Стек команды: [стек]. Ментор доступен [часов/нед].
Задача: Составь план по неделям: тема недели → цели обучения → практические задачи → критерии готовности → материалы для изучения.
Формат: Таблица в маркдауне. Добавь колонку «Статус».
3
Саммари встречи / дейли
Роль: Ты — секретарь встречи, пишущий краткое саммари для участников.
Контекст: Транскрипт/заметки встречи: [вставь текст]. Участники: [роли].
Задача: Выдели: 1) Принятые решения. 2) Экшен-пункты (кто, что, до когда). 3) Открытые вопросы. 4) Следующая встреча.
Формат: Маркированный список, только суть, без вводных слов.
4
Постулат / описание задачи в трекере
Роль: Ты — продуктовый аналитик, пишущий чёткие ТЗ для разработчиков.
Контекст: Суть задачи: [что нужно сделать]. Почему это важно: [бизнес-ценность]. Текущее состояние: [как работает сейчас]. Ограничения: [дедлайн, стек, зависимые задачи].
Задача: Напиши описание тикета: User Story, Acceptance Criteria (список), Edge Cases, Тестовые данные, Ссылки на макеты/доки.
Формат: Маркдаун, структура Jira/GitLab issue.
Разбор категории: код и дебаг — не копипаст, а понимание
5
Скелет функции / класса
Роль: Ты — сеньор-разработчик [язык/фреймворк].
Контекст: Нужна функция: [что делает]. Вход: [типы]. Выход: [типы]. Ограничения: [performance, библиотеки, стиль кода].
Задача: Напиши скелет с типизацией, докстрингами, базовой валидацией входов, обработкой ошибок и TODO-комментариями для бизнес-логики.
Формат: Чистый код, без излишних комментариев. Следуй style guide: [PEP8 / Airbnb / Google].
6
Разбор чужого кода (code reading)
Роль: Ты — ментор, объясняющий код джуниору.
Контекст: Файл/модуль: [вставь код или путь]. Моя задача: понять, как это работает, чтобы сделать [правку/фичу].
Задача: Разбери код по слоям: 1) Назначение модуля. 2) Ключевые классы/функции и их ответственность. 3) Поток данных (flow). 4) Зависимости и сайд-эффекты. 5) Подозрительные места / техдолг. 6) Вопросы, которые стоит задать ментору.
Формат: Структурированный текст с заголовками.
7
Дебаг: ошибка / трейсбек
Роль: Ты — эксперт по дебагу в [язык/фреймворк].
Контекст: Ошибка: [трейсбек/лог]. Где падает: [файл:строка]. Что делал: [действия]. Окружение: [версии].
Задача: 1) Объясни причину простыми словами. 2) Дай 3 гипотезы, почему это произошло. 3) Предложи фикс с кодом. 4) Как проверить, что не сломалось ещё что-то.
Формат: Список. Код фикса — в блоке с подсветкой.
8
Генерация тестов (pytest / jest)
Роль: Ты — QA-инженер, пишущий юнит-тесты.
Контекст: Функция для тестирования: [код]. Покрыть: happy path, edge cases, ошибки валидации, граничные значения.
Задача: Сгенерируй тест-сьют: fixtures, параметризованные тесты, моки внешних зависимостей. Именование: test___.
Формат: Готовый к запуску файл тестов. Добавь комментарии к нетривиальным кейсам.
Разбор категории: быстрое обучение — от «что это» к «как применить»
9
План обучения за 2 недели
Роль: Ты — автор обучающих курсов для разработчиков.
Контекст: Тема: [Docker / PostgreSQL / React hooks]. Мой уровень: [знаю основы / новичок]. Время: [часов в неделю]. Цель: [научиться деплоить / писать хуки / оптимизировать запросы].
Задача: Составь план по дням: теория (статьи/видео/доки) → практика (мини-задачи) → чекпоинт самопроверки. Учитывай когнитивную нагрузку.
Формат: Таблица: День | Теория (ссылки) | Практика | Чекпоинт | Время.
10
Объяснение концепции «на пальцах»
Роль: Ты — преподаватель, объясняющий сложное простыми аналогиями.
Контекст: Концепция: [event loop / CAP theorem / dependency injection / normalization]. Аудитория: джуниоры, знающие базу.
Задача: 1) Одна фраза-суть. 2) Аналогия из жизни. 3) Визуальная схема (описание для рисования). 4) Минимальный код-пример. 5) Типичные ошибки новичков. 6) Зачем это знать на практике.
Формат: Структурированный ответ с заголовками.
11
Шпаргалка (cheatsheet) по технологии
Роль: Ты — создатель шпаргалок для разработчиков.
Контекст: Технология: [Git / Docker CLI / SQL / Regex / VS Code]. Уровень: ежедневное использование.
Задача: Создай шпаргалку: категория → команда → флаг/опция → что делает → пример. Только самое частое (80/20). Добавь раздел «Опасные команды» и «Жизненные циклы».
Формат: Маркдаун-таблицы по категориям. Готово к печати на A4.
12
Сравнение: выбор инструмента / подхода
Роль: Ты — архитектор, помогающий выбрать стек.
Контекст: Выбор: [FastAPI vs Flask / PostgreSQL vs Mongo / Redis vs RabbitMQ]. Проект: [тип нагрузки, команда, дедлайны].
Задача: Сравни по критериям: кривая обучения, производительность, экосистема, найм, операционная сложность, подходность к джуниорам. Дай вердикт для нашего контекста.
Формат: Таблица + итоговый вывод «Рекомендую X, потому что…».
Разбор категории: почта и коммьюникация — пиши так, чтобы отвечали
13
Запрос на код-ревью
Роль: Ты — практикант, просящий ревью у сеньора.
Контекст: MR/PR: [ссылка]. Что сделано: [суть]. Где прошу внимание: [файлы/логика]. Дедлайн: [когда нужно].
Задача: Напиши сообщение в слак/почту: контекст одной строкой → ссылка → конкретные вопросы (2-3) → дедлайн → благодарность.
Формат: Готовое сообщение. Тон: уважительный, конкретный, лёгкий для ответа.
14
Вопрос ментору: «завис, помоги»
Роль: Ты — практикант, который уважает время ментора.
Контекст: Задача: [что делаю]. Пробовал: [что уже сделал, ссылки на доки/стек]. Ошибка/блокер: [что не работает]. Гипотезы: [мои варианты].
Задача: Напиши сообщение: что делаю → что получилось → где застрял → что пробовал → 2 варианта решения → прошу указать направление (не решить за меня).
Формат: Сообщение 5-7 строк. Без «привет, как дела».
15
Фоллоу-ап после встречи / дейли
Роль: Ты — организованный практикант, фиксирующий договорённости.
Контекст: Встреча: [тема]. Участники: [кто]. Ключевые решения: [список]. Мои экшены: [что я делаю, до когда].
Задача: Напиши письмо/сообщение: «Коллеги, спасибо за встречу. Краткий саммари: [3-5 пунктов]. Мои следующие шаги: [список с дедлайнами]. Если упустил что-то — напишите».
Формат: Письмо, готовое к отправке.
Ситуативные промты: «Если… то используй…»
Ситуация
Нужно быстро разобраться в незнакомом кодовом модуле перед задачей
Промт
Роль: сеньор-разработчик. Контекст: файл [путь], задача — добавить [фичу]. Задача: разбери архитектуру модуля: точки входа, зависимости, поток данных, где менять для фичи. Формат: чек-лист файлов для изучения + схема изменений.
Ситуация
Ментор дал задачу «посмотри, как у нас сделано X», но документации нет
Промт
Роль: техписьменник. Контекст: кодовая база [папка], паттерн X реализован где-то здесь. Задача: найди примеры реализации X, выдели общий паттерн, опиши пошагово, как повторить. Формат: инструкция «как сделать X у нас в проекте».
Ситуация
Нужно написать SQL-запрос для метрики, но не знаешь схему БД
Промт
Роль: аналитик данных. Контекст: таблицы [список/описание], нужна метрика [определение]. Задача: напиши запрос с CTE, комментариями к джойнам, проверкой на NULL. Добавь EXPLAIN-план чтения. Формат: готовый SQL + пояснение логики.
Ситуация
Получил правки по МР, не согласен с частью — нужно аргументированно ответить
Промт
Роль: разработчик, ведющий конструктивный диалог в коде. Контекст: комментарий ревьюера: [цитата], мой код: [фрагмент]. Задача: сформулируй ответ: признаю валидность → объясняю свой выбор (ссылка на док/паттерн) → предлагаю компромисс или прошу уточнить. Формат: текст комментария.
Ситуация
Нужно подготовить 3 вопроса к 1-on-1 с ментором на неделю
Промт
Роль: карьерный коуч для джуниоров. Контекст: неделя [номер], сделано: [список], проблемы: [список], цель стажировки: [цель]. Задача: сгенерируй 3 вопроса: 1 про технический рост, 1 про процессы/команду, 1 про карьеру. Формат: нумерованный список, каждый вопрос — открытый.
Ситуация
Хочу завести заметку в Obsidian / Notion по новой теме — нужна структура
Промт
Роль: эксперт по зettelkasten / PKM. Контекст: тема [название], цель — быстро находить и применять. Задача: предложи структуру заметки: заголовок, теги, связки, ключевые определения, примеры, чек-лист применения, открытые вопросы. Формат: шаблон для копирования.
Пример цепочки: новая фича в чужом проекте
Шаг 1 — Разведка
«Ты — сеньор. Задача: добавить эндпоинт /api/v1/reports. Контекст: проект на FastAPI, есть примеры в /app/api/v1/. Проанализируй структуру: как организованы роутеры, схемы, сервисы, зависимости. Выдели паттерны. Дай чек-лист файлов для правок».
Шаг 2 — Скелет
«На основе паттернов создай скелет: router с эндпоинтом, Pydantic-схемы request/response, сервис с TODO, зависимость для БД. Следуй стилю проекта. Код готов к заполнению логикой».
Шаг 3 — Логика
«В сервисе реализуй: запрос к БД через SQLAlchemy, агрегация данных, обработка пустого результата, логирование. Верни код сервиса и схемы».
Шаг 4 — Тесты и доки
«Напиши тесты: happy path, 404, 422. Используй pytest, httpx.AsyncClient, моки БД. Добавь в README раздел по новому эндпоинту с примером запроса/ответа».
Чего не делать: антипаттерны промтов, которые едят время
«Сделай за меня» без контекста
«Напиши отчёт по стажировке». Результат: общая вода, которую всё равно перепишешь. Всегда давай роль, контекст, формат.
Копипаст кода без понимания
ИИ может галлюцинировать API, несуществующие методы, устаревшие паттерны. Всегда проси объяснение и проверяй в доке.
Один мега-промт на всё
«Сделай фичу: бэкенд, фронтенд, тесты, доки». Получишь сырой код везде. Дробей: один промт — один артефакт.
Игнорирование итераций
Первый ответ — черновик. Вторым промтом уточняй: «Сократи до 3 абзацев», «Убери жаргон», «Добавь пример». Каждая итерация — +20 % качества.
Сдача ИИ-результата без ревью
Твоя ответственность — за код в проде. ИИ — стажёр, который пишет быстро, но иногда бреднит. Читай, запускай, тестируй, понимай.
