name: coderabbit-review description: Executa CodeRabbit CLI em modo prompt-only para revisar alterações locais, identificar issues, planejar correções e validar com testes antes do commit tags: [code-review, quality, testing, coderabbit]

CodeRabbit CLI Review Skill

Skill para integrar o CodeRabbit CLI ao Claude Code, permitindo revisões automatizadas de código com análise de findings, aplicação de correções e validação por testes.

Objetivo

Executar o CodeRabbit CLI em modo otimizado para agentes (--prompt-only) para:

Identificar issues em alterações locais (staged/unstaged)
Gerar checklist priorizado de correções
Aplicar fixes seguindo padrões do projeto
Validar mudanças com testes automatizados
Garantir qualidade antes de commits/PRs

Quando Usar Esta Skill

Use esta skill quando precisar:

✅ Revisar código antes de abrir um PR
✅ Validar alterações locais antes de commit
✅ Obter checklist priorizado de correções do CodeRabbit
✅ Verificar se ajustes aplicados resolveram findings anteriores
✅ Garantir conformidade com padrões do projeto
✅ Automatizar revisões de código com validação por testes

❌ NÃO use quando:

Não houver alterações locais para revisar
CodeRabbit CLI não estiver instalado ou autenticado
Precisar apenas de análise manual sem automação

Pré-requisitos

Antes de usar esta skill, verifique:

CodeRabbit CLI instalado:
```
command -v coderabbit
```
Se não instalado, instrua o usuário a instalar via: https://docs.coderabbit.ai/cli/installation
Autenticação configurada:
```
coderabbit auth status
```
Se não autenticado, instrua o usuário a executar:
- coderabbit auth login (login interativo), ou
- Configurar CODERABBIT_API_KEY no ambiente
Git repository: Projeto deve ser um repositório git com alterações locais

Parâmetros de Entrada

Obrigatórios

Nenhum parâmetro é estritamente obrigatório (todos têm defaults).

Opcionais

base_branch (string): Branch base para comparação. Padrão: detectar automaticamente (main, master, develop)
review_type (string): Tipo de revisão. Valores: all | committed | uncommitted. Padrão: all
context_files (array): Arquivos de contexto adicionais (ex.: CLAUDE.md, specs, PRD)
tests_command (string): Comando de testes do projeto. Padrão: detectar automaticamente (npm test, pnpm test, etc.)
output_file (string): Arquivo de saída do CodeRabbit. Padrão: coderabbit_prompt.txt
auto_fix (boolean): Aplicar correções automaticamente. Padrão: true
severity_threshold (string): Severidade mínima para corrigir. Valores: critical | high | medium | low. Padrão: medium

Fluxo de Trabalho

1. Preparação de Contexto

# Verificar diretório de trabalho
pwd

# Listar arquivos de contexto disponíveis
ls -la | grep -E 'CLAUDE.md|README.md|CONTRIBUTING.md'

Ações:

Ler CLAUDE.md se existir
Ler arquivos em context_files se fornecidos
Identificar padrões e guias do projeto
Confirmar diretório de trabalho correto

2. Pré-checagem Obrigatória

# Verificar instalação do CodeRabbit CLI
if ! command -v coderabbit &> /dev/null; then
    echo "❌ CodeRabbit CLI não encontrado"
    echo "Instale via: https://docs.coderabbit.ai/cli/installation"
    exit 1
fi

# Verificar autenticação
coderabbit auth status
if [ $? -ne 0 ]; then
    echo "❌ CodeRabbit CLI não autenticado"
    echo "Execute: coderabbit auth login"
    echo "Ou configure: export CODERABBIT_API_KEY=your_key"
    exit 1
fi

IMPORTANTE:

❌ NUNCA peça ou exponha credenciais no chat
❌ NUNCA execute coderabbit auth login automaticamente
✅ Apenas oriente o usuário a autenticar manualmente

3. Detectar Configuração do Projeto

