Gerenciando solicitações de pull com o comando /pr

Use o comando de barra /pr para exibir, criar e corrigir solicitações de pull diretamente de CLI do Copilot.

Neste artigo

Visão geral

O comando de barra /pr permite gerenciar o ciclo de vida completo dos pull requests sem sair do terminal. Você pode verificar o status da solicitação de pull, criar novas solicitações de pull e corrigir problemas comuns, como comentários de revisão, conflitos de mesclagem e falhas de CI.

Pré-requisito

Você deve estar trabalhando em um repositório Git que está hospedado no GitHub.

Subcomandos

O comando de barra /pr possui vários subcomandos que você pode usar para executar diferentes tipos de ações nos seus pull requests.

Observação

Todos os subcomandos /pr se relacionam com a ramificação atual, por exemplo, corrigindo falhas nas verificações de CI para o pull request associado à ramificação atual.

Use este subcomando Para fazer isso Requer uma PR existente Pode fazer commit e enviar por push
/pr ou /pr view Mostrar o status da solicitação de pull para a ramificação atual. Saiba mais Sim No
/pr view web Abra a solicitação de pull no navegador. Saiba mais Sim No
/pr create Crie ou atualize uma solicitação de pull. Saiba mais No Sim
/pr fix feedback Responder a comentários de revisão na solicitação de pull. Saiba mais Sim Sim
/pr fix conflicts Sincronizar o ramo com o ramo base e resolver conflitos. Saiba mais Sim Sim
/pr fix ci Diagnosticar e corrigir verificações de CI com falha. Saiba mais Sim Sim
/pr fix ou /pr fix all Execute todas as três fases de correção em ordem: feedback, conflitos e CI. Saiba mais Sim Sim
/pr auto Crie um pull request, se necessário, e percorra todas as fases de correção até que todas as verificações do pull request sejam aprovadas. Saiba mais No Sim

Subcomandos que fazem alterações de commit e push solicitarão permissão antes de executar ações potencialmente destrutivas, a menos que você tenha pré-autorizado essas ferramentas. Para obter mais informações, consulte Permitir e negar o uso da ferramenta.

Exibir o status da solicitação de pull

Para verificar o status da solicitação de pull associada ao branch atual, insira o seguinte em uma sessão interativa:

Copilot prompt
/pr

Abrindo a solicitação de pull no navegador

Se você quiser visualizar o pull request em GitHub.com em vez do terminal, insira:

Copilot prompt
/pr view web

Isso abre a URL da solicitação de pull no navegador padrão.

Como criar uma solicitação de pull

Para criar uma solicitação de pull da ramificação atual, insira:

Copilot prompt
/pr create

          O Copilot garante que todas as confirmações locais sejam enviadas por push para o branch remoto e, em seguida, cria a solicitação de pull. Se houver um modelo de solicitação de pull no repositório, Copilot siga-o ao gerar o título e a descrição da solicitação de pull.

Se já existir uma solicitação de pull para o branch atual, /pr create atualize a solicitação de pull existente em vez de criar uma nova.

Adicionando instruções para a criação de solicitação de pull

Você pode acrescentar instruções após /pr create para guiar Copilot. Por exemplo:

Copilot prompt
/pr create prefix the PR title 'Project X: '

Corrigindo comentários de revisão

Para que Copilot leia e responda aos comentários de revisão no seu pull request, insira:

Copilot prompt
/pr fix feedback

          O Copilot busca todos os threads de comentários de revisão na solicitação de pull, determina quais alterações são solicitadas, aplica as alterações à sua base de código e confirma e envia as correções por push. As solicitações de alteração de código acionáveis são priorizadas em relação aos comentários de conversa.

Resolução de conflitos de mesclagem

Para sincronizar seu branch com o branch base e resolver conflitos de mesclagem, insira:

Copilot prompt
/pr fix conflicts

          O Copilot busca a ramificação de base mais recente, sincroniza sua ramificação, resolve todos os conflitos e faz push do resultado.

Escolhendo uma estratégia de mesclagem

Ao resolver conflitos, CLI do Copilot precisa saber se uma estratégia de rebase ou mesclagem deve ser usada. Se você não tiver configurado uma preferência, Copilot solicitará que você escolha quando executar um comando que envolva a resolução de conflitos.

Para definir uma estratégia de mesclagem padrão para que você não seja solicitado sempre, adicione a mergeStrategy configuração ao arquivo de configuração. Você pode definir isso em suas configurações pessoais de usuário para Copilot, ou nas configurações do repositório.

  • Configurações do usuário: Adicionar "mergeStrategy": "rebase" ou "mergeStrategy": "merge" ao arquivo de configuração no nível do usuário (normalmente ~/.copilot/settings.json).
  • Configurações do repositório: adicione a mesma configuração à .github/copilot/settings.json raiz do repositório.

Corrigindo falhas de CI

Para que Copilot faça o diagnóstico e corrija verificações de CI com falha, insira:

Copilot prompt
/pr fix ci

          O Copilot identifica os trabalhos de CI com falha, analisa os logs para determinar as causas comuns, aplica correções direcionadas e faz o push. Em seguida, ele verifica novamente o status da CI e repete o processo até que as verificações sejam aprovadas ou determina que não é possível avançar mais.

Se os erros não estiverem relacionados às alterações de ramificação, o Copilot indicará isso claramente para que você possa tomar as medidas apropriadas.

Você pode acrescentar contexto adicional para ajudar a Copilot se concentrar em falhas específicas. Por exemplo:

Copilot prompt
/pr fix ci focus on test failures

Corrigindo todos os problemas de uma só vez

Para resolver todos os problemas pendentes em uma solicitação de pull em um único comando, insira:

Copilot prompt
/pr fix

Isso executa três fases na ordem:

  1.           **Analisar feedback**: considera todos os comentários de revisão.

  2.        **Conflitos** — Sincroniza o ramo com o ramo base e resolve todos os conflitos.

  3.        **Falhas de CI** – diagnostica e corrige verificações de CI que falham.

Automatizando o fluxo de trabalho de solicitação de pull completo

Para que o Copilot gerencie todo o processo de solicitação de pull da criação para um estado totalmente verde, insira:

Copilot prompt
/pr auto

Se não houver nenhuma solicitação de pull para o branch atual, Copilot cria uma primeiro. Em seguida, ele percorre as fases de correção (revisão de comentários, conflitos e CI) repetindo até que não haja mais comentários de revisão, nenhum conflito e todas as verificações de CI sejam aprovadas.

Você pode acrescentar instruções para orientar a criação da solicitação de pull. Por exemplo:

Copilot prompt
/pr auto include migration notes in the description

Leitura adicional