Длительный рабочий процесс агента

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

Цели

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

Используйте docs/agent-runs/<slug>/, когда людям, проверяющим ботам или нескольким цепочкам инструментов требуется одно и то же состояние задачи.
Используйте локальный каталог инструмента, например .codex/runs/<slug>/, только в том случае, если состояние задачи намеренно локально для одной рабочей станции или одной цепочки инструментов.
Не скрывайте общее состояние нескольких сеансов в личном рабочем файле, если оно понадобится другому участнику или агенту позже.

Создайте эти файлы в начале длительной задачи:

Используйте шаблоны docs/agent-playbooks/templates/feature-list.template.json и docs/agent-playbooks/templates/progress.template.md.

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

Запустите pwd.
Прочитайте progress.md.
Прочитайте feature-list.json.
Запустите git log --oneline -20.
Запустите ./scripts/agent-init.sh --smoke.
Выберите ровно один элемент с наивысшим приоритетом, который по-прежнему имеет значение pending, in_progress или blocked.

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

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

Добавьте короткую запись о ходе выполнения в progress.md.
Обновите затронутый элемент в feature-list.json.
Запишите точные команды, выполняемые для проверки.
Захват блокирующих, последующих действий и следующего лучшего объекта для возобновления.