Антон Ларичев

/goal в Codex задаёт постоянную цель: агент продолжает работу после обычного хода, пока не достигнет условия остановки. Команда запускается как /goal <цель>, а управляется через /goal pause, /goal resume, /goal edit и /goal clear. Хорошая цель содержит четыре вещи: что сделать, что нельзя менять, чем проверять прогресс и когда остановиться.
Ниже — как включить функцию, как сформулировать цель и чем /goal отличается от Ralph Loop.
Что делает /goal
Обычный запрос заканчивается, когда агент отвечает. /goal привязывает цель к текущему чату, и Codex продолжает двигаться к ней через несколько ходов. В документации OpenAI сказано, что так агент может самостоятельно работать много часов.
Команды:
| Команда | Что делает |
|---|---|
/goal Текст цели | задаёт цель |
/goal | показывает текущую цель |
/goal edit | изменяет формулировку |
/goal pause | ставит на паузу |
/goal resume | продолжает работу |
/goal clear | удаляет цель |
Текст цели должен быть непустым и не длиннее 4 000 символов. Если инструкция больше, положите её в файл и укажите этот файл в цели.
Как включить
Если /goal нет в списке команд, обновите Codex и включите функцию:
codex features enable goalsТо же самое можно сделать в ~/.codex/config.toml:
[features]
goals = trueПроверить состояние можно так:
codex features list | grep goalsЕсли Codex ещё не настроен, начните со статьи Как войти в Codex из России.
Какие задачи подходят
По рекомендации OpenAI цель должна быть больше одного запроса, но меньше открытого списка дел.
Подходят:
- миграция, где понятны целевой стек и проверка совпадения поведения;
- большой рефакторинг с тестами после каждого этапа;
- реализация готового плана с чёткими вехами;
- прототип, который можно собрать и запустить.
Не подходят:
- набор несвязанных задач;
- формулировки вроде «улучши проект»;
- работа без способа проверить результат;
- решения, которые требуют вашего участия на каждом шаге.
Как написать хорошую цель
Слабая цель:
/goal Перепиши авторизациюЗдесь непонятно, что считать готовым, какой код можно менять и когда остановиться. Лучше так:
/goal Перенеси авторизацию с сессий на JWT по плану docs/auth-plan.md.
Не меняй публичные маршруты API и схему таблицы users.
После каждого этапа запускай npm test и npm run typecheck.
Записывай прогресс в docs/auth-progress.md: этап, проверка, что осталось.
Остановись, когда все этапы плана выполнены и обе команды проходят.
Остановись и спроси меня, если понадобится новая миграция базы.Разберём, что здесь важно.
Одна цель и одно условие остановки. Codex должен понимать, что значит «готово», ещё до старта.
Источник правды. Укажите план, задачу, логи или документацию, которые нужно прочитать первыми.
Ограничения. Перечислите, что нельзя менять.
Доказательство прогресса. Назовите команды или артефакты, которые подтверждают результат.
Контрольные точки и журнал. Короткий файл с прогрессом помогает понять, что произошло за время работы.
Условие паузы. Если агент дошёл до решения, которое должны принимать вы, пусть он остановится, а не угадывает.
Как подготовить план
Большую цель удобно обсудить заранее. Попросите Codex задать вопросы и составить план в режиме /plan, сохраните результат в файл и только затем запускайте цель:
/goal Реализуй PLAN.md. Для каждой вехи напиши тесты и проверь результат командой npm test.
Останови работу, если веха не проходит проверку после трёх разных попыток.Файл с инструкциями проекта тоже важен: команды сборки и правила кода лучше вынести в AGENTS.md, а не повторять их в каждой цели.
Как следить за работой
В ходе длинной задачи полезно просить короткий отчёт: текущая веха, что проверено, что осталось и есть ли блокировка.
Если отчёты становятся расплывчатыми, не добавляйте много разовых указаний. Лучше уточните цель через /goal edit: какая веха важна сейчас, какая команда её подтверждает и что должно поставить работу на паузу.
Если направление изменилось, используйте /goal pause или /goal clear. После завершения посмотрите изменения в git и сами запустите проверки.
/goal или Ralph Loop
/goal | Ralph Loop | |
|---|---|---|
| Где живёт цикл | внутри сессии Codex | в вашем скрипте |
| Кто решает, что готово | агент по заданному условию | внешняя команда проверки |
| Контекст | одна длинная сессия | может быть свежим на каждой итерации |
| Порог входа | одна команда | нужно написать скрипт |
| Интеграция с CI | не основной сценарий | естественная |
| Лучше подходит для | большой задачи с планом | серии проверяемых итераций |
Практическое правило: начните с /goal, если есть хороший план и вы работаете в интерактивной сессии. Выбирайте Ralph Loop, если проверка должна быть жёстко вынесена из агента, нужен запуск без присмотра или свежий контекст на каждом шаге.
Частые ошибки
- Нет условия остановки. Агент сам решает, когда хватит.
- Слишком общая цель. Разбейте её на отдельные цели или составьте план.
- Проверка не запускается локально. Сначала убедитесь, что команда работает без вашего участия.
- Недостаточно прав. Настройте песочницу заранее, но не отключайте её без изоляции окружения.
- Много изменений без контрольных точек. Попросите делать коммиты или вести журнал по этапам.
Частые вопросы
Нужно ли сидеть рядом? OpenAI описывает /goal как фоновую задачу, но результат и изменения всё равно нужно проверить.
Можно ли изменить цель на ходу? Да, через /goal edit.
Есть ли лимит на цель? Текст ограничен 4 000 символов. Подробности выносите в файл.
Сколько токенов расходует длинная цель? Заранее это не определить: всё зависит от размера проекта и числа шагов. Для первого запуска выберите небольшую задачу.
Итог
/goal работает настолько хорошо, насколько точно описан результат. Назовите цель, ограничения, проверку и условие остановки, а большие инструкции вынесите в файл. Как выбирать между /goal и автономными циклами на реальном проекте, разбираем в модуле о долгих задачах курса «Продвинутый Codex».






Комментарии
0