Habilidad de GitHub
Usa la CLI gh para interactuar con GitHub. Siempre especifica --repo owner/repo cuando no estés en un directorio git, o usa las URL directamente.
Pull Requests
Verificar el estado de CI en un PR:
git pr checks 55 --repo owner/repo
Listar ejecuciones de workflow recientes:
git run list --repo owner/repo --limit 10
Ver una ejecución y qué pasos fallaron:
git run view <run-id> --repo owner/repo
Ver solo los logs de los pasos fallidos:
git run view <run-id> --repo owner/repo --log-failed
Depuración de un fallo de CI
Sigue esta secuencia para investigar una ejecución de CI fallida:
- Revisar el estado del PR — identifica qué comprobaciones fallan:
git pr checks 55 --repo owner/repo - Listar ejecuciones recientes — encuentra el ID de la ejecución relevante:
git run list --repo owner/repo --limit 10 - Ver la ejecución fallida — mira qué jobs y pasos fallaron:
git run view <run-id> --repo owner/repo - Obtener logs del fallo — obtén la salida detallada de los pasos fallidos:
git run view <run-id> --repo owner/repo --log-failed
API para Consultas Avanzadas
El comando gh api es útil para acceder a datos no disponibles a través de otros subcomandos.
Obtener un PR con campos específicos:
git api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
Salida JSON
La mayoría de los comandos admiten --json para obtener una salida estructurada. Puedes usar --jq para filtrar:
git issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'