Как выбрать первую задачу для Codex

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

Краткий ответ

Codex — это агент для работы с кодом: он может изучать репозиторий, менять файлы и запускать доступные инструменты в пределах выданных разрешений. Качество первой попытки сильнее зависит от границ задачи и проверяемого результата, чем от «магической» формулировки.

Какая задача подходит для старта

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

Подходящие примеры:

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

Формулировка «улучши весь проект» почти не задаёт границ. Агенту придётся самостоятельно решать, что считать улучшением, а вам будет трудно отличить полезный результат от лишней переработки.

Сначала определите тип работы

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

1. Объяснение — Codex читает код и возвращает карту потока данных, риски или ответы на вопросы. 2. Диагностика — агент воспроизводит проблему и устанавливает причину, но не обязан менять код. 3. Реализация — агент вносит изменения, добавляет проверки и доводит задачу до заданного результата. 4. Ревью — агент ищет дефекты в уже подготовленном diff и ранжирует замечания по серьёзности.

Если написать «посмотри баг», непонятно, разрешено ли исправление. Фраза «воспроизведи, установи причину, исправь и добавь тест» снимает эту неоднозначность.

Граница задачи и цена ошибки

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

Перед передачей задачи оцените:

Вопрос Безопасный ответ

Где разрешены изменения? Названы каталоги или компоненты

Что нельзя менять? Зафиксированы API, схема или пользовательские данные

Как проверить результат? Есть тест, команда или ручной сценарий

Можно ли отменить изменение? Изменения видны в Git и не затрагивают внешнее состояние

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

Пример первой постановки

Вместо:

Исправь рейтинг.

используйте:

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

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

Готово, когда целевые тесты проходят, а в браузере у гостя нет нижней плашки.

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

Практика: карточка делегирования

Возьмите одну задачу из своего backlog и заполните:

результат одним предложением;
известный симптом или исходное состояние;
файлы, экран или сервис, с которого стоит начать;
два ограничения «не менять»;
способ автоматической проверки;
один ручной сценарий;
условие, при котором агент должен остановиться и спросить вас.

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

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

Нужно ли сначала идеально изучить Codex?

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

Можно ли дать Codex большую функцию целиком?

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

Какая задача плохо подходит агенту?

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

Что важно запомнить

Делегируйте проверяемый результат, а не абстрактную активность.
Явно различайте объяснение, диагностику, реализацию и ревью.
Чем выше цена ошибки, тем важнее границы, подтверждения и путь отката.
Хорошая первая задача ограничена, воспроизводима и видна в Git.

https://yadro-code.ru/lessons/without-university/codex-agent-workflows/codex-agent-01