Перейти до основного вмісту

Тривалий робочий процес агента

Використовуйте цей посібник, коли завдання, ймовірно, охоплюватиме кілька сеансів, передачі обслуговування або створених агентів.

Цілі​

  • Надайте кожному новому сеансу швидкий спосіб відновити контекст
  • Продовжуйте роботу поетапно, а не одноразово вносьте великі зміни
  • Перш ніж додавати код, знайдіть несправну локальну базову лінію
  • Залиште довговічні артефакти, яким можна довіряти наступному сеансу

Де зберігати державу​

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

Необхідні файли​

Створіть ці файли на початку довгострокового завдання:

  • feature-list.json
  • progress.md

Використовуйте шаблони в docs/agent-playbooks/templates/feature-list.template.json і docs/agent-playbooks/templates/progress.template.md.

Віддайте перевагу JSON для списку функцій, щоб агенти могли оновлювати невелику кількість полів, не переписуючи весь документ.

Контрольний список початку сеансу​

  1. Запустіть pwd.
  2. Прочитайте progress.md.
  3. Прочитайте feature-list.json.
  4. Запустіть git log --oneline -20.
  5. Запустіть ./scripts/agent-init.sh --smoke.
  6. Виберіть рівно один елемент із найвищим пріоритетом, який все ще є pending, in_progress або blocked.

Якщо етап димування не вдається, виправте порушену базову лінію перед впровадженням нового фрагмента функції.

Правила сесії​

  • Працюйте над однією функцією або фрагментом завдання за раз.
  • Зберігайте список функцій машиночитаним і стабільним. Оновіть статус, примітки, файли та поля підтвердження замість переписування непов’язаних елементів.
  • Позначайте елемент перевіреним лише після виконання команди або потоку користувача, зазначеного в цьому елементі.
  • Використовуйте породжені агенти для обмежених фрагментів, а не для загального володіння станом завдання.
  • Якщо дочірній агент володіє одним елементом, надайте йому точний ідентифікатор елемента, критерії прийняття та файли, яких він може торкатися.

Контрольний список на кінець сесії​

  1. Додайте короткий запис про прогрес до progress.md.
  2. Оновіть торкнувся елемент у feature-list.json.
  3. Запишіть точні команди для перевірки.
  4. Блокувальники захоплення, подальші дії та наступний найкращий елемент для відновлення.

Рекомендована форма запису прогресу​

Використовуйте коротку структуру, наприклад:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.