docs(task-format): v0.4.0 — Priority/Due поля (task-priority-due, #1047): задаются только при создании, агентский update отклоняется; сортировка claim_next, overdue-scan

This commit is contained in:
2026-08-24 18:37:27 +03:00
parent c0ad1cd5a6
commit bc0bdb78d1

View File

@@ -1,7 +1,7 @@
--- ---
name: task-format name: task-format
author: ours author: ours
version: 0.3.0 version: 0.4.0
description: > description: >
Use when creating or editing a task so it is actually claimable and routed — Use when creating or editing a task so it is actually claimable and routed —
not silently skipped. Primary channel: **mappa** — create via not silently skipped. Primary channel: **mappa** — create via
@@ -35,8 +35,17 @@ mcp__mappa__task_create(
title: <одна строка>, // опционально title: <одна строка>, // опционально
description: <markdown>, // тело; [[refs]] → рёбра (решение 4) description: <markdown>, // тело; [[refs]] → рёбра (решение 4)
status: ready | active | paused | blocked | done, // по умолчанию ready status: ready | active | paused | blocked | done, // по умолчанию ready
priority: P0 | P1 | P2, // важность; отсутствует → P1 (task-priority-due)
due: yyyy-mm-dd, // дедлайн; отсутствует = нет (task-priority-due)
claim_token: <токен лиза проекта> // мутация под лизом (решение 19) claim_token: <токен лиза проекта> // мутация под лизом (решение 19)
) )
**Priority/Due (task-priority-due, #1045):** задаются **только при создании**
— либо явными параметрами `priority`/`due`, либо строками в description
(`**Priority:** P0|P1|P2`, `**Due:** yyyy-mm-dd`; явные параметры переопределяют
парсинг). После создания агент приоритет и дедлайн **не меняет** — прецедент
человека структурный (update агентами отклоняется сервером). Обнаружил, что
таска на самом деле P0 → паркуй вопрос человеку, не бампай сам.
``` ```
**Мутация под лизом (решение 19):** `task_create` требует `claim_token` **Мутация под лизом (решение 19):** `task_create` требует `claim_token`
@@ -105,6 +114,8 @@ mcp__mappa__task_create(
| `**Runtime allowed:**` | CSV (`claude-opus`) | Runtime-whitelist. | | `**Runtime allowed:**` | CSV (`claude-opus`) | Runtime-whitelist. |
| `**Consult policy:**` | `auto` \| `human-only` \| `strict-human` | Эскалация consult; default `human-only`. | | `**Consult policy:**` | `auto` \| `human-only` \| `strict-human` | Эскалация consult; default `human-only`. |
| `**Blocker:**` | CSV blocker-slug'ов | Только на 🔵; авто-unblock при 🟢 всех. | | `**Blocker:**` | CSV blocker-slug'ов | Только на 🔵; авто-unblock при 🟢 всех. |
| `**Priority:**` | `P0` \| `P1` \| `P2` | Важность (task-priority-due). Отсутствует = `P1`. Влияет на порядок выдачи `claim_next` (P0-пул первый, внутри по дедлайну). **Ставится только при создании** — после агенты не меняют. |
| `**Due:**` | `yyyy-mm-dd` | Дедлайн (task-priority-due). Просроченные (due < today, ready/active) → overdue-scan уведомляет в инбокс однократно. Отсутствует = нет дедлайна. |
| `**Next action:** / **Where I stopped:** / **Branch:**` | free text | Резюмируемость. | | `**Next action:** / **Where I stopped:** / **Branch:**` | free text | Резюмируемость. |
`**Owner:** / **Claim token:** / **Claim expires at:**` — claim-штамп, пишет и `**Owner:** / **Claim token:** / **Claim expires at:**` — claim-штамп, пишет и
@@ -127,6 +138,7 @@ mcp__mappa__task_create(
| `**Created:**` отсутствует (legacy) | Добавить — обязательное поле. | | `**Created:**` отсутствует (legacy) | Добавить — обязательное поле. |
| Ссылка `#<глобальный id>` | Ссылайся `[[t:N]]` (решение 20/#1037). | | Ссылка `#<глобальный id>` | Ссылайся `[[t:N]]` (решение 20/#1037). |
| Без `**Weight:**` (legacy) | Ставь всегда, или задача паркуется. | | Без `**Weight:**` (legacy) | Ставь всегда, или задача паркуется. |
| Агент бампает `**Priority:**`/`**Due:**` после создания | Нельзя — прецедент человека структурный; ставь только при создании, иначе сервер отклоняет. |
| Дефис/двоеточие вместо ` — ` в шапке | Разделитель — пробел + em-dash + пробел. | | Дефис/двоеточие вместо ` — ` в шапке | Разделитель — пробел + em-dash + пробел. |
## Verify ## Verify