Usa o workflow de revisão integrado para obter code reviews alimentadas por IA diretamente no teu IDE. Bob analisa as alterações e sinaliza potenciais problemas antes de confirmares o teu trabalho.

Porquê usar code reviews?

Detetar erros cedo: Identifica problemas antes de entrarem no teu trabalho confirmado.

Poupar tempo: Antecipa potenciais comentários de revisores, reduzindo o tempo de aprovação de PR.

Melhorar a qualidade do código: Recebe sugestões para melhores práticas de programação e manutenibilidade.

Validar contra issues: Garante que as tuas alterações estão alinhadas com os requisitos das issues (GitHub necessário).

Como funciona

O workflow de revisão corre inteiramente no teu IDE. Bob fornece um painel de revisão dedicado. Abre-o com o comando /review.

Bob revê o diff entre os teus branches selecionados e sinaliza potenciais problemas no painel Bob Findings. Podes opcionalmente incluir uma issue do GitHub para validar que as tuas alterações cumprem os seus requisitos.

As revisões correm com aprovação automática. Bob avança por todos os passos de análise sem necessitar de confirmação manual.

Rever o teu código

Pré-requisitos

Acesso aos branches locais ou remotos que queres comparar.

Para validação de issues: uma conta do GitHub e o URL da issue (o GitHub é necessário para funcionalidades relacionadas com issues).

Nota:

Bob pode trabalhar com GitHub e GitLab para comparações de branches. No entanto, a validação de issues requer GitHub.

Iniciar uma revisão

Abre o painel Bob Review a partir da tua barra lateral com o comando /review ou o ícone do painel de revisão. O painel fornece uma interface visual para configurar e iniciar a tua revisão.

Seleciona o branch contra o qual queres comparar no dropdown de branches. Podes comparar com o teu branch atual, branches locais, branches remotos ou o branch predefinido do teu repositório.

Ativa Incluir alterações não confirmadas se quiseres incluir modificações locais que ainda não foram confirmadas.

Opcionalmente, seleciona uma issue do GitHub na lista de issues para validar que as tuas alterações cumprem os seus requisitos.

Clica em Iniciar revisão para começar.

Bob revê as tuas alterações e apresenta os resultados no painel Bob Findings.

Opções de revisão

Selecionar um branch de comparação

O seletor dropdown de branches mostra:

Branch atual: O teu branch ativo.

Branch predefinido: O branch predefinido do teu repositório (marcado com um badge).

Branches remotos: Branches do teu repositório remoto (marcados com um badge).

Branches locais: Outros branches locais (marcados com um badge).

Podes comparar main remoto com main local, o teu branch atual com qualquer outro branch, ou qualquer combinação de refs.

Mostrar alterações não confirmadas

Ativa a caixa de seleção Incluir alterações não confirmadas para incluir modificações locais não confirmadas na tua revisão. Esta opção é ativada automaticamente ao rever o teu branch atual.

Configurar exclusões de revisão

Podes excluir ficheiros ou padrões específicos das code reviews:

Abre as definições do Bob.

Navega para o separador Bob Findings.

Em Exclusões de revisão, adiciona padrões glob para os ficheiros a excluir (ex.: .vscode/**, *.test.ts).

Os ficheiros excluídos não aparecerão na lista de ficheiros do painel de revisão e não serão analisados durante as revisões.

Usar Bob Findings

Quando Bob completa uma revisão, os resultados aparecem no painel Bob Findings. Podes interagir com estes resultados de várias formas:

Ver resultados

Clica em qualquer resultado no painel Bob Findings para ver os detalhes completos.

Usa @issues no menu dropdown de contexto da interface de chat para referenciar resultados na conversa.

Navega para o ficheiro clicando no resultado para ver o código em contexto com anotações inline.

Para mais informações sobre menções de contexto, consulta menções de contexto.

Agir sobre os resultados

Cada resultado fornece a seguinte ação:

Corrigir com Bob: Pede ao Bob que corrija automaticamente o problema. Bob criará uma tarefa para tratar o resultado.

Ignorar: Remove o resultado do painel se não for relevante.

Dicas e melhores práticas

Combinar com revisões manuais: Usa as revisões automatizadas do Bob como primeira passagem antes das code reviews humanas.

Validar a cobertura de issues: Inclui uma issue do GitHub para garantir que as tuas alterações cumprem completamente os requisitos antes de criar um pull request.

Configurar exclusões: Exclui ficheiros de teste, código gerado ou ficheiros de configuração que não precisam de revisão.

Comparar com branches remotos: Usa o seletor de branches para rever o teu trabalho em relação às alterações remotas mais recentes.

Code reviews