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 o Revisão de código do Copilot direto as pull request de 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 a personalização, as habilidades, os servidores MCP e as opções do executor para adaptar as revisões do Copilot às suas necessidades.

Percorrer o ciclo de vida da pull request

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

Escolha o modelo de revisão correto para sua equipe

A Revisão de código do Copilot pode ser executada manualmente, quando disparada por você, ou automaticamente, em um ou mais pontos do ciclo de vida de uma pull request. As revisões manuais dão a você controle sobre exatamente quando a Revisão de código do Copilot pesa. As revisões automáticas garantem uma cobertura consistente, e você pode escolher se devem ser disparados na abertura, ao criar o rascunho ou a cada novo envio por 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 de 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 envios por pushPull requests 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 o Revisão de código do Copilot logo no início em pull requests de rascunho

Revisar pull requests em rascunho com o 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 pull request como um rascunho.
  2. Solicite uma revisão de Revisão de código do Copilot em Revisores ou habilite a revisão automática para pull requests 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 em que ponto a personalização, o contexto externo e os executores 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 as .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 estrutura 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 executores 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 os executores 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 os executores auto-hospedados de GitHubnã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 mistasHabilite as revisões automáticas e revise novos envios por push, adicione instruções específicas para cada caminho em cada área principal e use habilidades para padrões de revisão recorrentes.
Base de código regulamentada ou sensível à segurançaUse as revisões de pull request de 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 nas .github/copilot-instructions.md e use servidores MCP para contexto de incidentes ou conformidade armazenados 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 feedback útil de revisão.

Próximas Etapas