Справочный материал
Проект и задачи в 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 подходит для постоянных правил проекта, но не для истории всех переписок.
Новая задача сама по себе не создаёт отдельную копию файлов и не ограничивает доступ сильнее, чем выбранный проект. Параллельные изменения одной папки требуют отдельной организации работы; в курсе сначала завершаем один шаг и только потом начинаем следующий.