Revisão de código

Utilize o ChatGPT ou o Codex para inspecionar alterações de código antes de as confirmar ou enviar.

Iniciar uma revisão

No ChatGPT Work, carregue o código que pretende rever ou disponibilize-o através de um plugin de código-fonte instalado. No pedido, identifique o pull request, o ramo, o commit, os ficheiros e os critérios de revisão.

Rever na aplicação

Abra o painel de revisão para compreender o que foi alterado, fornecer comentários específicos de cada linha e decidir o que preparar, reverter, confirmar ou enviar.

Para pedir ao Codex que reveja as alterações, escreva /review no campo de composição. Escolha Rever em relação a um ramo base ou Rever alterações não confirmadas. O Codex apresenta conclusões ordenadas por prioridade sem alterar a sua árvore de trabalho.

O painel de revisão requer um projeto dentro de um repositório Git. Se o seu projeto ainda não for um repositório Git, a aplicação pede-lhe que crie um.

Introduza /review para abrir as predefinições de revisão da CLI. O Codex inicia um revisor dedicado que lê o diff selecionado e comunica resultados priorizados e acionáveis sem alterar a sua árvore de trabalho.

Introduza /review no compositor da extensão do IDE. Escolha Rever relativamente a um ramo base ou Rever alterações não confirmadas. O Codex comunica resultados priorizados sem alterar a sua árvore de trabalho.

O comando /review só é apresentado quando o projeto aberto se encontra num repositório Git.

Escolher o âmbito da revisão

Indique no pedido o pull request, o ramo, o commit ou os ficheiros a inspecionar. Para rever ficheiros locais que não estejam disponíveis através de um plugin de código-fonte instalado, carregue-os na conversa.

Alterações apresentadas

O painel de revisão reflete o estado do seu repositório Git, não apenas o que o Codex editou. Inclui alterações efetuadas pelo Codex, alterações efetuadas por si e quaisquer outras alterações não confirmadas no repositório.

Por predefinição, o painel de revisão apresenta alterações Não preparadas. Utilize Preparadas para o índice Git, Confirmação para uma confirmação selecionada, Ramo para a diferença em relação ao seu ramo base ou Último turno para o turno mais recente do assistente.

Rever vários repositórios

Quando um projeto local inclui várias pastas suportadas por diferentes repositórios Git, o painel de revisão pode apresentar alterações de cada repositório. Abra o seletor de repositórios no cabeçalho da revisão para inspecionar outro repositório e ver as linhas adicionadas ou removidas sem sair do painel de revisão atual.

Escolha Último turno para ver as alterações mais recentes do assistente em todos os repositórios anexados. O seletor de repositórios apresenta Todos os repositórios nessa vista. Outros âmbitos de revisão, como Não preparadas, Preparadas e Ramo, aplicam-se ao repositório que selecionar.

Escolha um destes âmbitos de /review:

• Rever relativamente a um ramo base encontra a base de intercalação e revê o diff do seu ramo.
• Rever alterações não confirmadas inclui ficheiros preparados, não preparados e não controlados.
• Rever um commit revê o conjunto exato de alterações de um commit selecionado.
• Instruções de revisão personalizadas centra a revisão nos critérios que fornecer.

Escolha um destes âmbitos de /review:

• Rever relativamente a um ramo base compara o seu ramo atual com um ramo que selecionar.
• Rever alterações não confirmadas revê as alterações na sua árvore de trabalho.

Trabalhar com os resultados da revisão

Os resultados da revisão são apresentados na conversa Web. Peça provas, solicite uma revisão de seguimento mais restrita ou peça ao ChatGPT que prepare ficheiros revistos.

Resultados da revisão de código

As conclusões da revisão aparecem como comentários inline no painel de revisão.

Por predefinição, as revisões são executadas na conversa atual. Em Definições > Geral > Revisão de código, escolha Separada para iniciar uma conversa de revisão separada. Consulte as definições de programador.

A revisão é apresentada como um turno na transcrição. Defina review_model em config.toml quando pretender que as revisões utilizem um modelo diferente do da sessão atual.

