Перейти к основному содержимому

Отчётность для руководства

Отчёт в системе — это письмо для конкретного получателя, собранное из доказательств: статус-снимков, дельты, плана и реестра рисков. Не «дашборд», не конспективный пересказ диалога, не выдуманные проценты.

Шаг 1. Формат: /report-format

Перед первым отчётом нужно согласовать формат. Файл report-format.md хранит «слоты» — сочетания стиля и периода:

СтильЧто это
fullПолный отчёт: RAG-оценки (график, бюджет, scope, риски), резюме, прогресс против плана, темы/эпики, план и исполнение, риски, решения и запросы
leanКороткое письмо: резюме, общий статус, ключевые метрики, сделано, в работе, риски, запросы

Периоды: weekly, monthly, quarterly — меняют акценты, а не структуру.

Каждый раздел слота — пара «id (машинный ключ) + название (caption) на языке формата». Агент показывает вам названия разделов — их можно менять, добавлять, убирать, пока слот не будет помечен confirmed.

Дополнительные ключи слота:

  • audience — кому адресован отчёт;
  • include_timeline_appendix — прикладывать ли выдержку из графика;
  • pptx_template — путь к вашему PPTX-шаблону (см. ниже).

Наберите /report-format full weekly (или /report-format defaults — предложить каркасы для всех недостающих слотов) и подтвердите слот.

Шаг 2. Отчёт: /report

Наберите /report (опционально: /report full weekly, /report lean monthly). Что происходит:

  1. Проверка входных данных. Агент проверяет, всё ли есть: живой реестр рисков, свежий статус-снимок (не старше вчера), при необходимости — снимок бюджета. Чего не хватает — коротким чек-листом и паузой: либо вы запускаете недостающее, либо явно говорите «дальше с пробелами» (в отчёте будет «недоступно»).
  2. Дельта. Если свежей дельты (за сегодня/вчера) нет — агент сам запускает /status-delta по снимкам, не дожидаясь команды.
  3. Сборка письма. Разделы заполняются только из доказательств: снимков, дельты, плана, реестра, трекера. Нет данных — «недоступно», а не домысл.

Ключевые правила отчёта:

  • Общий статус (R/Y/G) задаёт человек, а не агент: он не выводит цвет из количества задач. Красный — всегда с запросом (Ask).
  • Вехи — бинарно: завершена / не завершена. Без «90% готовности вехи».
  • Отрицательное не прячется: проблемы — в резюме и в рисках.
  • Решения и запросы — действенные: кто, что, к какому сроку.

Результат — файл status-report-<стиль>-<период>-YYYY-MM-DD.md. Повторный запуск в тот же день — обновление того же файла.

PPTX по вашему шаблону

Если в слоте задан pptx_template (например, «прошлонедельный» отчёт или корпоративный шаблон), агент дополнительно выведет PPTX:

  • агент читает текстовые блоки вашего шаблона, понимает их по смыслу (не по именам фигур) и обновляет соответствующие разделы новыми данными;
  • на выходе — status-report-…-YYYY-MM-DD.pptx рядом с .md (текстовая версия остаётся канонической записью);
  • слайды не добавляются и не удаляются: шаблон задаёт структуру, агент заполняет её.

Как зафиксировать шаблон: загрузите PPTX в материалы сессии и скажите «используй этот шаблон для full/weekly» — агент предложит записать его в слот.

Публикация

Черновик всегда у вас в чате/материалах. Публикация (например, на страницу в Confluence) — только предложением: вы решаете, что и куда отправить. Тихой отправки нет.

Проверка качества: /quality

Отдельная команда — ревью качества поставки на плановых точках (входы фаз, gate-контроли):

  • агент запрашивает доказательства — документы и решения, которые должны существовать на этой фазе (устав, scope-база, план, реестр рисков, итоги спринтов, готовность к релизу, закрытие);
  • статус каждой строки: есть / частично / отсутствует / н/д — с источником;
  • если заказчик отказал от лучшей практики — фиксируются: что предлагалось, последствия, решение (кто, когда) — и напоминание проверить на закрытии;
  • на выходе — датированный ревью-документ с планом действий (кто, к какому сроку, какой командой закрыть пробел).

Ритм ревью зависит от длины проекта: короткие (3–5 мес) — 2 точки; средние (6–10) — 3; длинные (10+) — по фазам.

Как это складывается в цикл

конец периода:
/status-snapshot + /budget-snapshot → входные данные
/report full weekly → письмо для руководства
/report + pptx_template → PPTX для презентации
/quality (по расписанию) → проверка процесса на точке фазы

С чего продолжать