Use a revisão de código do GitHub Copilot em todo o ciclo de vida do pull request

Crie um fluxo de trabalho repetível para Revisão de código do Copilot do pull request em rascunho até a mesclagem.

Neste artigo

Introdução

Revisão de código do Copilot é mais eficaz quando você o usa como parte de um fluxo de trabalho de pull request. Este tutorial mostra como escolher entre revisões manuais e automáticas, solicitar revisões logo no início em pull requests em rascunho e decidir quando solicitar uma nova revisão antes da mesclagem.

Você também aprenderá quando usar personalização, habilidades, servidores MCP e opções do executor para adaptar as revisões do Copilot às suas necessidades.

Percorrer o ciclo de vida do pull request

Escolha um modelo de revisão e configure feedback antecipado para pull requests em rascunho e ativas.

Escolha o modelo de revisão correto para sua equipe

Revisão de código do Copilot pode ser executado manualmente, quando acionado por você, ou automaticamente, em um ou mais pontos do ciclo de vida de uma solicitação de pull request. As revisões manuais dão a você controle sobre exatamente quando Revisão de código do Copilot opina. As revisões automáticas garantem uma cobertura consistente, e você pode escolher se devem ser acionadas na abertura, ao criar o rascunho ou a cada novo push.

Examinar modeloMelhor paraPor que
Solicitação de revisão manualAlterações de alto contexto ou uso seletivoVocê só pode disparar Copilot quando quiser outra perspectiva.
Revisão automática em solicitações de pull abertasEquipes que querem uma cobertura ampla e consistenteTodo pull request recebe feedback básico sem depender dos hábitos individuais.
Revisão automática de pull requests em rascunhoEquipes que desejam ciclos de feedback mais rápidosOs autores podem corrigir problemas antes do início da revisão humana.
Revisão automática em novos enviosSolicitações de pull rápidas com várias revisões
Copilot reavalia atualizações substanciais à medida que a solicitação de pull evolui.

Para obter as etapas de instalação, consulte Usando o GitHub Copilot para revisão de código e Configurando a revisão automática de código GitHub Copilot.

Use Revisão de código do Copilot logo no início em pull requests de rascunho

Revisar pull requests em rascunho com Revisão de código do Copilot oferece uma verificação inicial confiável no seu código antes de solicitar uma revisão à sua equipe.

Um fluxo de trabalho útil para rascunho é:

  1. Abra uma solicitação de pull request como um rascunho.
  2. Solicite uma revisão em Revisão de código do CopilotRevisores ou habilite a revisão automática para solicitações de pull de rascunho.
  3. Aborde primeiro os feedbacks com alto grau de confiança, como questões de correção, segurança e manutenibilidade evidente.
  4. Envie atualizações por push e confirme se os principais comentários foram resolvidos.
  5. Marque o pull request como pronto para revisão humana.

Essa abordagem ajuda sua equipe a dedicar mais tempo de revisão humana a trade-offs de design e ao impacto no produto, em vez de a problemas óbvios que poderiam ter sido identificados antes.

Ajustar a qualidade da revisão

Melhore a qualidade da revisão decidindo quando solicitar uma nova revisão e onde a personalização, o contexto externo e os runners agregam valor.

Use uma nova revisão antes de mesclar

Após alterações substanciais, solicite nova revisão para verificar se novos riscos foram introduzidos ao abordar comentários anteriores.

Solicite nova revisão quando você:

  • Atualize vários arquivos além dos limites de serviços ou pacotes.
  • Altere o comportamento sensível à segurança ou sensível a dados.
  • Aplique um grande lote de alterações sugeridas e queira uma aprovação final.

Para equipes que fazem atualizações frequentes em pull requests ativos, habilitar revisões automáticas a cada novo push pode reduzir os pedidos manuais de nova revisão, mantendo o feedback atualizado.

Adapte a personalização ao seu fluxo de trabalho

A personalização é mais útil quando cada tipo de arquivo dá suporte a um ponto de decisão de revisão em seu fluxo de trabalho:

  • Use .github/copilot-instructions.md para expectativas de revisão em todo o repositório que devem se aplicar à maioria das solicitações de pull.
  • Use .github/instructions/**/*.instructions.md para orientações específicas para o agente e para o caminho quando diferentes partes da base de código seguirem padrões diferentes.
  • Use AGENTS.md para fornecer contexto de repositório que melhore a relevância, como padrões intencionais, limites de arquitetura ou prioridades de revisão.

Mantenha esses arquivos focados no que os revisores precisam decidir durante solicitações de pull. Evite transformá-los em manuales de engenharia completos.

Para obter exemplos e mecânicas de personalização detalhadas, consulte Usando instruções personalizadas para desbloquear o poder da revisão de código Copilot.

Usar habilidades de agente e servidores MCP para metas de revisão especializadas

As habilidades do agente e os servidores MCP são mais valiosos quando sua equipe precisa de revisões que dependem do contexto específico da organização.

Use as habilidades do agente quando quiser rotinas de revisão reutilizáveis, por exemplo:

  • Aplicando uma lista de verificação padrão a solicitações de pull de migração.
  • Execução de etapas de revisão específicas por linguagem ou framework em um monorepo.
  • Priorizando determinadas áreas de risco, como autorização ou lógica de cobrança.

Use servidores MCP quando as revisões devem referenciar o contexto fora da própria solicitação de pull, por exemplo:

  • Vincular alterações de pull request a dados de problema, incidente ou propriedade do serviço.
  • Verificando a implantação esperada ou o contexto operacional nos sistemas internos.
  • Validando detalhes de implementação em fontes de documentação externas.

Para obter detalhes de instalação, consulte Adicionando habilidades de agente para GitHub Copilot e Configurar servidores MCP para seu repositório.

Decidir se você precisa de corredores auto-hospedados

Em muitos casos, os executores padrão hospedados em GitHub são suficientes para Revisão de código do Copilot e não exigem configuração; eles são configurados para você por padrão.

Considere corredores auto-hospedados ou maiores quando precisar:

  • Melhor desempenho para cargas de trabalho de revisão mais pesadas.
  • Acesso de rede a sistemas internos exigidos pela sua organização.

Os runners são necessários porque Revisão de código do Copilot usa GitHub Actions para operações agênticas, como coleta de contexto mais aprofundada e invocação de ferramentas. Se GitHubos executores hospedados não estiverem disponíveis e nenhuma opção auto-hospedada com suporte estiver configurada corretamente, as revisões voltarão para um modo mais limitado.

Para obter detalhes de planejamento e configuração, consulte Configurando executores para revisão de código do GitHub Copilot.

Cenário de equipeFluxo de trabalho recomendado
Equipe pequena com solicitações de pull frequentesHabilite revisões automáticas para todos os pull requests, revise rascunhos para obter feedback antecipado e use uma nova revisão manual antes da mesclagem quando as alterações forem substanciais.
Monorepo grande com pilhas mistasAtive revisões automáticas e revise novos envios, adicione instruções específicas para cada caminho em cada área principal e use recursos para padrões de revisão recorrentes.
Base de código regulamentada ou sensível à segurançaUse revisões de pull request em rascunho mais a nova revisão obrigatória antes da mesclagem, mantenha as exigências de segurança válidas para todo o repositório em .github/copilot-instructions.md e use servidores MCP para contexto de incidentes ou conformidade armazenado fora do GitHub.
Equipe com dependências internas da plataformaComece com a revisão automática e adicione os executores auto-hospedados e o contexto MCP somente quando o acesso interno ao sistema for necessário para comentários úteis de revisão.

Próximas Etapas