Por predefinição, a revisão é executada na conversa atual. Defina chatgpt.reviewDelivery como detached quando pretender que /review inicie uma conversa de revisão separada. Consulte a referência das definições da extensão do IDE.

Se pedir ao ChatGPT que prepare ficheiros revistos, as ferramentas e as permissões do espaço de trabalho disponíveis para a conversa continuam a aplicar-se.

Se pedir ao Codex que aplique as correções que encontrar, aplicam-se as suas definições de sandbox e aprovação habituais.

Navegar no painel de revisão

• Clicar no nome de um ficheiro abre normalmente esse ficheiro no editor escolhido. Pode escolher o editor predefinido nas definições de programador.
• Clicar no fundo do nome do ficheiro expande ou recolhe a diferença.
• Clicar numa única linha enquanto mantém a tecla Cmd premida abre a linha no editor escolhido.
• Se estiver satisfeito com uma alteração, pode prepará-la ou reverter as alterações que não pretende.

Comentários inline para fornecer feedback

Os comentários inline permitem-lhe anexar feedback diretamente a linhas específicas da diferença. Esta é frequentemente a forma mais rápida de orientar o Codex para a correção certa.

Para deixar um comentário inline:

1. Abra o painel de revisão.
2. Passe o cursor sobre a linha que pretende comentar.
3. Selecione o botão + que aparece.
4. Escreva o seu feedback e envie-o.
5. Depois de terminar de deixar feedback, envie uma mensagem para a conversa.

Como os comentários são específicos de cada linha, o Codex pode responder com maior precisão do que perante uma instrução geral.

O Codex trata os comentários inline como orientações de revisão. Depois de deixar comentários, envie uma mensagem de seguimento que torne explícita a sua intenção, por exemplo: “Resolva os comentários inline e mantenha o âmbito mínimo.”

Revisões de pedidos de integração

Quando o Codex tem acesso ao GitHub para o seu repositório e o projeto atual está no ramo do pedido de integração, a aplicação ChatGPT para computador pode ajudá-lo a tratar o feedback do pedido de integração sem sair da aplicação. A barra lateral apresenta o contexto do pedido de integração e o feedback dos revisores, e o painel de revisão apresenta os comentários junto à diferença, para que possa pedir ao Codex que resolva os problemas na mesma conversa.

Instale a GitHub CLI (gh) e autentique-a com gh auth login para que o Codex possa carregar o contexto do pedido de integração, os comentários de revisão e os ficheiros alterados. Se gh estiver em falta ou não estiver autenticada, os detalhes do pedido de integração podem não aparecer na barra lateral nem no painel de revisão.

Utilize este fluxo quando pretender manter todo o ciclo de correção num só local:

1. Abra o painel de revisão no ramo do pedido de integração.
2. Reveja o contexto do pedido de integração, os comentários e os ficheiros alterados.
3. Peça ao Codex que corrija os comentários específicos que pretende ver resolvidos.
4. Inspecione a diferença resultante no painel de revisão.
5. Prepare, confirme e envie as alterações para o ramo do pedido de integração quando estiver pronto.

Para revisões acionadas pelo GitHub, consulte Utilizar o Codex no GitHub.

Preparar e reverter ficheiros

O painel de revisão inclui ações Git para que possa ajustar a diferença antes de a confirmar.

Pode preparar, retirar da preparação ou reverter alterações nestes níveis:

• Diferença completa: utilize os botões de ação no cabeçalho da revisão, como Preparar tudo ou Reverter tudo.
• Por ficheiro: prepare, retire da preparação ou reverta um ficheiro individual.
• Por bloco: prepare, retire da preparação ou reverta um único bloco.

Utilize a preparação quando pretender aceitar parte do trabalho e a reversão quando pretender descartá-lo.

Estados preparado e não preparado

O Git pode representar alterações preparadas e não preparadas no mesmo ficheiro. Quando isso acontece, o painel pode apresentar o mesmo ficheiro em ambas as vistas. Este é um comportamento normal do Git.