Habilidade GitHub

Use a CLI gh para interagir com o GitHub. Sempre especifique --repo owner/repo quando não estiver em um diretório git, ou use URLs diretamente.

Quando Usar

• Quando o usuário perguntar sobre issues, pull requests, execuções de workflow ou falhas de CI no GitHub.
• Quando você precisar de gh issue, gh pr, gh run ou gh api a partir da linha de comando.

Pull Requests

Verificar o status de CI em um PR:

gh pr checks 55 --repo owner/repo

Listar execuções recentes de workflow:

gh run list --repo owner/repo --limit 10

Visualizar uma execução e ver quais etapas falharam:

gh run view <run-id> --repo owner/repo

Visualizar logs apenas para 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:

1. Verificar status do PR — identificar quais verificações estão falhando:

   gh pr checks 55 --repo owner/repo
   

2. Listar execuções recentes — encontrar o ID da execução relevante:

   gh run list --repo owner/repo --limit 10
   

3. Visualizar a execução com falha — ver quais jobs e etapas falharam:

   gh run view <run-id> --repo owner/repo
   

4. Obter logs de falha — obter a saída detalhada para as 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 que não estã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)"'

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.