Как начать в Codex: первые задачи для ИИ-агента

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

Codex помогает работать с файлами проекта и выполнять задачи, которые ты описываешь обычными словами. Ты задаёшь направление; агент предлагает или вносит изменения в пределах доступов; ты смотришь, что получилось. Важное правило простое: не делегируй проверку тому же ответу, который сообщает «всё готово».

Семь привычек для первого проекта

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

2. Объясни, где ты работаешь. Скажи, какие файлы уже есть, что нельзя затрагивать и для кого предназначен проект. Если не знаешь, где нужный файл, сначала попроси агента разобраться в структуре.

3. Попроси сначала изучить, потом менять. Для незнакомого проекта полезно начать с вопроса: «Посмотри файлы и коротко объясни, как устроен этот экран. Пока ничего не меняй». Так ты увидишь, совпадает ли понимание агента с твоим.

4. Согласуй план. Если задача затрагивает несколько мест, попроси перечислить шаги и файлы до начала работы. Исправь план, если там есть лишнее или потерялось важное условие.

5. Ограничь область изменений. Укажи, что нужно изменить и что оставить как есть. Это не бюрократия: так проще заметить неожиданную правку.

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

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

Шаблон первого запроса

Можно начать с такой заготовки и подставить свои детали:

«Цель — [что должно работать]. Сначала изучи проект и назови файлы, которые относятся к задаче. Пока ничего не меняй. Предложи короткий план и укажи, как проверить результат. Не трогай [важные ограничения]. После моего ответа внеси только согласованные изменения и перечисли, что проверил».

Когда план готов и понятен, попроси выполнить один этап. Затем открой результат. Если в нём ошибка, опиши её через наблюдение: «После нажатия кнопки сигнал не появляется» — полезнее, чем «не работает».

Что проверить перед тем, как принять работу

Сверь задачу с результатом по трём вопросам:

Появилось ли то, о чём ты просил?
Не изменилось ли что-то за пределами договорённости?
Можешь ли ты сам запустить результат и повторить проверку?

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

Практика вместо экскурсии по меню

Одной статьи достаточно, чтобы понять общий подход, но навык появляется, когда ты сам ставишь задачу, видишь созданный файл и проверяешь его. В первой главе RELAY этот цикл встроен в сюжет: ты знакомишься с ИИ-агентом, собираешь первый пульт станции и проверяешь, появляется ли сигнал.

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