313 lines
9.5 KiB
Markdown
313 lines
9.5 KiB
Markdown
## Multi Role
|
|
|
|
Comando que realiza análise paralela do mesmo objeto com múltiplos roles e gera relatório integrado.
|
|
|
|
### Como usar
|
|
|
|
```bash
|
|
/multi-role <role1>,<role2> [--agent|-a] [objeto de análise]
|
|
/multi-role <role1>,<role2>,<role3> [--agent|-a] [objeto de análise]
|
|
```
|
|
|
|
### Roles Disponíveis
|
|
|
|
#### Roles de Análise Especializada
|
|
|
|
- `security` : Especialista em auditoria de segurança
|
|
- `performance` : Especialista em otimização de performance
|
|
- `analyzer` : Especialista em análise de causa raiz
|
|
- `frontend` : Especialista em Frontend/UI/UX
|
|
- `mobile` : Especialista em desenvolvimento mobile
|
|
- `backend` : Especialista em backend e servidor
|
|
|
|
#### Roles de Suporte ao Desenvolvimento
|
|
|
|
- `reviewer` : Especialista em revisão de código
|
|
- `architect` : Arquiteto de sistemas
|
|
- `qa` : Engenheiro de testes
|
|
|
|
**Importante**:
|
|
|
|
- A opção `--agent` deve ser colocada imediatamente após a especificação dos roles
|
|
- A mensagem deve ser escrita após `--agent`
|
|
- Exemplo correto: `/multi-role qa,architect --agent avalie o plano`
|
|
- Exemplo incorreto: `/multi-role qa,architect avalie o plano --agent`
|
|
|
|
### Opções
|
|
|
|
- `--agent` ou `-a` : Executa cada role como subagente em paralelo (recomendado para análises em larga escala)
|
|
- Quando esta opção é usada, se a descrição de cada role contém frases de promoção de delegação automática (como "use PROACTIVELY"), uma delegação automática mais agressiva será habilitada
|
|
|
|
### Exemplos Básicos
|
|
|
|
```bash
|
|
# Análise de segurança e performance (normal)
|
|
/multi-role security,performance
|
|
"Avalie este endpoint de API"
|
|
|
|
# Análise paralela de sistema em larga escala (subagente)
|
|
/multi-role security,performance --agent
|
|
"Analise comprehensivamente a segurança e performance de todo o sistema"
|
|
|
|
# Análise integrada de frontend, mobile e performance
|
|
/multi-role frontend,mobile,performance
|
|
"Considere propostas de otimização desta tela"
|
|
|
|
# Avaliação multifacetada de design arquitetural (subagente)
|
|
/multi-role architect,security,performance --agent
|
|
"Avalie o design de migração para microsserviços"
|
|
```
|
|
|
|
### Processo de Análise
|
|
|
|
### Phase 1: Análise Paralela
|
|
|
|
Cada role analisa independentemente o mesmo objeto
|
|
|
|
- Execução de avaliação do ponto de vista especializado
|
|
- Julgamento com critérios específicos do role
|
|
- Geração de recomendações independentes
|
|
|
|
### Phase 2: Análise de Integração
|
|
|
|
Estrutura e integra os resultados
|
|
|
|
- Organização dos resultados de avaliação de cada role
|
|
- Identificação de sobreposições e pontos contraditórios
|
|
- Clarificação de relacionamentos complementares
|
|
|
|
### Phase 3: Relatório Integrado
|
|
|
|
Geração de recomendações finais
|
|
|
|
- Plano de ação com prioridades
|
|
- Explicitação de trade-offs
|
|
- Apresentação de roadmap de implementação
|
|
|
|
### Exemplo de Formato de Saída
|
|
|
|
### Caso de análise com 2 roles
|
|
|
|
```text
|
|
Análise Multi-Role: Security + Performance
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
Objeto de análise: Endpoint API /api/users
|
|
|
|
Resultado da análise Security:
|
|
Autenticação: Verificação JWT implementada adequadamente
|
|
Autorização: Controle de acesso baseado em roles incompleto
|
|
Criptografia: Chave API sendo outputada em texto plano nos logs
|
|
|
|
Score de avaliação: 65/100
|
|
Importância: Alta (devido ao acesso a dados confidenciais)
|
|
|
|
Resultado da análise Performance:
|
|
Tempo de resposta: Média 180ms (meta: dentro de 200ms)
|
|
Query de banco de dados: Problema N+1 detectado
|
|
Cache: Cache Redis não implementado
|
|
|
|
Score de avaliação: 70/100
|
|
Importância: Média (dentro do range aceitável atualmente)
|
|
|
|
Análise de correlação:
|
|
Oportunidades sinérgicas:
|
|
- Considerar criptografia simultaneamente na implementação do cache Redis
|
|
- Melhoria na saída de logs beneficia segurança + performance
|
|
|
|
Pontos de trade-off:
|
|
- Reforço da verificação de autorização ↔ Impacto no tempo de resposta
|
|
- Criptografia de logs ↔ Redução da eficiência de debug
|
|
|
|
Prioridade integrada:
|
|
Critical: Correção da saída de chave API em texto plano
|
|
High: Resolução de query N+1
|
|
Medium: Implementação de cache Redis + criptografia
|
|
Low: Detalhamento do controle de autorização
|
|
|
|
Roadmap de implementação:
|
|
Semana 1: Implementação de mascaramento de chave API
|
|
Semana 2: Otimização de query de banco de dados
|
|
Semana 3-4: Design e implementação de camada de cache
|
|
Mês 2: Reforço gradual do controle de autorização
|
|
```
|
|
|
|
### Caso de análise com 3 roles
|
|
|
|
```text
|
|
Análise Multi-Role: Frontend + Mobile + Performance
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
Objeto de análise: Tela de perfil do usuário
|
|
|
|
Resultado da análise Frontend:
|
|
Usabilidade: Layout intuitivo
|
|
Acessibilidade: Taxa de conformidade WCAG 2.1: 85%
|
|
Responsivo: Problemas na exibição em tablet
|
|
|
|
Resultado da análise Mobile:
|
|
Touch target: Mais de 44pt garantido
|
|
Operação com uma mão: Botões importantes posicionados na parte superior
|
|
Suporte offline: Não implementado
|
|
|
|
Resultado da análise Performance:
|
|
Exibição inicial: LCP 2.1 segundos (bom)
|
|
Otimização de imagens: WebP não suportado
|
|
Carregamento tardio: Não implementado
|
|
|
|
Recomendações integradas:
|
|
1. Otimização mobile (operação com uma mão + suporte offline)
|
|
2. Otimização de imagens (WebP + carregamento tardio)
|
|
3. Melhoria da UI para tablet
|
|
|
|
Prioridade: Mobile > Performance > Frontend
|
|
Período de implementação: 3-4 semanas
|
|
```
|
|
|
|
### Padrões de Combinação Eficazes
|
|
|
|
### Foco em Segurança
|
|
|
|
```bash
|
|
/multi-role security,architect
|
|
"Design do sistema de autenticação"
|
|
|
|
/multi-role security,frontend
|
|
"Segurança da tela de login"
|
|
|
|
/multi-role security,mobile
|
|
"Proteção de dados do app mobile"
|
|
```
|
|
|
|
### Foco em Performance
|
|
|
|
```bash
|
|
/multi-role performance,architect
|
|
"Design de escalabilidade"
|
|
|
|
/multi-role performance,frontend
|
|
"Aceleração de páginas web"
|
|
|
|
/multi-role performance,mobile
|
|
"Otimização de operação do app"
|
|
```
|
|
|
|
### Foco na Experiência do Usuário
|
|
|
|
```bash
|
|
/multi-role frontend,mobile
|
|
"UI multiplataforma"
|
|
|
|
/multi-role frontend,performance
|
|
"Equilíbrio entre UX e performance"
|
|
|
|
/multi-role mobile,performance
|
|
"Otimização de UX mobile"
|
|
```
|
|
|
|
### Análise Abrangente
|
|
|
|
```bash
|
|
/multi-role architect,security,performance
|
|
"Avaliação de todo o sistema"
|
|
|
|
/multi-role frontend,mobile,performance
|
|
"Avaliação geral da experiência do usuário"
|
|
|
|
/multi-role security,performance,mobile
|
|
"Diagnóstico geral do app mobile"
|
|
```
|
|
|
|
### Integração com Claude
|
|
|
|
```bash
|
|
# Combinação com análise de arquivos
|
|
cat src/components/UserProfile.tsx
|
|
/multi-role frontend,mobile
|
|
"Avalie este componente de múltiplas perspectivas"
|
|
|
|
# Avaliação de documento de design
|
|
cat architecture-design.md
|
|
/multi-role architect,security,performance
|
|
"Avalie este design em múltiplas áreas especializadas"
|
|
|
|
# Análise de erros
|
|
cat performance-issues.log
|
|
/multi-role performance,analyzer
|
|
"Analise problemas de performance de múltiplos ângulos"
|
|
```
|
|
|
|
### Diferenciação entre multi-role vs role-debate
|
|
|
|
### Quando usar multi-role
|
|
|
|
- Quer avaliação independente de cada área especializada
|
|
- Quer elaborar plano de melhorias integrado
|
|
- Quer organizar contradições e sobreposições
|
|
- Quer decidir prioridade de implementação
|
|
|
|
### Quando usar role-debate
|
|
|
|
- Há trade-offs entre áreas especializadas
|
|
- Opiniões podem se dividir na seleção técnica
|
|
- Quer decidir política de design através de discussão
|
|
- Quer ouvir discussão de diferentes perspectivas
|
|
|
|
### Execução Paralela de Subagentes (--agent)
|
|
|
|
Usando a opção `--agent`, cada role é executado em paralelo como subagente independente.
|
|
|
|
#### Promoção de Delegação Automática
|
|
|
|
Quando o campo description dos arquivos de role contém frases como as seguintes, uma delegação automática mais agressiva é habilitada no uso de `--agent`:
|
|
|
|
- "use PROACTIVELY"
|
|
- "MUST BE USED"
|
|
- Outras expressões de ênfase
|
|
|
|
#### Fluxo de Execução
|
|
|
|
```text
|
|
Execução normal:
|
|
Role 1 → Role 2 → Role 3 → Integração
|
|
(Execução sequencial, cerca de 3-5 minutos)
|
|
|
|
Execução --agent:
|
|
Role 1 ─┐
|
|
Role 2 ─┼→ Integração
|
|
Role 3 ─┘
|
|
(Execução paralela, cerca de 1-2 minutos)
|
|
```
|
|
|
|
#### Exemplos de Uso Eficaz
|
|
|
|
```bash
|
|
# Avaliação geral de sistema em larga escala
|
|
/multi-role architect,security,performance,qa --agent
|
|
"Avaliação abrangente do novo sistema"
|
|
|
|
# Análise detalhada de múltiplas perspectivas
|
|
/multi-role frontend,mobile,performance --agent
|
|
"Análise de otimização UX de todas as telas"
|
|
```
|
|
|
|
#### Comparação de Performance
|
|
|
|
| Número de Roles | Execução Normal | Execução --agent | Taxa de Redução |
|
|
| --------------- | --------------- | ---------------- | --------------- |
|
|
| 2 roles | 2-3 min | 1 min | 50% |
|
|
| 3 roles | 3-5 min | 1-2 min | 60% |
|
|
| 4 roles | 5-8 min | 2-3 min | 65% |
|
|
|
|
### Observações
|
|
|
|
- Execução simultânea de 3 ou mais roles pode resultar em saída longa
|
|
- Análises complexas podem levar mais tempo de execução
|
|
- Se surgirem recomendações mutuamente contraditórias, considere também role-debate
|
|
- A decisão final deve ser tomada pelo usuário com base nos resultados integrados
|
|
- **Ao usar --agent**: Usa mais recursos, mas é eficiente para análises em larga escala
|
|
|
|
### Detalhes de Configuração dos Roles
|
|
|
|
- As configurações detalhadas, o conhecimento especializado e as características de discussão de cada role são definidos em `.claude/agents/roles/`
|
|
- Inclui práticas Evidence-First e contramedidas contra vieses cognitivos
|
|
- Frases gatilho específicas de cada role ativam automaticamente o modo especializado
|