Habilidade GitHub
Use o gh CLI para interagir com o GitHub. Sempre especifique --repo owner/repo quando não estiver em um diretório git, ou use URLs diretamente.
Pull Requests
Verifique o status de CI em um PR:
gh pr checks 55 --repo owner/repo
Liste as execuções de workflow recentes:
gh run list --repo owner/repo --limit 10
Veja uma execução e quais etapas falharam:
gh run view <run-id> --repo owner/repo
Veja logs apenas das etapas com falha:
gh run view <run-id> --repo owner/repo --log-failed
Depurando uma Falha de CI
Siga esta sequência para investigar uma execução de CI com falha:
- Verifique o status do PR — identifique quais verificações estão falhando:
gh pr checks 55 --repo owner/repo - Liste execuções recentes — encontre o ID da execução relevante:
gh run list --repo owner/repo --limit 10 - Veja a execução com falha — veja quais jobs e etapas falharam:
gh run view <run-id> --repo owner/repo - Obtenha logs de falha — obtenha a saída detalhada das etapas com falha:
gh run view <run-id> --repo owner/repo --log-failed
API para Consultas Avançadas
O comando gh api é útil para acessar dados não disponíveis por meio de outros subcomandos.
Obter PR com campos específicos:
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
Saída JSON
A maioria dos comandos suporta --json para saída estruturada. Você pode usar --jq para filtrar:
gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'