Files
gh-wasabeef-claude-code-coo…/commands/multi-role.md
2025-11-30 09:05:34 +08:00

315 lines
9.9 KiB
Markdown

## Multi-rôle
Une commande qui analyse la même cible en parallèle avec plusieurs rôles et génère un rapport intégré.
### Utilisation
```bash
/multi-role <rôle1>,<rôle2> [--agent|-a] [cible_analyse]
/multi-role <rôle1>,<rôle2>,<rôle3> [--agent|-a] [cible_analyse]
```
### Rôles Disponibles
#### Rôles d'analyse spécialisée
- `security` : Expert en audit de sécurité
- `performance` : Expert en optimisation des performances
- `analyzer` : Expert en analyse des causes racines
- `frontend` : Expert en frontend et UI/UX
- `mobile` : Expert en développement mobile
- `backend` : Expert backend et serveur
#### Rôles de support au développement
- `reviewer` : Expert en revue de code
- `architect` : Architecte système
- `qa` : Ingénieur test
**Important** :
- Placez l'option `--agent` immédiatement après avoir spécifié les rôles
- Écrivez votre message après `--agent`
- Exemple correct : `/multi-role qa,architect --agent Évaluez le plan`
- Exemple incorrect : `/multi-role qa,architect Évaluez le plan --agent`
### Options
- `--agent` ou `-a` : Exécuter chaque rôle en tant que sous-agent en parallèle (recommandé pour l'analyse à grande échelle)
- Lors de l'utilisation de cette option, si les descriptions de rôle incluent des phrases de délégation proactive (comme "utiliser PROACTIVEMENT"), une délégation automatique plus agressive devient activée
### Exemples de base
```bash
# Analyse double de sécurité et performance (normal)
/multi-role security,performance
"Évaluez ce point de terminaison API"
# Analyse parallèle de système à grande échelle (sous-agents)
/multi-role security,performance --agent
"Analysez de manière exhaustive la sécurité et les performances du système"
# Analyse intégrée de frontend, mobile et performance
/multi-role frontend,mobile,performance
"Considérez les propositions d'optimisation pour cet écran"
# Évaluation multifacette de conception d'architecture (sous-agents)
/multi-role architect,security,performance --agent
"Évaluez la conception de microservices"
```
### Processus d'analyse
### Phase 1 : Analyse parallèle
Chaque rôle analyse indépendamment la même cible
- Effectuer une évaluation depuis une perspective spécialisée
- Porter des jugements basés sur des critères spécifiques au rôle
- Générer des recommandations indépendantes
### Phase 2 : Analyse intégrée
Structurer et intégrer les résultats
- Organiser les résultats d'évaluation de chaque rôle
- Identifier les chevauchements et contradictions
- Clarifier les relations complémentaires
### Phase 3 : Rapport intégré
Générer les recommandations finales
- Plan d'action priorisé
- Compromis explicites
- Feuille de route d'implémentation
### Exemples de format de sortie
### Pour une analyse à 2 rôles
```text
Analyse multi-rôles : Sécurité + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Cible d'analyse : Point de terminaison API /api/users
Résultats d'analyse de sécurité :
Authentification : Vérification JWT correctement implémentée
Autorisation : Contrôle d'accès basé sur les rôles incomplet
Chiffrement : Clés API journalisées en texte brut
Score d'évaluation : 65/100
Importance : Élevée (due à l'accès aux données sensibles)
Résultats d'analyse de performance :
Temps de réponse : Moyenne 180ms (dans l'objectif de 200ms)
Requêtes base de données : Problème N+1 détecté
Cache : Cache Redis non implémenté
Score d'évaluation : 70/100
Importance : Moyenne (actuellement dans la plage acceptable)
Analyse interconnectée :
Opportunités synergiques :
- Considérer le chiffrement lors de l'implémentation du cache Redis
- Améliorer la journalisation pour des gains en sécurité et performance
Points de compromis :
- Renforcement vérification autorisation ↔ Impact sur le temps de réponse
- Chiffrement des logs ↔ Efficacité de débogage réduite
Priorités intégrées :
Critique : Corriger la sortie en texte brut des clés API
Élevé : Résoudre les requêtes N+1
Moyen : Implémenter cache Redis + chiffrement
Faible : Affiner le contrôle d'autorisation
Feuille de route d'implémentation :
Semaine 1 : Implémenter le masquage des clés API
Semaine 2 : Optimisation des requêtes base de données
Semaines 3-4 : Conception et implémentation de la couche cache
Mois 2 : Renforcement progressif du contrôle d'autorisation
```
### Pour une analyse à 3 rôles
```text
Analyse multi-rôles : Frontend + Mobile + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Cible d'analyse : Écran de profil utilisateur
Résultats d'analyse frontend :
Utilisabilité : Mise en page intuitive
Accessibilité : 85% de conformité WCAG 2.1
Responsive : Problèmes avec l'affichage tablette
Résultats d'analyse mobile :
Cibles tactiles : 44pt+ assurés
Utilisation à une main : Boutons importants placés en haut
Support hors ligne : Non implémenté
Résultats d'analyse performance :
Affichage initial : LCP 2.1s (bon)
Optimisation d'images : WebP non supporté
Chargement paresseux : Non implémenté
Recommandations intégrées :
1. Optimisation mobile (utilisation à une main + support hors ligne)
2. Optimisation d'images (WebP + chargement paresseux)
3. Améliorations UI tablette
Priorité : Mobile > Performance > Frontend
Période d'implémentation : 3-4 semaines
```
### Patterns de combinaison efficaces
### Focus sécurité
```bash
/multi-role security,architect
"Conception système d'authentification"
/multi-role security,frontend
"Sécurité écran de connexion"
/multi-role security,mobile
"Protection des données d'application mobile"
```
### Focus performance
```bash
/multi-role performance,architect
"Conception d'évolutivité"
/multi-role performance,frontend
"Optimisation vitesse de page web"
/multi-role performance,mobile
"Optimisation performance d'app"
```
### Focus expérience utilisateur
```bash
/multi-role frontend,mobile
"UI cross-platform"
/multi-role frontend,performance
"Équilibre entre UX et performance"
/multi-role mobile,performance
"Optimisation UX mobile"
```
### Analyse complète
```bash
/multi-role architect,security,performance
"Évaluation système globale"
/multi-role frontend,mobile,performance
"Évaluation exhaustive expérience utilisateur"
/multi-role security,performance,mobile
"Diagnostic exhaustif application mobile"
```
### Collaboration avec Claude
```bash
# Combiner avec analyse de fichier
cat src/components/UserProfile.tsx
/multi-role frontend,mobile
"Évaluez ce composant sous multiples perspectives"
# Évaluer documents de conception
cat architecture-design.md
/multi-role architect,security,performance
"Évaluez cette conception à travers multiples spécialités"
# Analyse d'erreur
cat performance-issues.log
/multi-role performance,analyzer
"Analysez les problèmes de performance sous multiples angles"
```
### Choisir entre multi-role et role-debate
### Quand utiliser multi-role
- Vous voulez des évaluations indépendantes de chaque spécialité
- Vous voulez créer un plan d'amélioration intégré
- Vous voulez organiser les contradictions et chevauchements
- Vous voulez déterminer les priorités d'implémentation
### Quand utiliser role-debate
- Il y a des compromis entre spécialités
- Les opinions pourraient différer sur la sélection de technologie
- Vous voulez décider les politiques de conception par discussion
- Vous voulez entendre des débats de différentes perspectives
### Exécution parallèle de sous-agents (--agent)
L'utilisation de l'option `--agent` exécute chaque rôle en tant que sous-agent indépendant en parallèle.
#### Promotion de délégation automatique
Si les descriptions de fichier de rôle incluent des phrases comme celles-ci, une délégation automatique plus proactive est activée lors de l'utilisation de `--agent` :
- "utiliser PROACTIVEMENT"
- "DOIT ÊTRE UTILISÉ"
- Autres expressions d'emphase
#### Flux d'exécution
```text
Exécution normale :
Rôle 1 → Rôle 2 → Rôle 3 → Intégration
(Exécution séquentielle, approx. 3-5 minutes)
Exécution --agent :
Rôle 1 ─┐
Rôle 2 ─┼→ Intégration
Rôle 3 ─┘
(Exécution parallèle, approx. 1-2 minutes)
```
#### Exemples d'usage efficaces
```bash
# Évaluation exhaustive de système à grande échelle
/multi-role architect,security,performance,qa --agent
"Évaluation exhaustive du nouveau système"
# Analyse détaillée sous multiples perspectives
/multi-role frontend,mobile,performance --agent
"Analyse complète d'optimisation UX écran"
```
#### Comparaison de performance
| Nombre de rôles | Exécution normale | Exécution --agent | Taux de réduction |
| --------------- | ----------------- | ----------------- | ----------------- |
| 2 rôles | 2-3 minutes | 1 minute | 50% |
| 3 rôles | 3-5 minutes | 1-2 minutes | 60% |
| 4 rôles | 5-8 minutes | 2-3 minutes | 65% |
### Remarques
- L'exécution simultanée de 3 rôles ou plus résulte en une sortie plus longue
- Les analyses complexes peuvent prendre plus de temps à exécuter
- Si des recommandations contradictoires surviennent, considérez l'utilisation de role-debate
- Les jugements finaux doivent être faits par l'utilisateur en référence aux résultats intégrés
- **Lors de l'utilisation de --agent** : Consomme plus de ressources mais est efficace pour les analyses à grande échelle
### Détails de Configuration des Rôles
- Les paramètres détaillés, l'expertise et les caractéristiques de discussion de chaque rôle sont définis dans `.claude/agents/roles/`
- Inclut les pratiques Evidence-First et les contre-mesures aux biais cognitifs
- Les phrases déclencheuses propres à chaque rôle activent automatiquement le mode spécialisé