---
name: weekly-pr-report
description: "Preparar un informe semanal de solicitudes de extracción de GitHub vinculado a fuentes para un repositorio y una ventana de tiempo especificados, con una escritura autorizada opcional en Notion. Usar para informes de estado de ingeniería, no para revisión de código ni puntuación de productividad individual."
---

# Informe semanal de PR

Instrucciones de ejemplo para adaptar y evaluar con las herramientas disponibles en el entorno del agente. Este archivo no instala conectores ni otorga acceso a cuentas.

## Entradas

Resolver la lista de repositorios, la ventana de informe con zona horaria y los lectores previstos a partir de la solicitud. Preguntar por el alcance faltante que cambiaría el informe. Para una escritura en Notion, resolver también la página exacta, el encabezado del informe y si el usuario desea un anexado o un reemplazo.

Usar lecturas autorizadas de GitHub expuestas por el entorno actual. Si esas operaciones no están disponibles, informar la capacidad faltante. Nunca inventar IDs de acciones de conectores ni registros recuperados.

## Seleccionar y resumir

- Incluir PR fusionados cuyas marcas de tiempo de fusión caigan dentro de la ventana solicitada. Distinguir los registros cerrados sin fusionar del trabajo fusionado.
- Incluir una instantánea separada de PR abiertos actuales solo si se solicita, etiquetada con la hora de recuperación. No presentar el estado actual como estado histórico.
- Recuperar todas las páginas de resultados dentro del alcance donde sea compatible. Divulgar registros no disponibles, resultados truncados o consultas fallidas; una consulta incompleta no es una consulta con cero resultados.
- Conservar la URL del PR, el número, el título, el autor, el estado y la marca de tiempo relevante. Resumir a partir de la descripción del PR y los cambios disponibles para la herramienta.
- Describir el impacto, el despliegue, los bloqueos y los responsables de la próxima acción solo cuando la evidencia los respalde. No tratar al autor como el responsable de la próxima acción de forma predeterminada.
- Devolver el alcance seleccionado, las secciones del informe, los enlaces de origen y las preguntas sin resolver. Ajustar el nivel de detalle a los lectores previstos.

## Escritura opcional en Notion

Una solicitud de borrador devuelve un borrador. Escribir solo cuando el usuario haya autorizado el destino y la operación concretos; preservar la autorización existente en lugar de exigir confirmación repetida.

Comprobar el encabezado del informe antes de anexar. Si ya existe un informe y no está autorizado el reemplazo, devolver su ubicación y preguntar cómo proceder. Preservar el contenido no relacionado.

Después de una escritura, volver a leer la sección si es compatible y devolver su ubicación. Si el resultado de la escritura es incierto, inspeccionar el destino antes de reintentar. Si la verificación no está disponible, informar esa limitación en lugar de afirmar que la escritura fue confirmada.