Blog de Leina

Cómo convertir las pull requests de GitHub en un informe semanal en Notion

Prepara con Leina un informe semanal de PRs de GitHub fusionadas y abiertas con enlaces a las fuentes, revisa el borrador en el chat y añádelo a Notion.

Escribir un informe semanal de ingeniería suele implicar revisar manualmente docenas de pull requests, copiar enlaces y averiguar qué se fusionó frente a lo que aún necesita revisión.

Con Leina, puedes automatizar este flujo de trabajo directamente desde el chat del equipo. Al conectar GitHub y Notion, un agente puede recopilar las PRs, redactar un resumen estructurado con enlaces a las fuentes y añadir la versión aprobada a tu espacio de trabajo de Notion. La clave para que sea fiable es separar el paso de borrador del de escritura, para que puedas verificar los números antes de publicar.

Empieza con una semana ya completada para poder comparar el borrador con registros que ya conoces.

Un flujo de trabajo de informes desde las pull requests de GitHub, pasando por un borrador revisado, hasta una página de Notion

Define el alcance del informe

Antes de pedirle a un agente de IA que recopile registros, establece reglas de límite claras sobre qué debe incluirse en el informe. Para tu primera ejecución, limítate a un solo repositorio y a una semana completada.

SecciónRegla de inclusiónQué comunica
Fusionadas esta semanaLa marca de tiempo de fusión cae dentro de los límites de inicio y fin especificadosCambios que entraron en la rama de destino durante el periodo
Actualmente abiertasLa PR está abierta en el momento de la consultaTrabajo en curso, estado de borrador y bloqueos de revisión documentados

Nota sobre las PRs abiertas: Una lista de PRs abiertas describe el repositorio en el momento de la consulta. Para informar sobre lo que estaba abierto al final de una semana anterior, necesitas una instantánea guardada o evidencia de los cambios de estado desde entonces. Conservar informes con fecha te proporciona esas instantáneas para comparaciones futuras.

Puedes comprobar los registros de origen usando los calificadores de búsqueda de estado y fecha de fusión de GitHub:

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

Sustituye el repositorio y las fechas, manteniendo la zona horaria coherente con tu informe. Este ejemplo usa +00:00 para UTC; usa los desplazamientos adecuados para tu ventana de informe si tu equipo trabaja en otra zona horaria.

Conecta GitHub y Notion

En Leina Console, autoriza las dos conexiones del espacio de trabajo:

  1. GitHub: Usa una cuenta que pueda leer el repositorio de destino y una conexión que exponga los detalles de las PRs necesarios para el resumen.
  2. Notion: Para el paso de guardado, usa una conexión que pueda leer y añadir contenido a la página prevista.

Consulta las operaciones disponibles en Integrations y tus cuentas autorizadas en Connections. El miembro solicitante también necesita permiso para usar esas conexiones. Redacta el informe en el chat de equipo conectado y, tras revisarlo, escríbelo en Notion.

Pídele al agente un borrador revisable

Empieza con un prompt que exija enlaces a las fuentes y un tratamiento explícito de la información faltante. Copia y adapta esta solicitud:

Prepara un informe semanal de ingeniería para [owner/repository], que abarque desde [start timestamp] hasta [end timestamp] en [timezone].

  1. PRs fusionadas: Enumera todas las PRs fusionadas dentro de esa ventana. Para cada PR, incluye su número, título, autor, hora de fusión, enlace a la fuente y un resumen de 1–2 frases de los cambios basado en su descripción de PR y en cualquier cambio disponible a través de la herramienta.
  2. PRs actualmente abiertas: Enumera las PRs abiertas en este momento, indicando su estado de borrador y cualquier revisor o bloqueo documentado.
  3. Contexto faltante: Si una PR tiene una descripción vacía o un impacto poco claro, márcala explícitamente como “Impacto no documentado”—no inventes razones de negocio ni resultados.
  4. Aviso de recuperación: Anota la marca de tiempo de recuperación, recupera todas las páginas de resultados dentro del alcance cuando sea compatible e informa de cualquier recuperación incompleta o registro inaccesible.

Devuelve el borrador completo aquí en el chat. No escribas todavía en Notion.

Si tu equipo usa un diseño markdown estandarizado, también puedes proporcionar la plantilla en blanco de informe semanal como referencia de formato.

Comprueba el borrador contra GitHub

Antes de enviar nada a Notion, compara la lista de registros y verifica por muestreo sus resúmenes:

  • Comprueba el recuento contra la búsqueda de GitHub: Ejecuta la consulta del calificador de fusión en la búsqueda de GitHub. ¿Coincide el número de PRs con la lista de fusionadas del agente?
  • Verifica las marcas de tiempo de los límites: Compara las PRs cercanas a ambos extremos de la ventana temporal con la lista de origen. Comprueba sus marcas de tiempo y la zona horaria usada para seleccionarlas.
  • Separa las fusionadas de las cerradas: Verifica que las PRs cerradas y abandonadas sin fusionar no se hayan colado por accidente en la sección de fusionadas.
  • Separa las fusionadas de las desplegadas: Fusionar código en main no significa automáticamente que se haya desplegado en producción. Mantén el resumen centrado en lo que realmente se fusionó, a menos que un registro de despliegue u otra fuente explícita confirme el despliegue en ese entorno. Una etiqueta de versión por sí sola identifica una versión del código.
  • Comprueba si hay resúmenes inventados: Si el título de una PR es simplemente “fix typo” o “chore: deps”, asegúrate de que el agente no haya inventado mejoras de arquitectura elaboradas.

Si detectas lagunas—por ejemplo, descripciones de PR faltantes—déjalas marcadas como no documentadas. Destacar los cambios no documentados es una retroalimentación útil para que el equipo mejore las descripciones de las PRs.

Añade el informe revisado a Notion

Cuando el borrador parezca preciso, indica a Leina que escriba el informe en tu página de Notion designada:

Añade el informe revisado a [Notion page URL] bajo el encabezado "[repository] — [reporting period]".

  • Primero comprueba si ese encabezado ya existe. Si existe, muéstrame la sección existente antes de modificar nada.
  • Conserva todo el demás contenido existente de la página.
  • Después de escribir, vuelve a leer la sección añadida y devuelve el enlace de la página de Notion. Si el resultado de la escritura es incierto, inspecciona la página antes de reintentar; si no puedes verificarlo, dímelo.

Esto te da un punto de revisión antes de que cambie el documento. Es un flujo de trabajo que tú solicitas; los permisos de conexión siguen determinando qué operaciones puede realizar Leina. Comprueba la sección guardada antes de compartirla con el equipo.

Cuando este flujo de trabajo funcione sin problemas para tu equipo, puedes convertir este prompt en una Skill reutilizable y reutilizar el formato con una nueva ventana de informe. Los compañeros de equipo siguen necesitando los permisos de conexión correspondientes.