Code Review skill

O que ela faz

A code-review compara o código atual com um ponto fixo que você escolhe: um commit, uma branch, uma tag ou a main. Ela confere se esse ponto existe e se há diferença, e então revisa a mudança por dois eixos que rodam em paralelo, cada um num subagente próprio.

O eixo de padrões lê os arquivos do repositório que dizem como escrever código, como CODING_STANDARDS.md e CONTRIBUTING.md, e soma uma lista de 12 cheiros de código do livro Refactoring, de Martin Fowler, como nome confuso, código duplicado e abstração que ninguém pediu. O que o repositório documenta vale mais que a lista.

O eixo de especificação procura a issue ou o documento de origem e aponta o que faltou, o que entrou sem ser pedido e o que parece feito mas está errado, citando a linha da especificação. Os dois relatórios saem lado a lado, sem misturar nem eleger um problema mais grave no geral.

Nas palavras de quem fez

Quando usar

• Revisar uma branch antes de abrir o pull request
• Conferir se o que o Claude construiu bate com a issue que você escreveu
• Checar o trabalho em andamento desde o último commit
• Pegar código fora do padrão do projeto antes de ir pra produção

Depois de instalar, é só pedir assim

• Usa a code-review no que mudou desde a main
• Revisa desde o commit a1b2c3d. A especificação está em docs/checkout.md
• Faz a code-review do que mudou desde a main. A especificação é a issue #42

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykAlerta

Perguntas