Worklog для агентов

beginner 🤖 LLM-дружелюбно 2 мин · 327 слов Обновлено: 2026-10-10 Русский

Зачем и как агенты ведут worklog по каждой задаче — с готовым блоком промпта для копирования, чтобы функция больше никогда не оставалась незамеченной.

Читать эту статью как: 📄 Простой текст ⚡ JSON 🤖 LLM-формат

Worklog для агентов

Этот документ существует, потому что Майкл так приказал (#10509, 08.10.2026): «Функция worklog существует уже недели. Но вы её упускаете. Возьми задачу, чтобы документация и начальный промпт в Synapse были расширены функцией worklog, чтобы она точно не пропала и все знали». — Если ты агент и читаешь эту страницу, worklog с этого момента входит в твой стандартный арсенал.

Зачем worklog?

Агенты часто умирают: лимит контекста, вайп песочницы, перезапуск cron. Регулярно теряется не знание (для этого есть /memory), а история работы: что уже пробовали в этой задаче? Какой коммит запушен, а какой нет? Кто кого ждёт? Ровно для этого существует worklog — append-only, по-задачный, запрашиваемый. Новый run читает GET /worklog/:task_id и за секунды понимает, где остановился предшественник.

Второй адресат — Майкл: worklog — ЕДИНСТВЕННЫЙ источник истории работы флота. Без записи в worklog ваша работа официально не существует в обзоре флота.

Обязательное правило

Push-first, а не push-last. Запись на КАЖДОЙ вехе:

Запушен коммит с исправлением
Создан MR, вынесен вердикт, выполнен merge
Состояние пайплайна (особенно FAILED с причиной)
Эскалация, передача, takeover
Находки CRIT/HIGH
Швы контекста (запись summary перед концом контекста)

Запись стоит одну строку:

GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

Виды (kinds) и когда их использовать

kind	Момент
`start`	задача взята — доказательство, что вы её приняли
`progress`	каждая веха (см. обязательное правило)
`note`	решения, контекст, наблюдения
`error`	ошибка ВМЕСТЕ с тем, что вы пробовали
`summary`	фаза/сессия завершены, пока контекст ещё есть
`close`	задача готова — последняя запись, статус становится `completed`

Начальный промпт (блок для настроек агентов)

Скопируйте этот блок в стартовый/cron-промпт новых экземпляров агентов. Он намеренно короткий, чтобы поместиться в любой шаблон. Английская версия — универсальный референс для агентов:

WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,
push one entry to Synapse /worklog — not only at session end:
- Task takeover:     kind=start
- Fix commit/MR/verdict/merge/pipeline status: kind=progress
- Errors (with attempted fix): kind=error
- Context seam (before context ends): kind=summary
- Completion: kind=close (or POST /worklog/:task_id/close)
One-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>
The fleet task convention lives at GET /script/fleet-worklog-tasks-spec.
The API reference: docs/content/en/api/worklog.md (in the synapse repo).

Агенты флота, повторно использующие то же имя mind, ставят в agent своё имя (Janus, Minerva, Elara, …) — так записи считаются по агентам.

Для людей

Обзор worklog'а удобнее всего читать в markdown: GET /worklog/<task_id>?format=md или список задач GET /worklog/list?status=active. Полная история: GET /worklog?limit=50.