Промты для Codex: шаблоны задач и проверка результата

Хороший промпт для Codex описывает результат, указывает проект или нужные файлы, задаёт существенные границы и объясняет, как проверить работу. Ниже готовы шаблоны для ошибки, небольшой функции и проверки изменений. Они рассчитаны на работу с вашим проектом в настольном приложении или другом интерфейсе Codex, где агент видит разрешённые файлы. Официальная документация OpenAI рекомендует именно поведение, контекст, ограничения и проверку.

С чего начать работу с промптом

Сначала откройте нужную папку проекта в настольном приложении и выберите задачу Codex. Справка по приложению поясняет, что выбранная папка задаёт доступный файловый контекст. CLI и расширение редактора подходят тем, кто уже работает в терминале или среде разработки. Если инструмент ещё не настроен, воспользуйтесь руководством по установке Codex.

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

• Назовите нужное поведение и место в приложении.
• Дайте путь к файлу или воспроизводимые действия, если они известны.
• Укажите одно-два ограничения, нарушение которых недопустимо.
• Попросите показать изменённые файлы, команды проверок и оставшиеся неизвестные.

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

Шаблон для исправления ошибки

Для ошибки важны точные шаги воспроизведения и ожидаемое поведение. OpenAI в примере для Codex советует дать рецепт воспроизведения, подозреваемые файлы, ограничения и попросить повторить проверку после исправления.

1. Запишите действия от запуска приложения до сбоя.
2. Назовите ожидаемый и фактический результаты отдельно.
3. Приложите сообщение об ошибке без токенов и личных данных.
4. Попросите минимальную правку и повторное воспроизведение.

Исправь ошибку формы в этом проекте.
Как повторить: открой /settings, включи уведомления, нажми «Сохранить», обнови страницу. Настройка сбрасывается.
Ожидается: значение остаётся после обновления.
Ограничения: не меняй формат API и не трогай другие настройки.
Сначала воспроизведи ошибку. После правки повтори шаги, запусти ближайшие тесты и покажи изменённые файлы и результаты.

Маршрут /settings и формулировки в примере условны. Подставьте свои. Если ошибка проявляется лишь на проде, не поручайте агенту менять его без установленного процесса: сначала просите исследование и безопасный способ воспроизведения. Для подробной работы с интерфейсом есть статья о дизайне с Codex.

По теме: Codex обучение: практический план на 7 дней в 2026 году

Шаблон для новой небольшой функции

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

Добавь в форму поиска подсказку при отсутствии результатов.
Результат: после запроса с пустой выдачей виден текст «Ничего не найдено» и кнопка очистки; при новом вводе сообщение обновляется.
Сохрани существующий способ обращения к API и стили проекта. Не меняй серверные маршруты.
Проверь пустой результат, успешный результат и сетевую ошибку. Покажи, какие команды запускались и что осталось непроверенным.

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

Шаблон для анализа без правки

Если вы ещё не знаете причину проблемы, попросите сначала проследить путь данных. Официальные примеры Codex показывают такой формат для объяснения кодовой базы и отдельный запрос на локальный обзор. Это полезно перед изменением платежей, авторизации или долгой цепочки вызовов.

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

После ответа проверьте, что названные пути существуют, а цепочка вызовов действительно проходит через них. Если диагностика подтвердила причину, отправьте отдельный запрос на узкую правку. По устройству проекта помогают устойчивые правила в AGENTS.md: OpenAI описывает их чтение Codex.

По теме: Codex и Obsidian: как работать с заметками без потерь

Как оценить готовый результат

Используйте проверяемый список при принятии работы. Просьба «проверь всё» часто создаёт расплывчатый отчёт, а просьба назвать конкретные команды и наблюдаемое поведение позволяет перепроверить результат самостоятельно.

1. Сверьте изменённые файлы с исходной границей задачи.
2. Проверьте основной сценарий и один граничный случай руками либо тестом.
3. Посмотрите точные команды, коды завершения и вывод проверок.
4. Убедитесь, что неизвестное отмечено неизвестным, а развёртывание или публикация не выданы за локальную проверку.

Если результат не подходит, уточните одно расхождение: «Сообщение появляется, но не исчезает при новом вводе. Исправь только этот переход и повтори проверку». Документация OpenAI допускает уточнение уже идущей задачи и советует сообщать о конкретной нужной правке. Для управления отдельными сеансами полезен разбор сохранения сессии Codex.

Частые вопросы

Нужно ли писать длинный промпт?

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

Можно ли отправить скриншот?

Да, если внешний вид важен. Допишите текстом поведение, которое не видно на изображении, например состояние ошибки или действие кнопки. Это рекомендует OpenAI.

Что делать, если Codex изменил лишнее?

Сверьте разницу файлов и назовите лишние изменения. Попросите вернуть их, сохранив нужную правку, затем снова выполните проверку.

Достаточно ли ответа «готово»?

Нет. Нужны наблюдаемый результат, список файлов и подтверждение проверок. Если проверка недоступна, агент должен прямо сказать об этом.