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

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.

Escolher o âmbito da revisão

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.

Trabalhar com os resultados da revisão

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 distinta. Consulte as definições de programador.

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.