Initial commit
This commit is contained in:
Zhongwei Li
314
commands/multi-role.md
Normal file
314
commands/multi-role.md
Normal file
@@ -0,0 +1,314 @@
|
||||
## Multi Role
|
||||
|
||||
Un comando que analiza el mismo objetivo en paralelo con múltiples roles y genera un reporte integrado.
|
||||
|
||||
### Uso
|
||||
|
||||
```bash
|
||||
/multi-role <rol1>,<rol2> [--agent|-a] [objetivo_análisis]
|
||||
/multi-role <rol1>,<rol2>,<rol3> [--agent|-a] [objetivo_análisis]
|
||||
```
|
||||
|
||||
### Roles Disponibles
|
||||
|
||||
#### Roles de Análisis Especializado
|
||||
|
||||
- `security`: Experto en auditoría de seguridad
|
||||
- `performance`: Experto en optimización de rendimiento
|
||||
- `analyzer`: Experto en análisis de causa raíz
|
||||
- `frontend`: Experto en frontend y UI/UX
|
||||
- `mobile`: Experto en desarrollo móvil
|
||||
- `backend`: Experto en backend y servidor
|
||||
|
||||
#### Roles de Soporte de Desarrollo
|
||||
|
||||
- `reviewer`: Experto en revisión de código
|
||||
- `architect`: Arquitecto de sistemas
|
||||
- `qa`: Ingeniero de pruebas
|
||||
|
||||
**Importante**:
|
||||
|
||||
- Coloca la opción `--agent` inmediatamente después de especificar los roles
|
||||
- Escribe tu mensaje después de `--agent`
|
||||
- Ejemplo correcto: `/multi-role qa,architect --agent Evaluar el plan`
|
||||
- Ejemplo incorrecto: `/multi-role qa,architect Evaluar el plan --agent`
|
||||
|
||||
### Opciones
|
||||
|
||||
- `--agent` o `-a`: Ejecutar cada rol como sub-agente en paralelo (recomendado para análisis a gran escala)
|
||||
- Al usar esta opción, si las descripciones de roles incluyen frases de delegación proactiva (como "usar PROACTIVAMENTE"), se habilita una delegación automática más agresiva
|
||||
|
||||
### Ejemplos Básicos
|
||||
|
||||
```bash
|
||||
# Análisis dual de seguridad y rendimiento (normal)
|
||||
/multi-role security,performance
|
||||
"Evaluar este endpoint de API"
|
||||
|
||||
# Análisis paralelo de sistema a gran escala (sub-agentes)
|
||||
/multi-role security,performance --agent
|
||||
"Analizar comprensivamente seguridad y rendimiento del sistema"
|
||||
|
||||
# Análisis integrado de frontend, mobile y rendimiento
|
||||
/multi-role frontend,mobile,performance
|
||||
"Considerar propuestas de optimización para esta pantalla"
|
||||
|
||||
# Evaluación multifacética de diseño de arquitectura (sub-agentes)
|
||||
/multi-role architect,security,performance --agent
|
||||
"Evaluar diseño de microservicios"
|
||||
```
|
||||
|
||||
### Proceso de Análisis
|
||||
|
||||
### Fase 1: Análisis Paralelo
|
||||
|
||||
Cada rol analiza independientemente el mismo objetivo
|
||||
|
||||
- Realizar evaluación desde perspectiva especializada
|
||||
- Hacer juicios basados en criterios específicos del rol
|
||||
- Generar recomendaciones independientes
|
||||
|
||||
### Fase 2: Análisis Integrado
|
||||
|
||||
Estructurar e integrar resultados
|
||||
|
||||
- Organizar resultados de evaluación de cada rol
|
||||
- Identificar solapamientos y contradicciones
|
||||
- Aclarar relaciones complementarias
|
||||
|
||||
### Fase 3: Reporte Integrado
|
||||
|
||||
Generar recomendaciones finales
|
||||
|
||||
- Plan de acción priorizado
|
||||
- Trade-offs explícitos
|
||||
- Hoja de ruta de implementación
|
||||
|
||||
### Ejemplos de Formato de Salida
|
||||
|
||||
### Para Análisis de 2 Roles
|
||||
|
||||
```text
|
||||
Análisis Multi-role: Security + Performance
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
Objetivo de Análisis: Endpoint API /api/users
|
||||
|
||||
Resultados de Análisis de Seguridad:
|
||||
Autenticación: Verificación JWT implementada correctamente
|
||||
Autorización: Control de acceso basado en roles incompleto
|
||||
Cifrado: Claves API registradas en texto plano
|
||||
|
||||
Puntuación de Evaluación: 65/100
|
||||
Importancia: Alta (debido al acceso a datos sensibles)
|
||||
|
||||
Resultados de Análisis de Rendimiento:
|
||||
Tiempo de Respuesta: Promedio 180ms (dentro del objetivo de 200ms)
|
||||
Consultas de Base de Datos: Problema N+1 detectado
|
||||
Caché: Caché Redis no implementado
|
||||
|
||||
Puntuación de Evaluación: 70/100
|
||||
Importancia: Media (actualmente dentro del rango aceptable)
|
||||
|
||||
Análisis Interrelacionado:
|
||||
Oportunidades Sinérgicas:
|
||||
- Considerar cifrado al implementar caché Redis
|
||||
- Mejorar logging para ganancias tanto de seguridad como rendimiento
|
||||
|
||||
Puntos de Trade-off:
|
||||
- Fortalecimiento de verificación de autorización ↔ Impacto en tiempo de respuesta
|
||||
- Cifrado de logs ↔ Eficiencia de debugging reducida
|
||||
|
||||
Prioridades Integradas:
|
||||
Crítico: Arreglar salida de clave API en texto plano
|
||||
Alto: Resolver consultas N+1
|
||||
Medio: Implementar caché Redis + cifrado
|
||||
Bajo: Refinar control de autorización
|
||||
|
||||
Hoja de Ruta de Implementación:
|
||||
Semana 1: Implementar enmascarado de clave API
|
||||
Semana 2: Optimización de consultas de base de datos
|
||||
Semanas 3-4: Diseño e implementación de capa de caché
|
||||
Mes 2: Fortalecimiento progresivo del control de autorización
|
||||
```
|
||||
|
||||
### Para Análisis de 3 Roles
|
||||
|
||||
```text
|
||||
Análisis Multi-role: Frontend + Mobile + Performance
|
||||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
|
||||
Objetivo de Análisis: Pantalla de Perfil de Usuario
|
||||
|
||||
Resultados de Análisis Frontend:
|
||||
Usabilidad: Layout intuitivo
|
||||
Accesibilidad: 85% de cumplimiento WCAG 2.1
|
||||
Responsive: Problemas con visualización en tablet
|
||||
|
||||
Resultados de Análisis Mobile:
|
||||
Touch Targets: 44pt+ asegurado
|
||||
Operación con Una Mano: Botones importantes colocados en la parte superior
|
||||
Soporte Offline: No implementado
|
||||
|
||||
Resultados de Análisis de Rendimiento:
|
||||
Visualización Inicial: LCP 2.1s (bueno)
|
||||
Optimización de Imágenes: WebP no soportado
|
||||
Lazy Loading: No implementado
|
||||
|
||||
Recomendaciones Integradas:
|
||||
1. Optimización móvil (operación con una mano + soporte offline)
|
||||
2. Optimización de imágenes (WebP + lazy loading)
|
||||
3. Mejoras de UI para tablet
|
||||
|
||||
Prioridad: Mobile > Performance > Frontend
|
||||
Período de Implementación: 3-4 semanas
|
||||
```
|
||||
|
||||
### Patrones de Combinación Efectivos
|
||||
|
||||
### Enfocado en Seguridad
|
||||
|
||||
```bash
|
||||
/multi-role security,architect
|
||||
"Diseño de sistema de autenticación"
|
||||
|
||||
/multi-role security,frontend
|
||||
"Seguridad de pantalla de login"
|
||||
|
||||
/multi-role security,mobile
|
||||
"Protección de datos de app móvil"
|
||||
```
|
||||
|
||||
### Enfocado en Rendimiento
|
||||
|
||||
```bash
|
||||
/multi-role performance,architect
|
||||
"Diseño de escalabilidad"
|
||||
|
||||
/multi-role performance,frontend
|
||||
"Optimización de velocidad de página web"
|
||||
|
||||
/multi-role performance,mobile
|
||||
"Optimización de rendimiento de app"
|
||||
```
|
||||
|
||||
### Enfocado en Experiencia de Usuario
|
||||
|
||||
```bash
|
||||
/multi-role frontend,mobile
|
||||
"UI cross-platform"
|
||||
|
||||
/multi-role frontend,performance
|
||||
"Balance entre UX y rendimiento"
|
||||
|
||||
/multi-role mobile,performance
|
||||
"Optimización de UX móvil"
|
||||
```
|
||||
|
||||
### Análisis Comprensivo
|
||||
|
||||
```bash
|
||||
/multi-role architect,security,performance
|
||||
"Evaluación general del sistema"
|
||||
|
||||
/multi-role frontend,mobile,performance
|
||||
"Evaluación comprensiva de experiencia de usuario"
|
||||
|
||||
/multi-role security,performance,mobile
|
||||
"Diagnóstico comprensivo de app móvil"
|
||||
```
|
||||
|
||||
### Colaboración con Claude
|
||||
|
||||
```bash
|
||||
# Combinar con análisis de archivo
|
||||
cat src/components/UserProfile.tsx
|
||||
/multi-role frontend,mobile
|
||||
"Evaluar este componente desde múltiples perspectivas"
|
||||
|
||||
# Evaluar documentos de diseño
|
||||
cat architecture-design.md
|
||||
/multi-role architect,security,performance
|
||||
"Evaluar este diseño a través de múltiples especialidades"
|
||||
|
||||
# Análisis de errores
|
||||
cat performance-issues.log
|
||||
/multi-role performance,analyzer
|
||||
"Analizar problemas de rendimiento desde múltiples ángulos"
|
||||
```
|
||||
|
||||
### Eligiendo entre multi-role y role-debate
|
||||
|
||||
### Cuándo usar multi-role
|
||||
|
||||
- Quieres evaluaciones independientes de cada especialidad
|
||||
- Quieres crear un plan de mejora integrado
|
||||
- Quieres organizar contradicciones y solapamientos
|
||||
- Quieres determinar prioridades de implementación
|
||||
|
||||
### Cuándo usar role-debate
|
||||
|
||||
- Hay trade-offs entre especialidades
|
||||
- Las opiniones podrían diferir en la selección de tecnología
|
||||
- Quieres decidir políticas de diseño a través de discusión
|
||||
- Quieres escuchar debates desde diferentes perspectivas
|
||||
|
||||
### Ejecución Paralela de Sub-agentes (--agent)
|
||||
|
||||
Usar la opción `--agent` ejecuta cada rol como un sub-agente independiente en paralelo.
|
||||
|
||||
#### Promoviendo Delegación Automática
|
||||
|
||||
Si las descripciones de archivos de rol incluyen frases como estas, se habilita una delegación automática más proactiva al usar `--agent`:
|
||||
|
||||
- "usar PROACTIVAMENTE"
|
||||
- "DEBE SER USADO"
|
||||
- Otras expresiones de énfasis
|
||||
|
||||
#### Flujo de Ejecución
|
||||
|
||||
```text
|
||||
Ejecución normal:
|
||||
Rol 1 → Rol 2 → Rol 3 → Integración
|
||||
(Ejecución secuencial, aprox. 3-5 minutos)
|
||||
|
||||
Ejecución --agent:
|
||||
Rol 1 ─┐
|
||||
Rol 2 ─┼→ Integración
|
||||
Rol 3 ─┘
|
||||
(Ejecución paralela, aprox. 1-2 minutos)
|
||||
```
|
||||
|
||||
#### Ejemplos de Uso Efectivo
|
||||
|
||||
```bash
|
||||
# Evaluación comprensiva de sistema a gran escala
|
||||
/multi-role architect,security,performance,qa --agent
|
||||
"Evaluación comprensiva de nuevo sistema"
|
||||
|
||||
# Análisis detallado desde múltiples perspectivas
|
||||
/multi-role frontend,mobile,performance --agent
|
||||
"Análisis completo de optimización UX de pantalla"
|
||||
```
|
||||
|
||||
#### Comparación de Rendimiento
|
||||
|
||||
| Número de Roles | Ejecución Normal | Ejecución --agent | Tasa de Reducción |
|
||||
| --------------- | ---------------- | ----------------- | ----------------- |
|
||||
| 2 roles | 2-3 minutos | 1 minuto | 50% |
|
||||
| 3 roles | 3-5 minutos | 1-2 minutos | 60% |
|
||||
| 4 roles | 5-8 minutos | 2-3 minutos | 65% |
|
||||
|
||||
### Notas
|
||||
|
||||
- Ejecutar 3 o más roles simultáneamente resulta en salida más larga
|
||||
- Los análisis complejos pueden tomar más tiempo para ejecutarse
|
||||
- Si surgen recomendaciones conflictivas, considera usar role-debate
|
||||
- Los juicios finales deben ser hechos por el usuario con referencia a resultados integrados
|
||||
- **Al usar --agent**: Consume más recursos pero es eficiente para análisis a gran escala
|
||||
|
||||
### Detalles de Configuración de Roles
|
||||
|
||||
- La configuración detallada, el conocimiento especializado y las características de discusión de cada rol se definen en `.claude/agents/roles/`
|
||||
- Incluye prácticas Evidence-First y medidas contra los sesgos cognitivos
|
||||
- Las frases disparadoras específicas de cada rol activan automáticamente el modo especializado
|
||||
Reference in New Issue
Block a user