1 pontos por huurray 14 일 전 | Ainda não há comentários. | Compartilhar no WhatsApp

É um plugin do Claude Code que revisa git diff ou um único arquivo simultaneamente sob 6 perspectivas (performance em React / qualidade de código / bugs / TypeScript / acessibilidade / segurança), e um agente synthesizer combina os resultados em um relatório único priorizado.

Contexto de criação

Ao pedir para uma LLM revisar um PR e colocar tudo em um único contexto com algo como "revise de forma geral", surgem dois problemas.

  • Contaminação de raciocínio: o tom da perspectiva de perf influencia o tom da perspectiva de a11y.
  • Colapso de modo: a resposta tende a se concentrar no eixo mais chamativo do diff.

Cada guideline, na prática, responde a uma "pergunta diferente". perf pergunta "é rápido?", a11y pergunta "chega a todo mundo?", security pergunta "há vazamento de dados?", quality pergunta "é fácil de mudar?". Por isso, em vez de pedir tudo para uma só pessoa, a estrutura foi criada para que cada mudança seja revisada no contexto isolado de sub-agentes, e depois apenas os resultados sejam reunidos e mesclados.

6 revisores padrão (guidelines já validadas na indústria)

  • react-perf — Vercel React Best Practices
  • quality — Toss Frontend Fundamentals (legibilidade/previsibilidade/cohesão/acoplamento)
  • bugs — React rules-of-hooks + regras de corretude do ESLint/TS-ESLint
  • ts — Google TypeScript Style Guide + Effective TypeScript
  • a11y — WCAG 2.2 + ARIA APG
  • security — padrões de segurança de frontend (XSS, vazamento de secrets, armazenamento inseguro etc.)

Os revisores podem ser adicionados ou substituídos manualmente (i18n, motion, design tokens etc.).

Como usar

Instalação em duas linhas dentro do Claude Code:

/plugin marketplace add huurray/fe-review-agents
/plugin install fe-review-agents@fe-review-agents

Executar a revisão:

/fe-review-agents:diff-review # mudanças staged
/fe-review-agents:diff-review branch:main # diff em relação à main
/fe-review-agents:file-review src/App.tsx # análise aprofundada de um único arquivo

Opções:

  • lang=ko|en (padrão: ko)
  • severity_min=LOW|MED|HIGH|CRITICAL (severidades abaixo disso são excluídas do relatório)

Trade-offs

O consumo de tokens é cerca de 6 vezes maior do que em um único contexto. Em troca, você ganha cobertura multiperspectiva sem contaminação de raciocínio nem colapso de modo. É uma ferramenta mais adequada para equipes que priorizam estabilidade acima de custo, em vez de equipes focadas em economizar.

Inspiração

A inspiração veio do padrão Compounding Engineering, que se diz ser usado internamente pela Toss (várias LLMs analisando PRs em paralelo).

Feedbacks/issues/PRs são bem-vindos. 🙏

Ainda não há comentários.

Ainda não há comentários.