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

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

Когда включать режим Plan

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

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

Как включить Plan и сформулировать задачу

По справке OpenAI, режим переключается командой /plan или сочетанием Shift + Tab. В приложении можно ввести /plan в поле сообщения, чтобы Codex сначала изучил задачу и предложил подход до редактирования, как описано в руководстве по запросам. Интерфейс может отличаться между приложением, терминалом и расширением, поэтому ориентируйтесь на доступный переключатель режима.

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

Пример: «В форме регистрации кнопка показывает успех, но после обновления запись исчезает. Найди путь данных от формы до хранилища. Предложи минимальное изменение без смены формата API. План должен включать воспроизведение, правку, проверку сохранения после обновления и риск отката». Такой запрос даёт агенту результат и границы. OpenAI советует указывать поведение, контекст, ограничения и проверку.

Как проверить предложенный план до работы

Проверяйте план как короткое техническое решение, а не как обещание результата. В хорошем ответе видно, откуда взялся вывод, какие файлы будут затронуты, что будет проверено и где потребуется решение человека. Режим Plan помогает собрать контекст и уточнения, но качество плана зависит от исходной задачи и доступных материалов по описанию OpenAI.

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

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

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

Как перейти от плана к выполнению

После проверки плана сформулируйте продолжение явно: какие пункты выполнять, какие ограничения сохраняются и какая проверка обязательна. Не считайте сам текст плана доказательством, что код уже изменён или тест пройден. Официальный материал OpenAI описывает Plan как исследование и предложение подхода до редактирования. Когда работа длинная, в некоторых версиях доступен отдельный режим Goal для продолжения результата через несколько ходов; это другая функция, описанная OpenAI.

Попросите после каждого существенного шага показать изменённые файлы, команду проверки и вывод о том, выполнен ли критерий. При ошибке возвращайтесь к доказательству: шаг воспроизведения, журнал, тест. Смена режима или новая формулировка задачи сама по себе ошибку не устраняет. Для повторяющихся правил проекта лучше держать их в AGENTS.md: OpenAI указывает, что этот файл передаёт агенту устройство проекта, команды проверки и ограничения.

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

Частые ошибки при планировании

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

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

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

Plan сам меняет файлы?

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

Чем Plan отличается от Goal?

Plan отвечает за подход перед изменением, а Goal поддерживает длительное движение к результату. Это разделение описано в материале OpenAI.

Нужен ли отдельный файл PLANS.md?

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

Что делать, если план слишком расплывчатый?

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