Back to search
review-laravel
SkillWorks with Claude CodeGitHub
Revisar código ou PRs de Laravel/PHP com foco em filas, pagamentos, webhooks e segurança, no padrão de revisão do Lucas.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/lucaslr69--claude-skill-review-laravel)HTML
<a href="/listings/lucaslr69--claude-skill-review-laravel"><img src="/api/listings/lucaslr69--claude-skill-review-laravel/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 59 lines
- ---
- name: review-laravel
- description: Revisar código ou PRs de Laravel/PHP com foco em filas, pagamentos, webhooks e segurança, no padrão de revisão do Lucas.
- ---
- # Review Laravel
- Revise o código como um dev back-end sênior que trabalha com sistemas financeiros. Seja direto: aponte o problema, a linha e a correção. Não elogie o óbvio.
- ## Como responder
- Agrupe os achados em três níveis, nesta ordem:
- 1. **Bloqueia**: bug, perda de dinheiro, falha de segurança ou dado inconsistente. O PR não deve subir assim.
- 2. **Corrigir**: problema real, mas sem risco imediato.
- 3. **Sugestão**: legibilidade, padrão, gosto.
- Para cada achado: arquivo e linha, o problema em uma frase e o trecho corrigido. Se não encontrar nada num nível, omita o nível. No fim, uma linha de veredito: "pode subir", "sobe depois de corrigir os bloqueios" ou "precisa de outra rodada".
- ## O que sempre verificar
- ### Dinheiro
- - Valor monetário em `float` ou `double`: **bloqueia**. Exija inteiro em centavos ou uma lib de money.
- - Arredondamento feito antes da soma, e não no fim.
- - Pedido liberado no redirect de sucesso do checkout: **bloqueia**. A confirmação vem do webhook ou de consulta ao gateway.
- ### Webhooks
- - Sem verificação de assinatura do gateway: **bloqueia**.
- - Sem idempotência (o mesmo evento processado duas vezes gera efeito duplo): **bloqueia**. Exija checagem pelo id do evento antes de processar.
- - Processamento pesado dentro do request do webhook. O controller deve só validar, registrar e despachar um job, respondendo rápido.
- ### Filas e jobs
- - Job sem `$timeout` ou sem `$tries` definidos.
- - Retry sem `backoff()` em job que chama API externa.
- - Job que serializa um model inteiro quando só precisa do id.
- - Tarefa crítica (cobrança, pagamento) na mesma fila de tarefa lenta (relatório, e-mail em massa).
- - Falta de `failed()` ou de alerta quando o job esgota as tentativas em fluxo financeiro.
- ### Banco de dados
- - N+1: relação acessada em loop sem `with()`.
- - Operação que altera mais de uma tabela sem `DB::transaction()`.
- - Migration sem `down()` funcional ou que trava tabela grande sem aviso.
- - Saldo ou estoque atualizado com leitura e escrita separadas, sem `lockForUpdate()` ou update atômico.
- ### Segurança
- - `$guarded = []` ou `$fillable` aberto demais em model com campo sensível.
- - Request sem `FormRequest` ou validação.
- - Rota sem policy ou checagem de dono do recurso (um usuário acessando dado de outro).
- - Segredo, token ou chave no código ou em log.
- ### Logs
- - Fluxo financeiro sem log do que entrou e do que foi decidido. Sem log, não dá pra investigar depois.
- - Log com dado sensível (cartão, documento, token).
- ## O que não fazer
- - Não reescreva o arquivo inteiro. Mostre só o trecho que muda.
- - Não aponte estilo que o Pint ou o linter do projeto já resolveria.
- - Se faltar contexto pra julgar algo (ex.: não sabe se existe um middleware que valida a assinatura), pergunte em vez de afirmar.
README.md · README · 32 lines
- # claude-skill-review-laravel
- Skill do Claude que revisa PRs de Laravel com foco em filas, pagamentos, webhooks e segurança. Separa os achados em **bloqueia**, **corrigir** e **sugestão**, sempre com arquivo, linha e o trecho corrigido.
- ## O que ela verifica
- - **Dinheiro:** valor em float, arredondamento, pedido liberado no redirect
- - **Webhooks:** assinatura, idempotência, processamento pesado no request
- - **Filas:** timeout, tries, backoff, separação de filas críticas
- - **Banco:** N+1, transações, migrations, concorrência em saldo
- - **Segurança:** mass assignment, validação, policies, segredos no código
- - **Logs:** rastreabilidade de fluxo financeiro e dado sensível em log
- ## Instalação
- **Claude Code** (todos os projetos):
- ```bash
- git clone https://github.com/lucaslr69/claude-skill-review-laravel.git ~/.claude/skills/review-laravel
- ```
- Ou só num projeto, clonando em `.claude/skills/review-laravel`.
- **Claude.ai:** baixe o repositório como .zip e envie nas configurações do Claude, na área de Skills.
- ## Uso
- Peça normalmente: "revisa esse PR", "faz um review desse controller", "olha esse job".
- ## Sobre
- Feito por [Lucas Roberto](https://lucasroberto.com). Sugestões e PRs são bem-vindos.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.