La integración de GitHub da a tus pipelines una lectura de la actividad de desarrollo: commits, pull requests, revisiones y ejecuciones de GitHub Actions — por repositorio y por desarrollador. Es de solo lectura: no se escribe nada en tus repositorios.
Qué puedes hacer con ella
- Informe de producción del equipo — quién entregó qué durante el periodo: commits, líneas añadidas / eliminadas, PR abiertas y fusionadas, número de revisiones.
- Salud de CI — número de ejecuciones de GitHub Actions exitosas, fallidas y en curso, por repositorio.
- Alimentar un agente — un agente que resume la semana técnica (consulta Casos de uso → CTO IA).
Conexión
En Ajustes → Servicios → GitHub, pestaña Cuentas, dos métodos:
- Conectar con GitHub — OAuth a través de la aplicación de la plataforma (cuando el operador la ha configurado), y luego selección de los repositorios a seguir. Ningún token que copiar.
- Pegar un token (BYO) — un token de acceso de GitHub de lectura (idealmente un fine-grained PAT limitado a los repositorios pertinentes), la lista de repositorios a seguir (
owner/repo) y, para GitHub Enterprise, una base de API. El token se almacena del lado del servidor y nunca se vuelve a mostrar.
El nodo github_report
El nodo github_report obtiene la actividad durante una ventana de tiempo (24h, 7d o 30d) y la publica en el contexto: desglose por desarrollador (by_developer) y por repositorio (by_repo), registro de commits (commit_log), totales, síntesis de CI (ci) y la lista de repositorios que no se han podido leer (unreadable_repos). Un agente aguas abajo la convierte en un informe legible.
Las lecturas se lanzan en paralelo (con un límite) entre repositorios, para seguir siendo rápido en una organización de GitHub muy activa.
Herramientas de agente (lectura): github.report, github.list_commits, github.list_pull_requests.
Buenas prácticas
- Prefiere un token dedicado a la integración antes que un token personal compartido.
- Restringe los ámbitos al mínimo estricto (lectura de repositorios, de pull requests y de actions).
- Combínalo con el canal Schedule para un informe recurrente (p. ej. cada tarde a las 18:00).