Глава 19

Codex: начните с цели, контекста и режима

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

Поверхности решают разные задачи, и это стоит учитывать при выборе.

Поверхность · Практическое применение · Контекст

  • CLI - Работа в terminal, scripts и non-interactive runs; Текущий checkout, инструкции и настроенные tools
  • IDE extension - Изменение кода рядом с editor; Открытый project и выбранные файлы
  • ChatGPT desktop app - Несколько chats, local projects, worktrees и визуальный workflow; Проект, chat и подключенные capabilities
  • Cloud - Задача в изолированной cloud environment; Настроенный repository и environment

Первый практический prompt показывает каркас в действии - focused bug fix с явными Context, Constraints и Done when.

Goal: Исправь расчет скидки: 20 должно означать 20%, а не множитель 20.
Context: src/discount.js, tests/discount.test.js. Сначала воспроизведи тест.
Constraints: не меняй public signature, не добавляй зависимости, пиши только в src/discount.js.
Done when: focused test и npm run check завершились с code 0; покажи diff и exit codes.

Официальное руководство Codex формулирует этот каркас как Goal, Context, Constraints и Done when. Для complex или ambiguous task используется Plan mode, чтобы согласовать подход до изменения; повторяемые репозиторные правила переносят в AGENTS.md, а workflow - в skill. Короткий daily loop складывается из шести шагов: открыть trusted checkout и проверить git status, дать контракт и попросить исследование, проверить files и commands в плане, разрешить минимальный patch в workspace, попросить focused test и final diff, запустить отдельный /review.

Поверхность не меняет права автоматически. Local, cloud и app environments имеют разные boundaries. Перед запуском проверьте текущий sandbox, approvals, network и writable roots, а не полагайтесь на привычку из другой поверхности.

Первый prompt отправлен. Теперь настроим постоянные механизмы Codex: AGENTS.md, skills, config, hooks и MCP.

Ссылки