generate-review

name: generate-review description: > Генерация weekly или monthly обзора по данным дейликов. Используй этот скилл когда пользователь просит "weekly review", "обзор за неделю", "итоги месяца", "monthly review", "собери отчёт за неделю", "что было на этой неделе", "отчёт за март", или любой запрос на агрегацию и анализ данных из нескольких дейликов за период.

Generate Review — weekly/monthly обзоры

Что делает скилл

Запускает два скрипта и промпт последовательно:

scripts/generate_review.py — факты и агрегация
scripts/generate_insights.py — аналитика и рекомендации
prompts/format_report.md — форматирование для руководства и команды

Review (факты):

Итог периода (задачи, блокеры, решения, поручения)
OKR Progress (team) — прогресс по каждому Objective + общий %
Релизы — KR с dev_freeze/release_date, маркер «at risk» если дедлайн близко
Что сделано — по каждому участнику
Блокеры и повторяющиеся блокеры
Решения, открытые поручения, ключевые темы, участие
Задачи Jira — обсуждавшиеся за период задачи со статусом и исполнителем (агрегируются из jira_issues в structured.json, последний снимок по каждой задаче)

Insights (выводы):

Релизы в риске (dev_freeze ≤ 21д И прогресс < 70%)
Просроченные поручения
Системные (повторяющиеся) блокеры
Перегрузка планов по людям (todo > 2 — приблизительный сигнал WIP)
Покрытие блокеров решениями
Тренд done-записей (вывод о тренде — только при ≥4 дейликах)
Исполняемость поручений по людям (требует актуальных статусов — см. сверку поручений в process-daily)
Кто чаще заблокирован
Внешние исполнители без обратной связи

Отчёты (LLM-форматирование):

Для руководства — 5–10 предложений, без TASK-XXX, фокус на рисках
Для команды — Slack/Telegram, 10–15 строк, action items с владельцами

Использование

Шаг 1: Определить параметры

team — ОБЯЗАТЕЛЬНО. Спроси, если не указана.
Период — один из вариантов:
- --week 2026-W13 (ISO-неделя)
- --month 2026-03
- --from 2026-03-24 --to 2026-03-31 (произвольный диапазон)

Шаг 2: Подтянуть team context из `team.yaml`

scripts/generate_review.py сам подтягивает team.yaml → current_okr и выводит секцию ## OKR Progress (team) — прогресс по каждому Objective и общий % команды на момент генерации отчёта.

Дополнительно прочитай (для LLM-интерпретации в шаге 5):

teams/<team>/team.yaml — роли и зоны ответственности участников
teams/<team>/lead-notes.md — только для внутренней версии отчёта

Личные OKR (teams/<team>/personal-okrs/) — приватный документ тимлида, в автоматику и итоговые отчёты не включаются.

Ограничения:

факты периода берутся только из meetings/*/structured.json
OKR progress в review — это снимок состояния на момент генерации, а не дельта за период
team.yaml и lead-notes.md не добавляют новые «события», а только контекст для выводов

Шаг 3: Запустить оба скрипта

python3 scripts/generate_review.py --team TEAM_NAME --week YYYY-Www [--save]
python3 scripts/generate_insights.py --team TEAM_NAME --week YYYY-Www [--save]

Те же параметры для --month и --from/--to. Флаг --save сохраняет файлы в reviews/weekly/ или reviews/monthly/:

2026-W13-team-alpha.md — обзор
2026-W13-team-alpha-insights.md — выводы

Шаг 4: Показать результат

Выведи оба документа пользователю. Обрати внимание:

Просроченные items — предложи конкретные действия
Системные блокеры — предложи вынести в отдельный созвон
Если insights пуст (“Значимых паттернов не обнаружено”) — скажи об этом

Шаг 5: Подготовить тексты для отправки

Прочитай промпт prompts/format_report.md. Подставь в него:

{review} — вывод generate_review.py
{insights} — вывод generate_insights.py

Сгенерируй два текста по промпту:

Для руководства — 5–10 предложений, без номеров задач, фокус на рисках и результатах
Для команды — сообщение в Slack/Telegram, 10–15 строк, с конкретными action items

Покажи оба текста пользователю. Он выберет, какой отправить, и может попросить подкорректировать.

Шаг 6 (опционально): Освежить статусы задач из Jira

Секция «Задачи Jira» в review — это снимок на момент обработки дейликов, и к дате отчёта он мог устареть. Если Jira-MCP доступен и пользователь хочет актуальные статусы, перевызови mcp_Atlassian__jira_get_issue по ключам из секции «Задачи Jira» и обнови статус/исполнителя в тексте отчёта. Если MCP недоступен — используй снимок из structured.json и отметь, что данные на дату обработки.

Зависимости

scripts/generate_review.py
scripts/generate_insights.py
prompts/format_report.md — промпт для форматирования отчётов
Наличие meetings/ с обработанными structured.json
Jira-MCP (mcp_Atlassian__jira_get_issue и аналоги) — опциональное обновление статусов