Как превратить pull requests GitHub в еженедельный отчёт в Notion
Подготовьте еженедельный отчёт о merged и open PR GitHub со ссылками на источники с помощью Leina, проверьте черновик в чате и добавьте его в Notion.
Написание еженедельного инженерного отчёта обычно означает ручной просмотр десятков pull requests, копирование ссылок и выяснение того, что было merged, а что ещё требует проверки.
С Leina вы можете автоматизировать этот рабочий процесс прямо из командного чата. Подключив GitHub и Notion, агент может собрать PR, подготовить структурированное резюме со ссылками на источники и добавить утверждённую версию в ваше рабочее пространство Notion. Ключ к надёжности — разделить этап черновика и этап записи, чтобы вы могли проверить числа перед публикацией.
Начните с одной завершённой недели, чтобы можно было сравнить черновик с уже известными вам записями.
Определите охват отчётности
Прежде чем просить AI-агента собрать записи, установите чёткие границы того, что должно попасть в отчёт. Для первого запуска ограничьтесь одним репозиторием и завершённой неделей.
| Раздел | Правило включения | Что он сообщает |
|---|---|---|
| Merged на этой неделе | Временная метка merge попадает в указанные начальную и конечную границы | Изменения, которые вошли в целевую ветку за период |
| Сейчас open | PR открыт на момент запроса | Работа в процессе, статус черновика и задокументированные блокеры проверки |
Примечание об 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 авторизуйте два подключения к рабочим пространствам:
- GitHub: Используйте аккаунт, который может читать целевой репозиторий, и подключение, которое предоставляет детали PR, необходимые для резюме.
- Notion: Для этапа сохранения используйте подключение, которое может читать и добавлять содержимое на нужную страницу.
Проверьте доступные операции в Integrations и ваши авторизованные аккаунты в Connections. Запрашивающему участнику также нужно разрешение на использование этих подключений. Подготовьте черновик отчёта в подключённом командном чате, затем запишите в Notion после его проверки.
Запросите у агента проверяемый черновик
Начните с промпта, который требует ссылки на источники и явную обработку отсутствующей информации. Скопируйте и адаптируйте этот запрос:
Подготовь еженедельный инженерный отчёт для
[owner/repository], охватывающий период с[start timestamp]по[end timestamp]в[timezone].
- Merged PR: Перечисли все PR, merged в этом окне. Для каждого PR укажи его номер, заголовок, автора, время merge, ссылку на источник и резюме изменений на 1–2 предложения на основе описания PR и любых изменений, доступных через инструмент.
- Сейчас open PR: Перечисли PR, открытые на данный момент, отметив их статус черновика и любых задокументированных рецензентов или блокеров.
- Отсутствующий контекст: Если у PR пустое описание или неясное влияние, явно пометь его как “Impact undocumented” — не выдумывай бизнес-причины или результаты.
- Уведомление о получении: Отметь временную метку получения, получи все страницы результатов в рамках охвата, где это поддерживается, и сообщи о любом неполном получении или недоступных записях.
Верни полный черновик здесь в чате. Пока не записывай в 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 и повторно использовать формат с новым окном отчётности. Товарищам по команде всё ещё нужны соответствующие разрешения подключения.