# Detectar branch principal
git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'
# Ou verificar branches comuns
git branch -r | grep -E 'origin/(main|master|develop)' | head -1

# Detectar comando de testes
if [ -f "package.json" ]; then
    # Verificar scripts npm/pnpm/yarn
    cat package.json | grep -E '"test"|"test:unit"|"lint"'
fi

4. Executar CodeRabbit em Modo Agente

# Comando padrão
coderabbit review \
  --prompt-only \
  --type ${review_type:-all} \
  --base ${base_branch:-main} \
  --output ${output_file:-coderabbit_prompt.txt}

# Verificar código de saída
if [ $? -ne 0 ]; then
    echo "❌ Falha ao executar CodeRabbit"
    cat ${output_file} 2>/dev/null
    exit 1
fi

5. Estruturar Findings

Após executar o CodeRabbit:

Ler arquivo output_file
Parsear findings por severidade/arquivo/linha
Cruzar com instruções locais (CLAUDE.md, docs)
Gerar checklist priorizado:
- 🔴 Crítico (critical)
- 🟠 Alto (high)
- 🟡 Médio (medium)
- 🟢 Baixo (low)

Exemplo de saída estruturada:

📊 CodeRabbit Review Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Base: main → Current: feature/xyz
Type: all changes

🔴 Critical Issues (2)
  - src/auth/auth.service.ts:45 - SQL Injection vulnerability
  - src/utils/crypto.ts:12 - Hardcoded credentials

🟠 High Issues (5)
  - src/api/users.controller.ts:89 - Missing input validation
  ...

🟡 Medium Issues (8)
  ...

🟢 Low Issues (12)
  ...

6. Planejar Correção Segura

Para cada finding:

Analisar contexto do código
Verificar padrões do projeto (CLAUDE.md, código existente)
Propor correção mínima e compatível
Evitar mudanças destrutivas

Restrições de segurança:

❌ NUNCA execute git reset --hard
❌ NUNCA remova arquivos fora do escopo
❌ NUNCA altere arquivos sensíveis (.env, credenciais)
✅ Use apenas edições incrementais e testáveis

7. Aplicar Mudanças (se auto_fix=true)

Para cada finding acima do threshold de severidade:
1. Ler o arquivo afetado
2. Identificar o bloco de código problemático
3. Aplicar correção usando Edit tool
4. Registrar mudança aplicada
5. Se não puder corrigir automaticamente, registrar TODO

Estratégia de correção:

Corrigir um finding por vez
Validar sintaxe após cada mudança
Manter histórico de mudanças aplicadas

8. Validar com Testes

# Detectar comando de testes
if [ -f "package.json" ]; then
    test_cmd=$(cat package.json | jq -r '.scripts.test // empty')
    if [ -n "$test_cmd" ]; then
        npm test
    fi
elif [ -f "Makefile" ]; then
    make test
fi

# Verificar resultado
if [ $? -ne 0 ]; then
    echo "❌ Testes falharam após correções"
    echo "Analisando logs para rollback/correção..."
fi

Se testes falharem:

Analisar logs de erro
Identificar se foi introduzido pela correção
Reverter ou corrigir a mudança
Re-executar testes

9. Re-validar com CodeRabbit (Opcional)

# Executar novamente para confirmar que findings foram resolvidos
coderabbit review \
  --prompt-only \
  --type uncommitted \
  --base ${base_branch} \
  --output coderabbit_recheck.txt

# Comparar findings antes/depois
diff coderabbit_prompt.txt coderabbit_recheck.txt

10. Relatar Resultados

Gerar resumo final com:

## 📋 CodeRabbit Review Report

### ⚙️ Comandos Executados
- `coderabbit review --prompt-only --type all --base main`
- `npm test`
- `coderabbit review --prompt-only --type uncommitted` (re-check)

### ✅ Findings Resolvidos (12/20)
🔴 Critical (2/2):
  - [x] src/auth/auth.service.ts:45 - SQL Injection → Parametrized query
  - [x] src/utils/crypto.ts:12 - Hardcoded credentials → Environment variable

