Initial commit
This commit is contained in:
Zhongwei Li
276
commands/role-help.md
Normal file
276
commands/role-help.md
Normal file
@@ -0,0 +1,276 @@
|
||||
## Role Help
|
||||
|
||||
Guia de seleção e sistema de ajuda para quando não souber qual papel usar.
|
||||
|
||||
### Uso
|
||||
|
||||
```bash
|
||||
/role-help # Guia geral de seleção de papéis
|
||||
/role-help <situação/problema> # Papel recomendado para situação específica
|
||||
/role-help compare <papel 1>,<papel 2> # Comparação de papéis
|
||||
```
|
||||
|
||||
### Exemplos básicos
|
||||
|
||||
```bash
|
||||
# Orientação geral
|
||||
/role-help
|
||||
→ Exibe lista de papéis disponíveis e suas características
|
||||
|
||||
# Recomendação por situação
|
||||
/role-help "Preocupado com a segurança da API"
|
||||
→ Recomendação do papel security e modo de uso
|
||||
|
||||
# Comparação de papéis
|
||||
/role-help compare frontend,mobile
|
||||
→ Diferenças entre frontend e mobile e como usar cada um
|
||||
```
|
||||
|
||||
### Guia de seleção de papéis por situação
|
||||
|
||||
### Relacionado à segurança
|
||||
|
||||
```text
|
||||
Use o papel security quando:
|
||||
✅ Implementação de login e autenticação
|
||||
✅ Verificação de vulnerabilidades de segurança da API
|
||||
✅ Criptografia de dados e proteção de privacidade
|
||||
✅ Verificação de compliance de segurança
|
||||
✅ Teste de invasão e penetração
|
||||
|
||||
Uso: /role security
|
||||
```
|
||||
|
||||
### 🏗️ Arquitetura e design
|
||||
|
||||
```text
|
||||
Use o papel architect quando:
|
||||
✅ Avaliação do design do sistema geral
|
||||
✅ Decisão entre microsserviços vs monólito
|
||||
✅ Design de banco de dados e seleção tecnológica
|
||||
✅ Considerações de escalabilidade e extensibilidade
|
||||
✅ Avaliação de dívida técnica e planos de melhoria
|
||||
|
||||
Uso: /role architect
|
||||
```
|
||||
|
||||
### ⚡ Problemas de performance
|
||||
|
||||
```text
|
||||
Use o papel performance quando:
|
||||
✅ Aplicação está lenta
|
||||
✅ Otimização de consultas ao banco de dados
|
||||
✅ Melhoria da velocidade de carregamento de páginas web
|
||||
✅ Otimização do uso de memória e CPU
|
||||
✅ Estratégias de scaling e balanceamento de carga
|
||||
|
||||
Uso: /role performance
|
||||
```
|
||||
|
||||
### 🔍 Investigação de causas de problemas
|
||||
|
||||
```text
|
||||
Use o papel analyzer quando:
|
||||
✅ Análise da causa raiz de bugs e erros
|
||||
✅ Investigação de causas de falhas do sistema
|
||||
✅ Análise estrutural de problemas complexos
|
||||
✅ Análise de dados e investigação estatística
|
||||
✅ Esclarecimento de por que este problema ocorreu
|
||||
|
||||
Uso: /role analyzer
|
||||
```
|
||||
|
||||
### 🎨 Frontend e UI/UX
|
||||
|
||||
```text
|
||||
Use o papel frontend quando:
|
||||
✅ Melhoria da interface do usuário
|
||||
✅ Suporte à acessibilidade
|
||||
✅ Design responsivo
|
||||
✅ Melhoria da usabilidade e facilidade de uso
|
||||
✅ Tecnologias gerais de frontend web
|
||||
|
||||
Uso: /role frontend
|
||||
```
|
||||
|
||||
### 📱 Desenvolvimento de aplicativos móveis
|
||||
|
||||
```text
|
||||
Use o papel mobile quando:
|
||||
✅ Otimização de apps iOS e Android
|
||||
✅ Design de UX específico para mobile
|
||||
✅ Otimização de interface touch
|
||||
✅ Suporte offline e funções de sincronização
|
||||
✅ Suporte para App Store e Google Play
|
||||
|
||||
Uso: /role mobile
|
||||
```
|
||||
|
||||
### 👀 Code review e qualidade
|
||||
|
||||
```text
|
||||
Use o papel reviewer quando:
|
||||
✅ Verificação da qualidade do código
|
||||
✅ Avaliação de legibilidade e manutenibilidade
|
||||
✅ Verificação de convenções de codificação
|
||||
✅ Propostas de refatoração
|
||||
✅ Review de PR e commits
|
||||
|
||||
Uso: /role reviewer
|
||||
```
|
||||
|
||||
### 🧪 Testes e garantia de qualidade
|
||||
|
||||
```text
|
||||
Use o papel qa quando:
|
||||
✅ Planejamento de estratégias de teste
|
||||
✅ Avaliação de cobertura de teste
|
||||
✅ Política de implementação de testes automatizados
|
||||
✅ Estratégias de prevenção de bugs e melhoria da qualidade
|
||||
✅ Automação de testes em CI/CD
|
||||
|
||||
Uso: /role qa
|
||||
```
|
||||
|
||||
### Quando múltiplos papéis são necessários
|
||||
|
||||
### 🔄 multi-role (análise paralela)
|
||||
|
||||
```text
|
||||
Use multi-role quando:
|
||||
✅ Quiser avaliação de múltiplas perspectivas especializadas
|
||||
✅ Quiser criar plano de melhoria integrado
|
||||
✅ Quiser comparar avaliações de cada área
|
||||
✅ Quiser organizar contradições e duplicações
|
||||
|
||||
Exemplo: /multi-role security,performance
|
||||
```
|
||||
|
||||
### 🗣️ role-debate (debate)
|
||||
|
||||
```text
|
||||
Use role-debate quando:
|
||||
✅ Há trade-offs entre áreas especializadas
|
||||
✅ Opiniões se dividem na seleção tecnológica
|
||||
✅ Quiser decidir diretrizes de design por debate
|
||||
✅ Quiser ouvir debates de diferentes perspectivas
|
||||
|
||||
Exemplo: /role-debate security,performance
|
||||
```
|
||||
|
||||
### 🤖 smart-review (sugestão automática)
|
||||
|
||||
```text
|
||||
Use smart-review quando:
|
||||
✅ Não souber qual papel usar
|
||||
✅ Quiser conhecer a abordagem ideal para a situação atual
|
||||
✅ Quiser escolher entre múltiplas opções
|
||||
✅ For iniciante e estiver em dúvida
|
||||
|
||||
Exemplo: /smart-review
|
||||
```
|
||||
|
||||
### Tabela de comparação de papéis
|
||||
|
||||
### Relacionados à segurança
|
||||
|
||||
| Papel | Uso principal | Área forte | Área fraca |
|
||||
| -------- | -------------------------------- | ------------------------------------------ | ---------------------------------------- |
|
||||
| security | Vulnerabilidades e contramedidas | Análise de ameaças, design de autenticação | UX, performance |
|
||||
| analyzer | Análise da causa raiz | Análise lógica, coleta de evidências | Medidas preventivas, planejamento futuro |
|
||||
|
||||
### Relacionados ao design
|
||||
|
||||
| Papel | Uso principal | Área forte | Área fraca |
|
||||
| --------- | ------------------- | --------------------------------------------- | ------------------------------------------------ |
|
||||
| architect | Design de sistema | Perspectiva de longo prazo, otimização global | Implementação detalhada, soluções de curto prazo |
|
||||
| reviewer | Qualidade do código | Nível de implementação, manutenibilidade | Requisitos de negócio, UX |
|
||||
|
||||
### Relacionados à performance
|
||||
|
||||
| Papel | Uso principal | Área forte | Área fraca |
|
||||
| ----------- | ----------------------- | ----------------- | ------------------- |
|
||||
| performance | Aceleração e otimização | Medição, gargalos | Segurança, UX |
|
||||
| qa | Garantia de qualidade | Teste, automação | Design, arquitetura |
|
||||
|
||||
### Relacionados à experiência do usuário
|
||||
|
||||
| Papel | Uso principal | Área forte | Área fraca |
|
||||
| -------- | ------------- | ----------------------- | ------------- |
|
||||
| frontend | Web UI/UX | Browser, acessibilidade | Servidor, DB |
|
||||
| mobile | Mobile UX | Touch, suporte offline | Servidor, Web |
|
||||
|
||||
### Fluxograma para quando estiver em dúvida
|
||||
|
||||
```text
|
||||
Qual é a natureza do problema?
|
||||
├─ Relacionado à segurança → security
|
||||
├─ Problema de performance → performance
|
||||
├─ Investigação de bug/falha → analyzer
|
||||
├─ Melhoria de UI/UX → frontend ou mobile
|
||||
├─ Design/arquitetura → architect
|
||||
├─ Qualidade do código → reviewer
|
||||
├─ Relacionado a testes → qa
|
||||
└─ Complexo/composto → smart-review para sugestão
|
||||
|
||||
Abrange múltiplas áreas?
|
||||
├─ Quero análise integrada → multi-role
|
||||
├─ Debate/trade-offs → role-debate
|
||||
└─ Em dúvida sobre decisão → smart-review
|
||||
```
|
||||
|
||||
### Perguntas frequentes
|
||||
|
||||
### Q: Qual a diferença entre frontend e mobile?
|
||||
|
||||
```text
|
||||
A:
|
||||
frontend: Foco em navegador web, HTML/CSS/JavaScript
|
||||
mobile: Foco em app móvel, nativo iOS/Android, React Native etc.
|
||||
|
||||
Para casos relacionados a ambos, recomenda-se multi-role frontend,mobile
|
||||
```
|
||||
|
||||
### Q: Como distinguir security e analyzer?
|
||||
|
||||
```text
|
||||
A:
|
||||
security: Prevenção de ataques e ameaças, design de segurança
|
||||
analyzer: Análise de causas de problemas já ocorridos, investigação
|
||||
|
||||
Para investigação de incidentes de segurança: multi-role security,analyzer
|
||||
```
|
||||
|
||||
### Q: Qual a diferença entre architect e performance?
|
||||
|
||||
```text
|
||||
A:
|
||||
architect: Design de longo prazo do sistema geral, extensibilidade
|
||||
performance: Melhoria específica de velocidade e eficiência
|
||||
|
||||
Para design de performance de sistemas de grande escala: multi-role architect,performance
|
||||
```
|
||||
|
||||
### Integração com Claude
|
||||
|
||||
```bash
|
||||
# Combinação com explicação da situação
|
||||
/role-help
|
||||
"O carregamento da página do app React está lento e usuários estão reclamando"
|
||||
|
||||
# Combinação com conteúdo de arquivo
|
||||
cat problem-description.md
|
||||
/role-help
|
||||
"Recomende o papel ideal para este problema"
|
||||
|
||||
# Quando estiver em dúvida sobre opções específicas
|
||||
/role-help compare security,performance
|
||||
"Qual papel é adequado para o problema de tempo de validade do token JWT?"
|
||||
```
|
||||
|
||||
### Observações
|
||||
|
||||
- Problemas complexos são mais eficazes com combinação de múltiplos papéis
|
||||
- Para casos de alta urgência, responda rapidamente com single role
|
||||
- Quando estiver em dúvida, recomendamos receber sugestão automática com smart-review
|
||||
- A decisão final deve ser tomada pelo usuário considerando a natureza do problema
|
||||
Reference in New Issue
Block a user