Библиотека промптов для ИИ-помощника: 13 типов задач

Промпт - это ваша просьба к нейросети обычными словами. Ниже тринадцать заготовок для типовых задач. В квадратных скобках стоит то, что нужно заменить своим. Под каждой заготовкой есть пример заполнения и подсказка, как проверить результат.

Какие промпты использовать для работы с кодом?

Начните с четырёх базовых: объяснить проект, найти причину ошибки, внести небольшую правку по плану и проверить изменения. В библиотеке собраны тринадцать шаблонов для типовых задач, каждый копируется одним нажатием. Подставьте свои названия файлов и критерий проверки, чтобы шаблон сразу подошёл вашему проекту.

1. Как попросить нейросеть объяснить незнакомый проект?

Попросите описать назначение проекта, главные папки и точку входа простыми словами, без правок. Затем задайте уточняющие вопросы по непонятным местам. Такая задача безопасна: агент ничего не меняет, а вы быстрее понимаете, с чем имеете дело. С такого вопроса лучше начинать работу с любым проектом.

Ничего не меняй в файлах. Изучи проект в этой папке и объясни простыми словами:
1. Для чего он нужен.
2. Какие в нём главные папки и что в каждой лежит.
3. С какого файла всё начинается.
Если что-то непонятно, так и скажи, не придумывай.

Пример: можно добавить в конце «Я не программист, объясняй без жаргона». Проверьте: откройте названные файлы и убедитесь, что они существуют.

2. Как попросить ИИ найти ошибку в коде?

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

Вот текст ошибки:
[вставьте текст ошибки целиком]
Файл: [имя файла]. Я ожидал: [что должно было произойти]. Получилось: [что произошло].
Сначала объясни причину своими словами и покажи строку, где проблема. Правку пока не делай.

Пример: «Файл app/prices.py. Я ожидал: итог 1200. Получилось: итог 0». Проверьте: найдите названную строку сами и убедитесь, что объяснение сходится.

3. Небольшая правка по плану

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

Задача: [что изменить].
Где: [файлы или папка]. Другие файлы не трогай.
Сначала напиши план из 3-5 пунктов и жди моего «ок». После правки скажи, какие файлы изменил и как проверить результат.

Пример: «Задача: заменить в шапке сайта телефон на новый. Где: файл header.html». Проверьте: посмотрите список изменённых файлов, он должен совпасть с планом.

4. Написать тест

Тест - это небольшая проверка: запускаете командой, она отвечает «работает» или «не работает». Поломки она ловит раньше вас.

Напиши тест для функции [имя] в файле [файл]. Проверь обычный случай, пустое значение и ошибочный ввод.
Тест положи в [папка с тестами]. Саму функцию не меняй. Скажи, какой командой запустить тесты.

Пример: «функция calc_total в файле app/prices.py, тесты в папке tests». Проверьте: запустите тест командой, которую назвал помощник. Тест должен проходить на нынешнем коде.

5. Проверить изменения перед сохранением

Помощник смотрит свежие правки глазами строгого ревьюера. Это страховка, а не замена вашему просмотру.

Посмотри все несохранённые изменения в проекте (git diff). Найди ошибки, лишние правки и места, где что-то могло сломаться.
Ничего не исправляй, только перечисли замечания по файлам и поставь рядом «серьёзно» или «мелочь».

Пример: после правки из шаблона 3. Проверьте: пройдитесь по списку замечаний сами и решите, какие из них реальные.

6. Объяснить непонятный код

Объясни, что делает код в файле [файл], строки [от] и [до]. Расскажи простыми словами, как будто я не программист.
Приведи пример входа и выхода. Файл не меняй.

Пример: «файл app/discount.py, строки 10 и 40». Проверьте: задайте вопрос «а что будет, если вместо числа придёт пустое значение?» и сравните ответ с тем, что видите в коде.

7. Составить план большой задачи

Большую задачу нельзя отдавать целиком: разбейте её на шаги, которые можно проверить по отдельности.

Хочу: [что получить в итоге]. Ничего не меняй. Составь план из шагов, каждый шаг должен проверяться отдельно.
Для каждого шага напиши: что меняем, в каких файлах, как проверить. Отдельно перечисли риски и вопросы ко мне.

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

8. Навести порядок без смены поведения

Это переименование, разбивка длинных кусков, удаление дублей. Работа, где легко что-то сломать, поэтому рядом нужны тесты.

Приведи в порядок файл [файл]: понятные имена, короткие функции, без дублей. Поведение менять нельзя.
Запусти тесты до и после правки командой [команда] и покажи оба результата.

Пример: команда проверки у вас может быть своя, ищите её в AGENTS.md. Проверьте: результат тестов до и после должен совпасть.

9. Написать README

README - короткая страница о проекте: что это, как запустить, как проверить. Её первой откроет человек, которому вы отдали проект.

Прочитай проект и напиши README.md на русском: что это, как установить, как запустить, как проверить, где лежат главные файлы.
Только то, что точно видно в проекте. Если чего-то не знаешь, пометь «уточнить».

Пример: можно добавить «объём до одной страницы». Проверьте: пройдите по инструкции запуска сами, как будто вы новый человек.

10. Придумать сообщение к сохранению

Посмотри изменения (git diff) и предложи сообщение к сохранению: первая строка до 70 знаков, дальше при необходимости два-три пояснения.
Только предложи, сохранять не нужно.

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

11. Найти секреты и опасные места

Помощник ищет ключи, пароли и файлы, которые не должны попасть в общий доступ. Это не замена специальным проверкам, а быстрый первый просмотр.

Ничего не меняй. Просмотри проект и найди места, похожие на ключи доступа, пароли, токены и личные данные.
Выведи список: файл, строка, что нашёл. Сами значения в ответе скрой, оставь первые три символа.
Отдельно скажи, есть ли в проекте файлы вроде .env и исключены ли они из общего набора.

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

12. Составить отчёт только на чтение

Подходит и для ручного запуска, и для автоматики из модуля про запуск без окна.

Только чтение, ничего не меняй. Прочитай файлы проекта и составь отчёт: что есть, что выглядит устаревшим, где пометки TODO.
Формат: список по файлам, по одному предложению на файл.

Пример: сохраните ответ в файл report.md. Проверьте: выберите две-три строки и сверьте с реальными файлами.

13. Создать файл правил AGENTS.md

Изучи проект и предложи содержимое файла AGENTS.md: назначение проекта одним абзацем, команды запуска и проверки, правила стиля, список запретов, где лежат важные папки.
Файл не сохраняй, покажи текст. Не включай никаких ключей и паролей. Где не уверен, пиши «уточнить».

Пример: потом сравните с шаблоном на странице стартового набора. Проверьте: каждую команду из файла запустите сами.

Можно ли менять готовые шаблоны промптов под себя?

Можно и нужно. Шаблон - только каркас: замените названия файлов, ограничения и критерии проверки на свои. Если результат не устроил, меняйте одну часть за раз и сравнивайте. Удачные варианты сохраняйте в свои команды или в правила проекта, и библиотека будет расти вместе с вашим опытом.

Про свои команды читайте в модуле про навыки и команды.

Всегда ли готовый промпт даёт правильный результат?

Нет. Результат зависит от инструмента, модели, проекта и точности ваших данных, а нейросеть может ошибаться. Поэтому в каждом шаблоне есть критерий проверки: смотрите на результат, запускайте, сравнивайте и не принимайте ответ на веру. Звучит нейросеть уверенно, даже когда неправа, так что доверяйте проверке, а не тону.