🟠 High (4/5):
  - [x] src/api/users.controller.ts:89 - Input validation → Added DTO validation
  - [x] src/api/posts.controller.ts:34 - XSS vulnerability → Sanitization
  - [x] src/middleware/auth.ts:23 - Missing error handling → Try-catch block
  - [x] src/services/email.service.ts:67 - Rate limiting → Added throttle decorator
  - [ ] src/api/admin.controller.ts:12 - Authorization bypass → **PENDING MANUAL REVIEW**

🟡 Medium (6/8):
  ...

### ⏳ Pendências (8)
1. src/api/admin.controller.ts:12 - Requer análise de regras de negócio
2. src/legacy/old-auth.ts:* - Sistema legado, refatoração complexa
3. ...

### 🧪 Validação
- Testes executados: ✅ 234 passed, 0 failed
- Linting: ✅ No issues
- Re-check CodeRabbit: ✅ 12 findings resolved

### ⚠️ Riscos Residuais
- Authorization bypass em admin.controller.ts requer validação manual
- Sistema legado (old-auth.ts) não foi alterado por segurança

### 📝 Próximos Passos
1. Revisar pendências manualmente
2. Executar testes E2E se disponíveis
3. Commit das alterações aprovadas
4. Abrir PR com este relatório

---
**Não commit automático** - Revisão final do usuário necessária

Saídas Esperadas

A skill deve produzir:

Sumário de execução: Comandos executados e status
Findings estruturados: Lista priorizada por severidade
Mudanças aplicadas: Diffs ou patches propostos
Resultados de testes: Logs e status
Pendências: Issues que precisam de revisão manual
Riscos residuais: O que não foi corrigido e por quê

Restrições e Limites

Segurança

❌ NUNCA exija ou exponha credenciais
❌ NUNCA execute comandos destrutivos (git reset --hard, rm -rf)
❌ NUNCA altere arquivos sensíveis (.env, .git/config, credenciais)
❌ NUNCA execute coderabbit auth login automaticamente
✅ Apenas oriente o usuário a autenticar manualmente

Escopo

✅ Use apenas recursos locais do repositório
✅ Preserve formato e estilo existentes
✅ Siga guias locais (CLAUDE.md, CONTRIBUTING.md)
❌ Evite downloads externos durante execução
❌ Não crie commits automaticamente

Qualidade

✅ Aplique correções incrementais e testáveis
✅ Valide cada mudança quando possível
✅ Registre TODOs claros para itens não automatizáveis
❌ Não faça over-engineering ou refatorações desnecessárias

Exemplos de Uso

Exemplo 1: Revisão Completa com Correções Automáticas

User: Use a skill coderabbit-review para revisar minhas alterações locais e aplicar correções

Claude: Vou executar a CodeRabbit CLI Review Skill para revisar suas alterações.

1. Verificando pré-requisitos...
   ✅ CodeRabbit CLI instalado
   ✅ Autenticação configurada
   ✅ Git repository detectado

2. Detectando configuração do projeto...
   - Base branch: main
   - Review type: all
   - Tests command: npm test

3. Executando CodeRabbit...
   $ coderabbit review --prompt-only --type all --base main --output coderabbit_prompt.txt
   ✅ Review completo

4. Estruturando findings...
   📊 Encontrados: 20 issues (2 critical, 5 high, 8 medium, 5 low)

5. Aplicando correções (severity >= medium)...
   [15 correções aplicadas automaticamente]

6. Validando com testes...
   $ npm test
   ✅ 234 passed, 0 failed

7. Re-validando com CodeRabbit...
   ✅ 15 findings resolvidos, 5 pendentes

[Relatório completo gerado]

Exemplo 2: Revisão Somente de Uncommitted Changes

User: Execute coderabbit-review apenas para mudanças não commitadas, sem aplicar correções automaticamente

Claude: Executando revisão em modo somente-leitura...

Parâmetros:
- review_type: uncommitted
- auto_fix: false
- base_branch: main

