Блог Leina

Как превратить pull requests GitHub в еженедельный отчёт в Notion

Подготовьте еженедельный отчёт о merged и open PR GitHub со ссылками на источники с помощью Leina, проверьте черновик в чате и добавьте его в Notion.

Написание еженедельного инженерного отчёта обычно означает ручной просмотр десятков pull requests, копирование ссылок и выяснение того, что было merged, а что ещё требует проверки.

С Leina вы можете автоматизировать этот рабочий процесс прямо из командного чата. Подключив GitHub и Notion, агент может собрать PR, подготовить структурированное резюме со ссылками на источники и добавить утверждённую версию в ваше рабочее пространство Notion. Ключ к надёжности — разделить этап черновика и этап записи, чтобы вы могли проверить числа перед публикацией.

Начните с одной завершённой недели, чтобы можно было сравнить черновик с уже известными вам записями.

Рабочий процесс отчётности от pull requests GitHub через проверенный черновик к странице Notion

Определите охват отчётности

Прежде чем просить AI-агента собрать записи, установите чёткие границы того, что должно попасть в отчёт. Для первого запуска ограничьтесь одним репозиторием и завершённой неделей.

РазделПравило включенияЧто он сообщает
Merged на этой неделеВременная метка merge попадает в указанные начальную и конечную границыИзменения, которые вошли в целевую ветку за период
Сейчас openPR открыт на момент запросаРабота в процессе, статус черновика и задокументированные блокеры проверки

Примечание об open PR: Список open PR описывает репозиторий на момент запроса. Чтобы отчитаться о том, что было открыто в конце предыдущей недели, нужен сохранённый снимок или свидетельства изменений состояния с тех пор. Датированные отчёты дают вам такие снимки для будущих сравнений.

Вы можете проверить исходные записи с помощью квалификаторов поиска по состоянию и дате merge GitHub:

repo:OWNER/REPOSITORY is:pr is:merged merged:2026-09-28T00:00:00+00:00..2026-10-04T23:59:59+00:00

Замените репозиторий и даты, сохраняя часовой пояс согласованным с вашим отчётом. В этом примере используется +00:00 для UTC; используйте подходящие смещения для вашего окна отчётности, если ваша команда работает в другом часовом поясе.

Подключите GitHub и Notion

В Leina Console авторизуйте два подключения к рабочим пространствам:

  1. GitHub: Используйте аккаунт, который может читать целевой репозиторий, и подключение, которое предоставляет детали PR, необходимые для резюме.
  2. Notion: Для этапа сохранения используйте подключение, которое может читать и добавлять содержимое на нужную страницу.

Проверьте доступные операции в Integrations и ваши авторизованные аккаунты в Connections. Запрашивающему участнику также нужно разрешение на использование этих подключений. Подготовьте черновик отчёта в подключённом командном чате, затем запишите в Notion после его проверки.

Запросите у агента проверяемый черновик

Начните с промпта, который требует ссылки на источники и явную обработку отсутствующей информации. Скопируйте и адаптируйте этот запрос:

Подготовь еженедельный инженерный отчёт для [owner/repository], охватывающий период с [start timestamp] по [end timestamp] в [timezone].

  1. Merged PR: Перечисли все PR, merged в этом окне. Для каждого PR укажи его номер, заголовок, автора, время merge, ссылку на источник и резюме изменений на 1–2 предложения на основе описания PR и любых изменений, доступных через инструмент.
  2. Сейчас open PR: Перечисли PR, открытые на данный момент, отметив их статус черновика и любых задокументированных рецензентов или блокеров.
  3. Отсутствующий контекст: Если у PR пустое описание или неясное влияние, явно пометь его как “Impact undocumented” — не выдумывай бизнес-причины или результаты.
  4. Уведомление о получении: Отметь временную метку получения, получи все страницы результатов в рамках охвата, где это поддерживается, и сообщи о любом неполном получении или недоступных записях.

Верни полный черновик здесь в чате. Пока не записывай в Notion.

Если ваша команда использует стандартизированную разметку markdown, вы также можете предоставить пустой шаблон еженедельного отчёта в качестве справочника по форматированию.

Сверьте черновик с GitHub

Прежде чем что-либо отправлять в Notion, сравните список записей и выборочно проверьте его резюме:

  • Сверьте количество с поиском GitHub: Выполните запрос с квалификатором merge в поиске GitHub. Совпадает ли число PR со списком merged у агента?
  • Проверьте граничные временные метки: Сравните PR вблизи обоих концов временного окна с исходным списком. Проверьте их временные метки и часовой пояс, использованный для их выбора.
  • Отделите merged от closed: Убедитесь, что closed PR, заброшенные без merge, случайно не попали в раздел merged.
  • Отделите merged от deployed: Merge кода в main не означает автоматически, что он развёрнут в production. Держите резюме сосредоточенным на том, что действительно было merged, если только запись о развёртывании или другой явный источник не подтверждает развёртывание в этой среде. Один только release tag идентифицирует версию кода.
  • Проверьте на выдуманные резюме: Если заголовок PR — просто “fix typo” или “chore: deps”, убедитесь, что агент не выдумал elaborate architecture improvements.

Если вы заметили пробелы — например, отсутствующие описания PR — оставьте их помеченными как undocumented. Выделение незадокументированных изменений — полезная обратная связь для команды, чтобы улучшить описания PR.

Добавьте проверенный отчёт в Notion

Когда черновик выглядит точным, поручите Leina записать отчёт на вашу назначенную страницу Notion:

Добавь проверенный отчёт на [Notion page URL] под заголовком "[repository] — [reporting period]".

  • Сначала проверь, существует ли уже этот заголовок. Если да, покажи мне существующий раздел перед изменением чего-либо.
  • Сохрани всё остальное существующее содержимое на странице.
  • После записи прочитай добавленный раздел и верни ссылку на страницу Notion. Если результат записи неясен, проверь страницу перед повторной попыткой; если не можешь проверить, скажи мне.

Это даёт вам точку проверки перед изменением документа. Это рабочий процесс, который вы запрашиваете; разрешения подключения по-прежнему определяют, какие операции Leina может выполнять. Проверьте сохранённый раздел перед тем, как поделиться им с командой.

Когда этот рабочий процесс будет гладко работать для вашей команды, вы можете превратить этот промпт в переиспользуемый Skill и повторно использовать формат с новым окном отчётности. Товарищам по команде всё ещё нужны соответствующие разрешения подключения.