Pular para o conteúdo

/ww:review:pr

Revisa um Pull Request e, no fim, oferece corrigir o que encontrou. Você passa o número ou o link do PR — do GitHub ou do Bitbucket.

/ww:review:pr

ReviewCompatível com ww 1.14.0Modelo: opus

Uso

/ww:review:pr 42
/ww:review:pr https://github.com/org/repo/pull/42 --comment
/ww:review:pr 42 --comment --yes

Argumentos

ArgumentoObrigatório?Descrição
<pr-link-or-number>SimO Pull Request a revisar: o número (o repositório vem do remote do git) ou o endereço completo, do GitHub ou do Bitbucket.
--commentOpcionalAlém de gerar a revisão, deixa os comentários inline no próprio PR. Também funciona escrevendo "comentar", "comment" ou "inline" no pedido.
--yesOpcionalNão pergunta o que corrigir: assume críticos e maiores. Para quando o comando roda sem ninguém na frente da tela.

Notas

Ele não commita nem faz push. E se a sua árvore tiver mudanças pendentes, ele para antes de corrigir, para não misturar o seu trabalho com o dele.

Antes de aprovar um PR de outra pessoa, ou antes de pedir revisão do seu, para pegar o que passa batido na leitura.

  • Só analisar (padrão) — a revisão sai para você e fica salva em .dr_ai/code-reviews/pr/, em dois arquivos com o número e o título do PR no nome: um .md para ler e um .json com os dados estruturados.
  • Analisar e comentar — além disso, o comando deixa comentários inline no PR, só nas linhas alteradas e só para os problemas de severidade crítica, alta ou média (até 50). Cada comentário é assinado como WiseWork Code Review, para não parecer escrito por você. Peça com --comment, ou simplesmente escrevendo “comentar” ou “inline” no pedido.

A análise olha só os arquivos alterados no PR, com quatro especialistas em paralelo: estilo, segurança, performance e qualidade de código. Relatório e comentários saem no idioma da conversa.

  1. O comando revisa o PR e apresenta os problemas encontrados.
  2. Se houver problemas, ele pergunta o que você quer corrigir: críticos e maiores (a recomendação), todos, só os críticos ou nenhum. Com --yes, ele não pergunta e assume “críticos e maiores” — útil quando o comando roda sem ninguém na frente da tela.
  3. Se você escolheu corrigir, ele garante que a branch do PR está aberta na sua máquina.
  4. Aplica apenas as correções escolhidas, preservando estilo, padrões e comportamento, e roda o lint ou o typecheck do projeto quando existem, reportando o resultado como ele é.
  5. Mostra os arquivos modificados.
  • Ele não commita nem faz push. O que fazer com as correções continua sendo decisão sua.
  • Trabalho não salvo bloqueia a correção. Se a sua árvore tiver mudanças pendentes, o comando para e pede que você faça commit ou guarde o trabalho antes — para não misturar as suas mudanças com as dele.
  • Escolher “nenhum” é uma saída válida. Você fica com a revisão e nada é alterado.
  • Precisa da CLI do provedor autenticada. No GitHub, o gh (gh auth login); no Bitbucket, o bkt ou as variáveis BB_AUTH_USER e BB_AUTH_TOKEN. O provedor é detectado pelo remote do repositório.
  • A correção acontece na branch do PR. Antes de corrigir, o comando troca para a branch do PR: no GitHub com o gh; no Bitbucket com o bkt ou, sem ele, com o git direto. Um PR do Bitbucket vindo de fork só é aberto com o bkt; sem ele, o comando para e explica como seguir.