| name | weekly-report |
| description | Собрать еженедельный отчёт по работе в файле `Log/Reports/YYYY-MM-DD.md` (один документ на неделю). Используй, когда пользователь пишет /weekly-report, "собери недельный отчёт", "что я сделал за неделю", "создай отчёт за неделю", или просит оформить недельный статус по дневным логам и tasks.md. |
weekly-report
Готовишь рабочий отчёт за неделю. Пиши по-русски, коротко и фактами, без маркетингового тона и без придумывания результатов.
Результат
Один документ на неделю:
Log/Reports/YYYY-MM-DD.md
YYYY-MM-DD — понедельник отчётной недели (начало недели). Если папки Log/Reports/ нет — создай её.
Если файл уже есть, обновляй только блок между маркерами:
<!-- weekly-report:start -->
...
<!-- weekly-report:end -->
Если маркеров нет, добавь их и помести весь сгенерированный отчёт внутрь.
Дата и период
- Начало недели — понедельник. Период отчёта: понедельник–воскресенье включительно.
- Если пользователь указал дату — бери неделю, в которую она попадает.
- Если дата не указана — бери текущую неделю (от ближайшего прошедшего понедельника).
- Пример: отчёт
Log/Reports/2026-06-01.md покрывает 2026-06-01–2026-06-07.
Источники
Собери факты из локальных файлов, в таком порядке:
- Дневные логи
Log/YYYY-MM-DD.md за весь отчётный период.
tasks.md в корне vault: закрытые задачи с датой периода (✅ YYYY-MM-DD) и незакрытые задачи, явно относящиеся к текущей неделе. Файл разбит на секции # Week: (текущая неделя) и # Week+ (неделя+); фокус отчёта — секция # Week:, из # Week+ бери только то, что реально двигалось за период.- Прошлые отчёты
Log/Reports/<прошлая неделя>.md — только как стиль и контекст по непрерывным темам, не как место записи.
Если дневного лога за дату нет — просто пропусти дату. Если фактов мало, не растягивай отчёт водой; лучше сделать короткий честный отчёт.
Группировка
Группируй пункты по рабочим направлениям. Набор направлений адаптируй под свой проект — выведи только те, где есть факты. Примеры направлений:
- Продукт / сайт
- Данные / интеграции / автоматизации
- Инфраструктура / доступы / аккаунты
- Прочее: подрядчики, стратегия, срочные разборы
Мелкие однотипные пункты объединяй в один. Важные ссылки (трекер, документы, внешние URL) сохраняй рядом с соответствующим фактом.
Формат отчёта
Используй такой каркас:
# Еженедельный отчёт YYYY-MM-DD
Период: YYYY-MM-DD — YYYY-MM-DD
<!-- weekly-report:start -->
## Сделал
- <Направление>
- <факт>
- <факт>
## Вопросы / риски
- <вопрос или риск>
## Что дальше
- <следующий шаг>
## Метрики / наблюдения
- <только если есть фактические цифры или наблюдения>
<!-- weekly-report:end -->
Разделы Вопросы / риски, Что дальше, Метрики / наблюдения выводи только если есть реальные пункты. Внутри Сделал выводи только направления, где есть факты.
Вложенные пункты — табом, не пробелами. Направление — пункт верхнего уровня без отступа, факты под ним — с одним табом.
Стиль
- Пиши от первого лица:
Сделал, Добавил, Проверил, Нашёл, Поправил, Настроил.
- Не используй оценочные фразы без фактов:
сильно улучшил, важный прогресс, успешно завершил, если в источниках нет конкретики.
- Не раскрывай лишние чувствительные детали из приватных файлов. Ссылки и названия задач оставляй, если они уже были в рабочих логах.
- Не добавляй выдуманные KPI. Раздел метрик делай только по данным из источников.
- Если пункт выглядит как задача на будущее, перенеси его в
Что дальше, а не в Сделал.
- Если пункт выглядит как блокер или открытый вопрос, перенеси его в
Вопросы / риски.
Сводка по закрытым задачам и чистка tasks.md
После того как отчёт записан, предложи пользователю отдельным шагом:
-
Дописать в отчёт сводку по закрытым задачам из tasks.md — компактный список выполненных пунктов (- [x] ... ✅ YYYY-MM-DD). В заголовке рубрики обязательно указать количество закрытых за неделю; рядом в скобках — общие счётчики (закрыто / открыто). Формат — отдельная рубрика в конце блока отчёта:
## Закрытые задачи (N за неделю; всего в tasks.md закрыто DONE, открыто OPEN)
- <формулировка задачи> ✅ YYYY-MM-DD
Счётчики DONE/OPEN: если в проекте ведётся files/tasks.json (см. скрипт gen-tasks-json.cjs), возьми готовые счётчики оттуда (jq '{done, open}' files/tasks.json); иначе посчитай напрямую по tasks.md (верхнеуровневые - [x] против - [ ]/- [/]). N — число задач, реально попавших в список за период (обычно меньше done, т.к. в done входят и «хвосты»).
Брать формулировку как есть, длинные подпункты-детали не тащить. Сначала задачи периода, ниже одной строкой отметить «хвосты» прошлых недель, если они есть.
Пример:
## Закрытые задачи (6 за неделю; всего в tasks.md закрыто 28, открыто 91)
За неделю (01.06–07.06):
- Проверить, как встроился новый язык перевода ✅ 2026-06-02
- Сделать бота для поиска по базе клиентов ✅ 2026-06-03
- Выписать задачи из таблицы ✅ 2026-06-05
Хвосты прошлых недель (закрыты раньше, ещё висят в `tasks.md`): доступ к справочнику, цена на тариф, почтовый алиас и др.
Строку про «хвосты» добавляй, только если в tasks.md есть закрытые задачи с датой ✅ раньше периода. Если их нет — оставляй только список за неделю.
-
Удалить закрытые задачи из tasks.md — чтобы список держал только открытое. Удалять весь блок задачи вместе с её вложенными строками-деталями.
Правила:
- Это предложение, не автодействие. Удалять и дописывать только после явного «да». Можно спросить про оба шага разом.
- Считать закрытыми задачи верхнего уровня со статусом
- [x]. Частично сделанные (открытая - [ ] с закрытыми подпунктами) не трогать — задача ещё в работе; такие просто упомянуть в статусе, не удалять.
- В сводку и в удаление по умолчанию включать все закрытые
- [x], а не только за период (накопившиеся «хвосты» прошлых недель — это и есть то, что чистим). Если пользователь хочет только период — ограничить датами.
- Перед удалением показать количество: сколько задач уйдёт, сколько останется, сколько частичных пропущено.
- Закрытые подпункты внутри остающейся открытой задачи не вырезать (они показывают прогресс).
- Заголовки секций
# Week: / # Week+ и строку-легенду > Активные задачи. Будущие: [[tasks-future]]. не удалять при чистке, даже если секция осталась без завершённых задач.
Проверка перед ответом
Перед завершением проверь:
- Файл создан или обновлён в
Log/Reports/YYYY-MM-DD.md (понедельник недели), один документ на неделю.
- В отчёте есть дата и период (понедельник–воскресенье).
- Маркеры
weekly-report:start и weekly-report:end присутствуют.
- Пустых рубрик нет.
- Ссылки из исходных фактов не потерялись.
- Отчёт читается как краткая сводка, а не как полный дамп дневников.
- Закрытые задачи из
tasks.md без подтверждения не удалены; предложение про сводку и чистку выдано.
В финальном ответе кратко скажи, какой файл создан или обновлён, перечисли основные направления и предложи сводку по закрытым задачам + чистку tasks.md.
