Configuração
- Proprietário/Organização Padrão: octocat
- Repositório Padrão: Hello-World
- Autenticação: OAuth; solicita ao usuário que se autentique
- Acesso: Limitado pelas permissões do usuário; suporta repositórios públicos/privados e gerenciamento de issues/PRs/conteúdo do repositório
Ferramentas Disponíveis (16/16)
Gerenciamento de Repositórios
- Listar Repositórios: Obter todos os repositórios de usuários ou organizações.
- Obter Repositório: Recuperar detalhes do repositório.
- Pesquisar Repositórios: Encontrar repositórios por nome, descrição ou tópicos.
- Listar Branches: Obter todas as branches no repositório.
Gerenciamento de Issues e PRs
- Listar Issues: Consultar issues por estado, etiquetas ou responsável.
- Criar Issue: Criar issues com título, corpo e etiquetas.
- Listar Pull Requests: Obter todas as PRs por estado ou branch.
- Criar Pull Request: Abrir PR de uma branch para outra.
- Obter Pull Request: Recuperar detalhes da PR.
- Obter Arquivos da PR: Listar todos os arquivos alterados na pull request.
- Obter Diferença da PR: Obter a diferença de uma pull request.
- Obter Commits da PR: Visualizar todos os commits na pull request.
Histórico de Código e Etiquetas
- Obter Histórico de Commits: Visualizar o histórico de commits do repositório.
- Obter Etiquetas: Recuperar todas as etiquetas do repositório.
- Atribuir Etiquetas à PR: Marcar pull requests com etiquetas.
Casos de Uso
- Rastreamento de Issues: Criar e gerenciar issues do GitHub a partir de relatórios ou alertas.
- Revisões de Código: Listar e revisar pull requests automaticamente.
- Gerenciamento de Versões: Rastrear commits e gerenciar versões.
- Gerenciamento de Projetos: Sincronizar issues do GitHub com fluxos de trabalho de projetos.
Melhores Práticas
- Proteção de Branches: Ativar proteção em branches principais antes da automação.
- Validação de PRs: Verificar se a PR pode ser mesclada antes de tentar a mesclagem.
- Limites de Taxa: Monitorar limites de taxa (5.000/hora para requisições autenticadas).
Problemas Comuns e Soluções
- 403 Proibido: Verifique se o token possui os escopos e o acesso ao repositório necessários.
- Conflito de Mesclagem: Não é possível mesclar automaticamente uma PR com conflitos. Resolva os conflitos primeiro.
- Limite de Taxa: Implemente backoff exponencial e requisições condicionais com ETags.
- Proteção de Branch: Revisões ou verificações de PR necessárias antes da mesclagem. Configure a automação de acordo.