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

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.

Subcomandos que "commitam" e façam "push" de alterações 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.

Exibindo 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:

/pr

/pr

Abrindo a solicitação de pull no navegador

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

/pr view web

/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 do branch atual, insira:

/pr create

/pr create

          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:

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

/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:

/pr fix feedback

/pr fix feedback

          Copilot busca todos os threads de comentário 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:

/pr fix conflicts

/pr fix conflicts

          Copilot busca a ramificação 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/config.json).
• Configurações do repositório: adicione a mesma configuração à .github/copilot/settings.json raiz do repositório.

Corrigindo falhas de CI

Para diagnosticar Copilot e corrigir verificações de CI com falha, insira:

/pr fix ci

/pr fix ci

          Copilot identifica os trabalhos de CI com falha, analisa os logs para determinar as causas raiz, aplica correções direcionadas e realiza 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 branch, 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:

/pr fix ci focus on test failures

/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:

/pr fix

/pr fix

Etapas executadas em três fases na seguinte 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 gerenciar Copilot todo o processo de solicitação de pull da criação para um estado totalmente verde, insira:

/pr auto

/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:

/pr auto include migration notes in the description

/pr auto include migration notes in the description

Leitura adicional

• Permitir e negar o uso da ferramenta
• referência de comando da CLI GitHub Copilot