Справочный материал

Проект и задачи в Codex

Короткое правило курса: один проект для разрешённых исходников, отдельная задача для каждого нового результата. Уточнения и исправления текущего результата остаются в той же задаче.

Время
Справочный материал
Артефакт
Дополнительный материал к заданиям курса
Контрольная точка
Материал прочитан в контексте соответствующего задания

Короткое правило курса: один проект для разрешённых исходников, отдельная задача для каждого нового результата. Уточнения и исправления текущего результата остаются в той же задаче.

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

Проект — папка, задача — разговор о результате

Проект связывает Codex с папкой исходников. В наших упражнениях это, например, C:\AI-Course-Work\Demo83-Sources или C:\AI-Course-Work\UNF-Agent-Lab. Прежде чем открыть папку, проверь её состав по уроку безопасности. Проект с исходниками не равен информационной базе 1С: подключение и проверка в базе остаются отдельным действием.

Задача — отдельный диалог внутри проекта: «исследовать документ Заказ», «добавить реквизит заказа», «создать обработку импорта прайса». Диалоги одного проекта видят доступные им файлы, но у каждого своя история сообщений. Новый диалог читает текущее состояние файлов, поэтому уже принятое изменение видно и без копирования прежней переписки. Проверь, что оно действительно находится в той папке или ветке, которую ты открыл.

В Codex Desktop открой проект с нужной папкой и создай в нём новую задачу. Закончил результат — вернись в список задач этого проекта, чтобы позже открыть нужный разговор. Если у тебя другой интерфейс или версия, ориентируйся на те же две вещи: выбранная папка и отдельный диалог с ясной целью.

Когда продолжать, а когда начать новую задачу

Ситуация Что делать
Агент исследовал заказ, а тебе нужно уточнить найденное поле Продолжить эту задачу
Поле добавлено, но не сохраняется после открытия документа Вернуться в задачу про поле и исправить результат
Поле принято, теперь нужна печатная команда Начать новую задачу в том же проекте
Импорт прайса готов, теперь нужен HTTP-сервис Начать новую задачу с названием новой цели

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

Что написать в новой задаче

Не пересылай весь старый диалог. Назови предыдущий результат, текущую цель и проверку:

В этом учебном проекте уже добавлен реквизит заказа
AI_КомментарийДляПечати. Проверь его в текущих исходниках расширения.
Теперь нужна отдельная печатная команда: номер, дата и этот реквизит.
Сначала найди механизм печати в нашей версии УНФ и покажи план.
Меняй только расширение. После изменения покажи diff и способ
проверить карточку на вымышленном заказе.

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

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