Antes de começar
- Claude Code com suporte a plugins
- Repositório Git com um pull request acessível
- Acesso ao GitHub e ferramentas requeridas pelo plugin
- Conhecimento do comportamento esperado da mudança
Escolha uma mudança pequena e pronta para revisar
Comece com um PR que altere um comportamento delimitado, como a validação de um formulário. Leia a descrição e anote o que deveria acontecer antes e depois.
O plugin pode pular PRs em rascunho, fechados ou já revisados. Se isso acontecer, confira o motivo apresentado em vez de afirmar que houve uma revisão completa.
Instale a partir do diretório oficial
No Claude Code, use o comando abaixo. Confira o pacote e as permissões na interface de plugins e siga as instruções da versão instalada.
Se a instalação não encontrar o marketplace, abra /plugin e veja a disponibilidade do diretório oficial na documentação. Evite instalar um pacote com nome parecido de uma origem que você não verificou.
/plugin install code-review@claude-plugins-officialExecute uma revisão local
Abra o repositório na branch do PR e execute /code-review. Na versão documentada, a saída padrão fica no terminal; o argumento --comment solicita publicação no PR.
Para o exercício, mantenha o resultado local. Aguarde a conclusão e confira se o agente realmente analisou o diff ou apenas informou que o PR não era elegível.
/code-reviewPeça evidência para cada achado
Para cada problema apresentado, peça arquivo, trecho, situação que ativa a falha, resultado esperado e resultado observado. Peça que o agente explique como a mudança introduziu o problema.
Confira se o comportamento descrito faz parte do que o produto promete. Separe problemas antigos de falhas introduzidas pelo PR.
Reproduza o caso de maior impacto
Escolha o achado que pode impedir o fluxo principal. Tente reproduzir com dados de teste e, quando fizer sentido, acrescente um teste que falhe antes da correção e passe depois.
Se não conseguir reproduzir, registre a incerteza. Não transforme uma hipótese em uma acusação de bug apenas porque veio de vários agentes.
Feche a revisão com um resultado verificável
Peça um resumo curto com problemas confirmados, hipóteses descartadas e testes executados. Corrija os confirmados e repita os cenários afetados.
Se quiser publicar o resultado no GitHub, revise o texto e autorize essa etapa de forma explícita. Inclua somente observações que ajudem quem mantém o projeto a decidir.
O que você terá ao final
Uma revisão local com achados classificados por evidência e pelo menos um cenário prioritário conferido por você.
Vale conferir
- Revisões por agentes podem ter falsos positivos e deixar problemas passar.
- Instalação e execução consomem recursos conforme o plano do Claude Code.
- Fluxo conferido na documentação; nenhum PR deste exemplo foi revisado pela Agentspedia.