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

Codex — не поисковая строка, куда нужно найти «идеальный промпт». Стабильный результат даёт процесс: цель → контекст → план → разрешения → изменение → тесты → review → следующий шаг.

1. Подготовьте проект

Работайте в Git-репозитории или копии папки. Уберите секреты. Проверьте исходные тесты. Запишите постоянные команды и ограничения в AGENTS.md — документация OpenAI описывает многоуровневые проектные инструкции.

2. Сформулируйте результат

Вместо «улучши лендинг»:

На странице /pricing добавь сравнение трёх планов по приложенному тексту. Используй текущие компоненты. Не меняй цены, зависимости и другие маршруты. Сначала покажи план. Готово, когда проходят тесты и таблица читается на ширине 390 px.

Хороший бриф содержит:

  • видимый результат;
  • источник фактов;
  • область работы;
  • запреты;
  • acceptance checks;
  • формат итогового отчёта.

3. Попросите исследование и план

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

4. Управляйте разрешениями

Для обычной работы удобен режим, где внешние и потенциально опасные действия требуют подтверждения. Проверяйте команды установки, удаление, Git history, сеть и deployment. Permission modes нужно настраивать под цену ошибки.

5. Проверяйте прогресс по фактам

Не спрашивайте только «готово?». Просите:

  • текущий список файлов;
  • выполненные тесты;
  • блокеры;
  • отличия от плана;
  • непроверенные предположения.

Если агент повторяет одно действие, остановите цикл и уменьшите задачу.

6. Читайте diff

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

7. Повторите тесты

В Codex CLI есть review workflow, но сообщение агента не заменяет фактический запуск. Повторите тесты, сборку и ключевой пользовательский сценарий.

8. Получите handoff

В конце попросите четыре блока:

  1. Что изменено.
  2. Что проверено.
  3. Что не проверено.
  4. Как откатить и какой следующий шаг.

Когда создать Skill

Если один и тот же бриф повторяется — выпуск статьи, проверка PR, отчёт — перенесите процесс в Codex Skill. Skill хранит инструкции и ресурсы, а конкретный запрос содержит данные текущей задачи.

Чеклист остановки

Остановите агента, если он расширяет scope, просит доступ без объяснения, повторяет ошибочную команду, удаляет защитные проверки или объявляет результат без тестов.

Итог

Пользоваться Codex — значит управлять рабочим циклом, а не просто переписываться. Маленькие задачи, ясные границы, минимальные права и воспроизводимая проверка дают больше пользы, чем длинный «магический» промпт.