wan-huiyan/agent-review-panel

O que agent-review-panel faz?

Habilidade para Claude Code: Painel de revisão adversarial multi-agente — 4 a 6 revisores de IA debatem seu código/planos e um juiz supremo emite o veredito. 9 grupos de sinais autodetecção, listas de verificação de domínio integradas e mecanismos anti-pensamento de grupo.

Visão Geral

Este painel de revisão simula um ambiente adversarial onde múltiplos agentes de IA examinam seu código ou planos de projeto sob diferentes perspectivas. Cada revisor possui um papel específico (ex.: especialista em segurança, arquiteto, especialista em UX), garantindo que todos os aspectos sejam avaliados. Um juiz supremo então compila os argumentos e emite um veredito final, destacando pontos fortes, riscos e recomendações.

Recursos Principais

• Agentes Revisores: 4 a 6 agentes com funções pré-definidas que debatem entre si.

• Juiz Supremo: Agente neutro que analisa o debate e emite o veredito.

• 9 Grupos de Sinais Autodetecção: O sistema analisa automaticamente:

  1. Legibilidade e manutenabilidade
  2. Segurança e vulnerabilidades
  3. Desempenho e escalabilidade
  4. Conformidade com padrões
  5. Testabilidade
  6. Documentação
  7. Tratamento de erros
  8. Design e arquitetura
  9. Boas práticas gerais

• Checklists de Domínio: Inclui listas de verificação para domínios comuns como:

  • Desenvolvimento Web (frontend/backend)
  • Engenharia de Dados
  • Inteligência Artificial / Machine Learning
  • DevOps e Infraestrutura
  • Aplicações Mobile

• Mecanismos Anti-Pensamento de Grupo:

  • Atribuição de papéis distintos para evitar viés de confirmação.
  • Revisores podem discordar explicitamente uns dos outros.
  • O juiz supremo só decide após ouvir todos os argumentos.

Como Usar

1. Execute o comando claude review ou ative via interface do Claude Code.
2. Cole ou aponte o código ou plano a ser revisado.
3. O painel será montado e exibirá a discussão entre os agentes.
4. Após o debate, o juiz supremo apresentará o veredito final.

Parâmetros Opcionais

• --domain <tipo>: Especifica o domínio (ex.: --domain web, --domain ml).
• --focus <grupo>: Foca em um grupo de sinais específico (ex.: --focus security).
• --agents <número>: Define quantos revisores participarão (padrão: 4).

Exemplo

# Revisão de código com foco em segurança
claude review --focus security --path src/auth.js

# Revisão de plano de projeto para domínio de dados
claude review --domain data --path design_doc.md

Notas Técnicas

• A habilidade utiliza a capacidade de agentes do Claude Code para orquestrar múltiplas personalidades.
• Os agentes revisores são instruídos a fornecer críticas construtivas e específicas.
• O juiz supremo ponderará os argumentos com base em um sistema de votação virtual.

Licença

MIT