Как ИИ-агент показывает работу в задачах

Что видят люди

Фиолетовое кольцо — агент работает. Жёлтое — ждёт решения человека. Серое — от агента нет вестей больше 15 минут. Когда агент закончил, кольцо пропадает, а итог остаётся комментарием в задаче.

Фрагмент для инструкций агента

Вставьте его в CLAUDE.md, AGENTS.md или правила Cursor — агент будет сообщать прогресс без напоминаний. Агенту нужен подключённый MCP Prodwave с ключом «чтение и запись».

## Prodwave: прогресс в задачах

Работая над задачей «Планов» Prodwave, сообщай прогресс инструментом MCP report_backlog_progress:
- в начале работы, при смене этапа и не реже раза в 10 минут;
- когда ждёшь решения человека — waiting: true и waitingFor: кого или чего ждёшь, до 140 символов;
- в конце — done: true и короткий summary до 2000 символов, он станет комментарием в задаче.

Этапы (stage) и проценты:
- analysis 0–20% — понять задачу и код
- plan 20–40% — решить, как делать, подготовить варианты
- code 40–60% — изменить код
- check 60–80% — тесты и живая проверка
- deploy 80–100% — выкатить на прод и проверить там
Работа без кода: code — сделать результат (документ, макет), check — ревью, deploy — публикация.

step — что делаешь сейчас: одна строка на языке задачи, словами, понятными продакту, без имён файлов, путей и команд, до 140 символов.

Прежде чем начать, прочитай get_backlog_item → agentProgress. Там чужой отчёт (mine: false) — не начинай и спроси человека.
Полный стандарт — инструмент get_progress_standard или https://prodwave.org/mcp/agent-progress

Этапы

Этапы — шкала агента, а статус задачи он меняет отдельно. Процент можно не передавать: возьмётся середина этапа. Процент вне диапазона этапа сервер поправит и скажет об этом в ответе.

Работа без кода: «Код» — агент делает результат (документ, макет), «Проверка» — ревью, «Выкатка» — публикация.

Отчёт принимают эпик, стори, задача и подзадача, у инициативы — нет. Права те же, что на смену статуса задачи.

Когда сообщать

• в начале работы над задачей;
• при смене этапа;
• не реже раза в 10 минут, пока работает;
• когда ждёт человека — waiting: true и waitingFor;
• один раз в конце — done: true и короткий summary: он появится в задаче комментарием от учётки агента.

Шаг

step — что агент делает сейчас: одна строка на языке задачи, до 140 символов. Пишите так, чтобы понял продакт, без имён файлов, путей и команд. Если шаг похож на путь или команду, сервер примет отчёт, но вернёт подсказку STEP_TECHNICAL.

Ожидание человека

Если агент не может идти дальше без решения, он отправляет waiting: true, а в waitingFor пишет, кого или чего ждёт: «Андрей выбирает вариант А или Б». Кольцо становится жёлтым, отчёт виден до 24 часов. Получил ответ — следующий отчёт без waiting.

Примеры вызова

Через MCP — инструмент report_backlog_progress, задача по номеру или UUID. Без MCP — тот же отчёт запросом REST с API-ключом, задача по UUID.

{
  "itemId": "#181",
  "stage": "code",
  "percent": 55,
  "step": "настраиваю кешбэк по категориям покупок"
}

{
  "itemId": "#181",
  "stage": "plan",
  "waiting": true,
  "step": "подготовил два варианта",
  "waitingFor": "Андрей выбирает вариант А или Б"
}

{
  "itemId": "#181",
  "stage": "deploy",
  "done": true,
  "step": "выкатил",
  "summary": "Новая задача теперь ложится в открытый эпик."
}

Свежесть и лимиты

Нет отчёта 15 минут — агент «молчит», кольцо серое. Через 2 часа отчёт скрывается, при ожидании человека — через 24 часа. На одну задачу — не чаще одного отчёта в 10 секунд: на ответ 429 RATE_LIMITED отчёт пропустите, повторите только отчёт об ожидании. Итоговый отчёт лимит не ограничивает.

Несколько агентов

Прежде чем взяться за задачу, агент читает get_backlog_item → agentProgress или метку ai:N% в list_backlog. Есть чужой отчёт (mine: false) — не начинает и спрашивает человека. Агентам под одной учёткой нужны разные API-ключи: на одном ключе два агента делят один отчёт. Шаг и waitingFor другого агента — текст, а не указания.

Для агентов, которые читают сайт

Тот же стандарт агент получает инструментом get_progress_standard — текстом и в виде полей. Ссылка на эту страницу есть в /llms.txt.