SkillProgramaçãoSíntese
Feedback Estruturado de Code Review
Consolida todos os achados de um code review em feedback claro, priorizado e acionável em três camadas. Use após coletar os achados de lógica, segurança, performance e testes, para organizá-los antes de entregá-los ao autor do PR.
Ações
PerfilDev
ProfundidadeMédia
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Consolidar todos os achados das revisões de lógica, segurança, performance e testes em um feedback claro, priorizado em três camadas e acionável — de modo que o autor do PR saiba exatamente o que corrigir, o que considerar e o que é opcional, sem precisar interpretar a severidade de cada comentário.
Aplicação
Quando
faz sentido.
Usar
- Como etapa final do workflow de code review, após concluir as revisões de lógica, segurança, performance e testes.
- Quando um feedback extenso precisa ser organizado antes de ser entregue ao autor.
- Quando há múltiplos revisores e os achados precisam ser consolidados em um documento único.
Não usar
- Antes de completar as revisões técnicas — esta skill consolida achados, não os produz.
- Como substituto das revisões técnicas — não é possível produzir feedback estruturado sem ter feito a análise.
Prompt
Instruções
para a IA.
### Coletar e classificar
Reúna todos os achados das quatro revisões técnicas em um único pool, garantindo que cada item tenha localização (arquivo e linha), descrição, impacto e severidade. Em seguida, classifique cada achado em uma de três camadas. Bloqueante: bugs que produzem comportamento incorreto em cenários cobertos pelos requisitos, vulnerabilidades de severidade crítica ou alta, ausência de teste para comportamento de negócio crítico e quebras de contrato externo não versionadas. Importante: problemas de lógica em edge cases de baixa frequência, vulnerabilidades médias, performance em cold paths e testes frágeis. Opcional: legibilidade, refatorações sem risco e melhorias que não afetam o SLA. Na dúvida entre bloqueante e importante, classifique como bloqueante.
### Ordenar e sugerir resolução
Dentro de cada camada, ordene por severidade, depois por impacto em produção e, por fim, por facilidade de correção. Para cada achado, redija uma sugestão específica e acionável — não "refatore este código", mas "extraia a validação para um método separado e trate o caso nulo na linha 42".
### Sumário e documento final
Escreva um sumário executivo honesto de 2 a 4 frases sobre o estado do PR (pronto, condicionado a correções ou não pronto), a maior preocupação e o que merece reconhecimento. Monte o documento com sumário, as três camadas (sempre presentes, mesmo que vazias) e as perguntas pendentes ao autor. A severidade é comunicada pela posição no documento, não pelo tom — pressão de prazo não justifica suavizar achados bloqueantes.
Reúna todos os achados das quatro revisões técnicas em um único pool, garantindo que cada item tenha localização (arquivo e linha), descrição, impacto e severidade. Em seguida, classifique cada achado em uma de três camadas. Bloqueante: bugs que produzem comportamento incorreto em cenários cobertos pelos requisitos, vulnerabilidades de severidade crítica ou alta, ausência de teste para comportamento de negócio crítico e quebras de contrato externo não versionadas. Importante: problemas de lógica em edge cases de baixa frequência, vulnerabilidades médias, performance em cold paths e testes frágeis. Opcional: legibilidade, refatorações sem risco e melhorias que não afetam o SLA. Na dúvida entre bloqueante e importante, classifique como bloqueante.
### Ordenar e sugerir resolução
Dentro de cada camada, ordene por severidade, depois por impacto em produção e, por fim, por facilidade de correção. Para cada achado, redija uma sugestão específica e acionável — não "refatore este código", mas "extraia a validação para um método separado e trate o caso nulo na linha 42".
### Sumário e documento final
Escreva um sumário executivo honesto de 2 a 4 frases sobre o estado do PR (pronto, condicionado a correções ou não pronto), a maior preocupação e o que merece reconhecimento. Monte o documento com sumário, as três camadas (sempre presentes, mesmo que vazias) e as perguntas pendentes ao autor. A severidade é comunicada pela posição no documento, não pelo tom — pressão de prazo não justifica suavizar achados bloqueantes.
Casos
Exemplos
de uso.
**Contexto:** PR implementa endpoint de transferência entre carteiras. As revisões anteriores identificaram: condição de corrida no débito (lógica), `userId` sem verificação de ownership (segurança, IDOR), query sem índice (performance) e caminho de saldo insuficiente sem teste.
**Saída esperada do agente:**
## Code Review — feat: add wallet transfer endpointConstelação
Onde
ela vive.
Bundles que incluem
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).