ricardonevesbraga/flowgrammers-skills/code-reviewer

Code Reviewer

Ferramentas automatizadas de revisão de código para analisar pull requests, detectar problemas de qualidade de código e gerar relatórios de revisão.

Sumário

• Ferramentas
• PR Analyzer
• Code Quality Checker
• Gerador de Relatório de Revisão
• Guias de Referência
• Linguagens Suportadas

Ferramentas

PR Analyzer

Analisa o git diff entre branches para avaliar a complexidade de revisão e identificar riscos.

# Analisar branch atual contra main
python scripts/pr_analyzer.py /path/to/repo
 
# Comparar branches específicas
python scripts/pr_analyzer.py . --base main --head feature-branch
 
# Saída JSON para integração
python scripts/pr_analyzer.py /path/to/repo --json

O que detecta:

• Segredos hardcoded (senhas, chaves de API, tokens)
• Padrões de injeção SQL (concatenação de strings em consultas)
• Statements de depuração (debugger, console.log)
• Desabilitação de regras ESLint
• Tipos any do TypeScript
• Comentários TODO/FIXME

A saída inclui:

• Pontuação de complexidade (1-10)
• Categorização de risco (crítico, alto, médio, baixo)
• Priorização de arquivos para ordem de revisão
• Validação de mensagem de commit

Code Quality Checker

Analisa código-fonte para problemas estruturais, code smells e violações SOLID.

# Analisar um diretório
python scripts/code_quality_checker.py /path/to/code
 
# Analisar linguagem específica
python scripts/code_quality_checker.py . --language python
 
# Saída JSON
python scripts/code_quality_checker.py /path/to/code --json

O que detecta:

• Funções longas (>50 linhas)
• Arquivos grandes (>500 linhas)
• God classes (>20 métodos)
• Aninhamento profundo (>4 níveis)
• Muitos parâmetros (>5)
• Alta complexidade ciclomática
• Tratamento de erro ausente
• Importações não utilizadas
• Números mágicos

Limites:

Gerador de Relatório de Revisão

Combina análise de PR e resultados de qualidade de código em relatórios de revisão estruturados.

# Gerar relatório para repositório atual
python scripts/review_report_generator.py /path/to/repo
 
# Saída em Markdown
python scripts/review_report_generator.py . --format markdown --output review.md
 
# Usar análises pré-computadas
python scripts/review_report_generator.py . \
  --pr-analysis pr_results.json \
  --quality-analysis quality_results.json

O relatório inclui:

• Veredicto de revisão (aprovar, solicitar mudanças, bloquear)
• Pontuação (0-100)
• Itens de ação priorizados
• Resumo de problemas por severidade
• Ordem de revisão sugerida

Veredictos:

Guias de Referência

Lista de Verificação de Revisão de Código

references/code_review_checklist.md

Listas de verificação sistemáticas cobrindo:

• Verificações pré-revisão (build, testes, higiene do PR)
• Correção (lógica, tratamento de dados, tratamento de erros)
• Segurança (validação de entrada, prevenção de injeção)
• Desempenho (eficiência, cache, escalabilidade)
• Manutenibilidade (qualidade de código, nomenclatura, estrutura)
• Testes (cobertura, qualidade, mocking)
• Verificações específicas por linguagem

Padrões de Código

references/coding_standards.md

Padrões específicos por linguagem para:

• TypeScript (anotações de tipo, segurança de null, async/await)
• JavaScript (declarações, padrões, módulos)
• Python (type hints, exceções, design de classes)
• Go (tratamento de erros, structs, concorrência)
• Swift (opcionais, protocolos, erros)
• Kotlin (segurança de null, data classes, coroutines)

Anti-Padrões Comuns

references/common_antipatterns.md

Catálogo de anti-padrões com exemplos e correções:

• Estruturais (god class, método longo, aninhamento profundo)
• Lógicos (boolean blindness, código stringly typed)
• Segurança (injeção SQL, credenciais hardcoded)
• Desempenho (queries N+1, coleções ilimitadas)
• Testes (duplicação, testar implementação)
• Async (floating promises, callback hell)

Linguagens Suportadas