[Executa passos 1-5 do fluxo]

Relatório de findings gerado em coderabbit_prompt.txt
Nenhuma correção aplicada (modo somente-leitura)

Próximos passos sugeridos:
1. Revisar findings em coderabbit_prompt.txt
2. Decidir quais correções aplicar
3. Re-executar skill com auto_fix=true se desejar

Exemplo 3: Revisão com Contexto Customizado

User: Use coderabbit-review com contexto dos arquivos ARCHITECTURE.md e docs/security-guidelines.md, base branch develop, apenas critical e high

Claude: Executando revisão com contexto customizado...

Parâmetros:
- base_branch: develop
- context_files: [ARCHITECTURE.md, docs/security-guidelines.md]
- severity_threshold: high
- review_type: all

1. Lendo contexto adicional...
   ✅ ARCHITECTURE.md (padrões de arquitetura)
   ✅ docs/security-guidelines.md (guidelines de segurança)

2. Executando CodeRabbit...
   [análise considerando contexto dos guidelines]

3. Aplicando correções (critical + high apenas)...
   [6 correções aplicadas seguindo guidelines]

[Relatório gerado]

Exemplo 4: Revisão Pré-Commit

User: Quero revisar com coderabbit antes de fazer commit

Claude: Executando revisão pré-commit...

1. Detectando alterações staged...
   ✅ 5 arquivos modificados detectados

2. Executando CodeRabbit...
   $ coderabbit review --prompt-only --type uncommitted --base main

3. Findings encontrados: 3 medium, 1 high

4. Aplicando correções...
   ✅ Todas as 4 issues resolvidas

5. Validando...
   ✅ Testes passando
   ✅ Linting OK

6. Re-validando...
   ✅ Nenhum finding remanescente

Suas alterações estão prontas para commit!

Recomendação:
$ git add .
$ git commit -m "seu commit message aqui"

Dependências

CodeRabbit CLI (>= 1.0.0): https://docs.coderabbit.ai/cli/installation
Git: Repositório git inicializado
Autenticação CodeRabbit: Via coderabbit auth login ou CODERABBIT_API_KEY
Comando de testes (opcional): npm/pnpm/yarn test, pytest, make test, etc.

Troubleshooting

CodeRabbit CLI não encontrado

# Verificar instalação
command -v coderabbit

# Se não instalado, instalar via:
# macOS/Linux:
curl -fsSL https://get.coderabbit.ai | sh

# Ou via npm:
npm install -g @coderabbit/cli

Erro de autenticação

# Verificar status
coderabbit auth status

# Autenticar via browser
coderabbit auth login

# Ou via API key
export CODERABBIT_API_KEY=your_api_key_here

Nenhum finding detectado

Verifique se há alterações locais: git status
Confirme que base_branch está correto
Tente mudar review_type para all

Testes falhando após correções

Revise os logs de erro detalhadamente
Identifique qual correção introduziu o problema
Use git diff para ver exatamente o que mudou
Reverta correções problemáticas manualmente se necessário

Notas de Versão

v1.0.0 (2025-01-28)

✨ Criação inicial da skill
✅ Suporte a modo prompt-only do CodeRabbit CLI
✅ Auto-fix com threshold de severidade
✅ Validação automática com testes
✅ Re-validação opcional pós-correção
✅ Relatórios estruturados e detalhados
✅ Detecção automática de configuração do projeto
✅ Suporte a context files customizados
✅ Modo somente-leitura (auto_fix=false)

Manutenção e Suporte

Esta skill é genérica e pode ser usada em qualquer projeto com:

Git repository
CodeRabbit CLI instalado e autenticado
Opcionalmente, comando de testes configurado

Para reportar issues ou sugerir melhorias:

Abra uma issue no repositório do projeto
Documente o comportamento esperado vs atual
Inclua logs de execução se relevante

Licença

Esta skill segue a mesma licença do projeto em que está inserida.

coderabbit-review

SKILL.md