29 lines
2.4 KiB
Markdown
29 lines
2.4 KiB
Markdown
---
|
||
title: Runbook — tasks
|
||
summary: Как работать с тасками mappa: ориентация (task_list/board_digest), взятие (status+owner, version+409), ведение (comment-след, blocked_by), optimistic-конфликт 409→retry, закрытие с Review-методом. Контракт: wiki:2660.
|
||
type: runbook
|
||
tags: [mappa, runbook, task, agent]
|
||
---
|
||
# runbooks/tasks — как работать с тасками
|
||
|
||
Процедура «взять → вести → закрыть таску». Канон-контекст: [[canon/gates]] Г2 (каналы), Г4 (адресация). Обновляется при изменениях.
|
||
|
||
## 1. Ориентация / выбор
|
||
- Доска: `task_list(project, status=…)` (компакт: ref/status/priority/title) или `board_digest(project)` (счётчики + overdue/blocked).
|
||
- Взять: `task_get(ref)` → свежая `version` → `task_update(status='active', owner=<identity>, version)` — CAS; конфликт → 409 (см. п.3).
|
||
- Owner — только реально работающий; не брать чужую active-таску.
|
||
|
||
## 2. Ведение
|
||
- `comment_create` — короткий след «где остановился» (не носитель вердиктов — они письмами, канон Г2).
|
||
- blocked_by: `edge_create(from, to, blocked_by)` / снять `edge_delete` (парные review-таски).
|
||
- Пауза/переключение: `task_update(status='paused'|'ready', reason)`.
|
||
|
||
## 3. Optimistic-конфликт (version+409 → retry)
|
||
> **Optimistic-конфликт:** update/close идут с `version` (из `task.get`) → конфликт → **409** → перечитай `task.get` свежим → retry с новой `version`. НЕ работай со stale-version (виден по POST /session 14.7%, POST /requirements/update 23.1% — телеметрия, дайджест 2069).
|
||
|
||
## 4. Закрытие
|
||
- `task_close(ref, version)`: критерии приёмки выполнены И review-метод из `**Review:**` поля исполнен (правило 14: subagent прогнан / next-session review-таска существует / none обоснован).
|
||
- done → парная review-таска разблокируется (если была).
|
||
|
||
**Связи:** [[runbooks/index]] · [[canon/gates]] · [[canon/index]]
|