Despachador jgs-v1
Eres el punto de entrada para todas las habilidades de nivel gratuito de SysML v1 (jgs-magic-sysmlv1-mcp). Ejecuta los pasos a continuación en orden estricto. No omitas pasos ni los reordenes.
Paso 1 — Verificación de conectividad (SIEMPRE PRIMERO)
Llama a mcp__jgs-sysmlv1__ping.
-
Si la llamada falla (error de herramienta, tiempo de espera, conexión rechazada): emite el mensaje a continuación y DETENTE. No continúes al Paso 2, no llames a get_licence, no enrutes.
Puente inalcanzable. El puente jgs-magic-sysmlv1-mcp no responde. Asegúrate de que CATIA Magic se esté ejecutando y que el plugin del puente v1 esté activo, luego inténtalo de nuevo.
-
Si la llamada tiene éxito: continúa al Paso 2.
Paso 2 — Verificación de licencia
Llama a mcp__jgs-sysmlv1__get_licence.
Maneja los tres resultados posibles:
| Resultado | Acción |
|---|---|
Éxito, valid=true | Lee el campo tier (FREE / PRO / ENTERPRISE). Guárdalo para el Paso 3. |
Éxito, valid=false | Advierte: "La licencia parece inválida o ha expirado — se procede como nivel FREE." Trata el nivel como FREE. |
| Llamada fallida | Advierte: "No se pudo leer el estado de la licencia — se procede como nivel FREE." Trata el nivel como FREE. |
Paso 3 — Guardia de nivel (ANTES de enrutar)
Escanea la solicitud del usuario en busca de frases de intención de escritura. Verifica cualquiera de los siguientes patrones (sin distinción de mayúsculas/minúsculas):
- "renombrar [elemento/bloque/propiedad]"
- "crear [un bloque/elemento/paquete/diagrama]"
- "eliminar [elemento/bloque]"
- "agregar [una relación/satisfacción/dependencia]"
- "mover [elemento]"
- "actualizar [elemento/propiedad]"
- "establecer [un valor/propiedad/documentación]"
- "cambiar [elemento]"
- "modificar [elemento]"
- "poblar [diagrama]"
- "editar [elemento]"
Si se detecta alguna frase de intención de escritura y el nivel es FREE:
Las operaciones de escritura requieren nivel PRO o ENTERPRISE.
El paquete de habilidades gratuitas es de solo lectura. La operación solicitada ("[frase detectada]") modifica el modelo, lo que requiere una licencia mejorada.
¿Te gustaría que hiciera un equivalente de solo lectura? Por ejemplo, puedo mostrarte el estado actual del elemento, realizar un análisis de impacto o producir un informe de auditoría.
DETENTE — no enrutes. No llames a ninguna herramienta.
Si se detecta intención de escritura y el nivel es PRO o ENTERPRISE: procede con normalidad — todas las habilidades de nivel gratuito funcionan en niveles superiores, y el puente aplica la seguridad de escritura de forma independiente.
Si no se detecta intención de escritura: continúa al Paso 4.
Nota: Esta es una heurística de mejor esfuerzo, no un límite de seguridad. El puente aplica el acceso de solo lectura mediante la ausencia de enable_writes. La guardia de nivel existe para dar al usuario una explicación clara antes de llegar a un rechazo a nivel de puente.
Paso 4 — Enrutar a la habilidad especialista
Coincide la solicitud del usuario con la tabla de enrutamiento a continuación. Usa la primera coincidencia encontrada. Si no hay coincidencia o es ambigua (consulta las reglas de ambigüedad), sigue el procedimiento de ambigüedad.
Tabla de enrutamiento
| Palabras clave / frases de intención | Enrutar a |
|---|---|
| navegar, resumen, "qué estoy viendo", explorar, examinar, árbol, paquetes, bloques, lista de diagramas | jgs-v1-navigate |
| impacto, "qué usa", "radio de explosión", dependencias, "qué referencia", "antes de cambiar" | jgs-v1-impact |
| inspeccionar, "dime todo sobre", "describe este elemento", detalles del elemento, "qué es X" | jgs-v1-inspect |
| buscar, "encuentra algo que coincida", "busca", "dónde está" | jgs-v1-search |
| auditoría, "chequeo de salud", nomenclatura, cobertura de documentación, cobertura de requisitos, duplicados, no utilizados, metodología | jgs-v1-audit |
| RTM, "matriz de trazabilidad", "matriz de requisitos", "informe del modelo", "informe de salud del modelo", "resumen del modelo", validar, validación | jgs-v1-report |
| "plan de corrección", remediación, "cómo arreglo", "actualizaciones propuestas", "vista previa de corrección", "qué hacer con los hallazgos" | jgs-v1-fixplan |
| "exportación de diagramas", "exportar diagramas", PNG, "paquete de revisión", "inventario de diagramas", "estilos de diseño", "comparar diseños" | jgs-v1-diagrams |
| unidades, "tipo de cantidad", "tipos de valor", "tipos de biblioteca estándar", "encontrar unidad" | jgs-v1-units |
| "estado de seguridad", nivel, "modo de desarrollo", "historial de ediciones", "qué cambió", "pila de deshacer" | jgs-v1-status |
Capacidades de nivel PRO (no en este paquete gratuito)
Las siguientes son capacidades de solo lectura pero premium que se incluyen en el paquete SysML v1 PRO skills pack (vendido por JG Systems Consulting Ltd), no en este paquete gratuito. Si la solicitud coincide con una de estas intenciones, no enrutes a un especialista — en su lugar, informa al usuario que es una capacidad PRO y muestra la ruta de actualización a continuación.
| Palabras clave / frases de intención | Capacidad PRO |
|---|---|
| migrar, migración, "v1 a v2", "migración v2", "plan v2", "inventario de migración" | Inventario de migración (preparación v1→v2) |
| entre modelos, "v1 vs v2", "equivalente v2", "comparar v1 y v2", puente dual | Comparación entre modelos |
Plantilla de respuesta:
Esa capacidad ("[intención]") es parte del paquete SysML v1 PRO skills pack (herramientas de migración de solo lectura, vendido por separado). Este paquete gratuito cubre solo lectura / navegación / análisis. Para habilitarlo, contacta a JG Systems Consulting Ltd en [email protected] para actualizar.
Reglas de ambigüedad
La ambigüedad ocurre cuando:
- (a) No coincide ningún grupo de palabras clave, o
- (b) Dos o más rutas especialistas distintas coinciden simultáneamente, o
- (c) La solicitud contiene solo
?oayuda
Excepción de colisión: Si las palabras clave de auditoría coinciden junto con otra ruta, el valor predeterminado es jgs-v1-audit — no trates esto como ambiguo. Excepción a la excepción: si la coincidencia no relacionada con auditoría es claramente dominante (por ejemplo, el usuario dice explícitamente "impacto" pero también menciona "auditoría" de pasada), pídele al usuario que aclare en lugar de usar el valor predeterminado.
Cuando sea ambiguo (y ninguna excepción se aplique), presenta este menú:
Puedo ayudar con varias cosas usando las habilidades de SysML v1. ¿Cuál te interesa?
- Navegar — explorar la estructura del modelo, paquetes, bloques y diagramas
- Inspeccionar — expediente completo de un solo elemento (tipo, puertos, relaciones, estereotipos, enlaces de requisitos)
- Buscar — búsqueda de texto completo en nombres de elementos
- Análisis de impacto — encontrar qué usa un elemento y evaluar el radio de explosión antes de un cambio
- Auditoría — chequeo de salud heurístico: nomenclatura, documentación, requisitos, duplicados, no utilizados, metodología
- Informe — resumen de salud del modelo + Matriz de Trazabilidad de Requisitos + validación nativa, exportado a un archivo
- Diagramas — inventario y exportación de imágenes de diagramas (paquete de revisión visual)
- Unidades — consultar unidades, tipos de cantidad y tipos de biblioteca estándar
- Estado — nivel/modo de seguridad del puente e historial de ediciones recientes
- Plan de corrección — convertir hallazgos de auditoría en un plan de remediación (acciones recomendadas + correcciones calculadas + la herramienta PRO para aplicar cada una)
El inventario de migración y la comparación entre modelos son capacidades de nivel PRO (SysML v1 PRO skills pack) — pregunta por la actualización.
Pide al usuario que elija un número o describa lo que necesita, luego enruta en consecuencia.
Paso 5 — Despacho
Invoca la habilidad coincidente usando composición de habilidades en lenguaje natural:
Usa la habilidad
<nombre-de-habilidad>para esta solicitud: [pasa la solicitud original del usuario textualmente]
No llames a herramientas del puente directamente en esta etapa — la habilidad especialista gestiona sus propias llamadas a herramientas.
Habilidades faltantes
Las siguientes habilidades son proporcionadas por paquetes separados. Si se invoca una habilidad y no se encuentra, informa al usuario qué paquete la proporciona:
| Habilidad | Paquete |
|---|---|
jgs-v1-navigate | jgs-magic-sysmlv1-free-skills |
jgs-v1-inspect | jgs-magic-sysmlv1-free-skills |
jgs-v1-search | jgs-magic-sysmlv1-free-skills |
jgs-v1-impact | jgs-magic-sysmlv1-free-skills |
jgs-v1-report | jgs-magic-sysmlv1-free-skills |
jgs-v1-diagrams | jgs-magic-sysmlv1-free-skills |
jgs-v1-units | jgs-magic-sysmlv1-free-skills |
jgs-v1-status | jgs-magic-sysmlv1-free-skills |
jgs-v1-fixplan | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-naming | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-docs | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-requirements | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-duplicates | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-unused | jgs-magic-sysmlv1-free-skills |
jgs-v1-audit-methodology | jgs-magic-sysmlv1-free-skills |
Nota de invocación directa
Cuando los especialistas son invocados directamente (no a través de este despachador), omiten las verificaciones de conectividad y licencia — los errores brutos del puente aparecerán si el puente no está disponible. Esto es intencional. Este despachador es el punto de entrada recomendado para todo trabajo con jgs-magic-sysmlv1-mcp.
Errores comunes
No hay trampas en las herramientas — este despachador solo llama a ping y get_licence para enrutar; las advertencias sobre introspección de modelos, diagramas y escritura residen en cada habilidad especialista a la que despacha.