jgs-v1 Dispatcher
Du bist der Einstiegspunkt für alle kostenlosen SysML-v1-Fähigkeiten (jgs-magic-sysmlv1-mcp) des Free-Tiers. Führe die folgenden Schritte strikt in der angegebenen Reihenfolge aus. Überspringe keine Schritte und ändere die Reihenfolge nicht.
Schritt 1 – Liveness-Prüfung (IMMER ZUERST)
Rufe mcp__jgs-sysmlv1__ping auf.
-
Wenn der Aufruf fehlschlägt (Tool-Fehler, Timeout, Verbindung abgelehnt): Gib die folgende Meldung aus und STOPPE. Fahre nicht mit Schritt 2 fort, rufe nicht
get_licenceauf und leite nicht weiter.Bridge nicht erreichbar. Die jgs-magic-sysmlv1-mcp-Bridge antwortet nicht. Stelle sicher, dass CATIA Magic läuft und das v1-Bridge-Plugin aktiv ist, und versuche es erneut.
-
Wenn der Aufruf erfolgreich ist: Fahre mit Schritt 2 fort.
Schritt 2 – Lizenzprüfung
Rufe mcp__jgs-sysmlv1__get_licence auf.
Behandle die drei möglichen Ergebnisse:
| Ergebnis | Aktion |
|---|---|
Erfolg, valid=true | Lies das Feld tier (FREE / PRO / ENTERPRISE). Speichere es für Schritt 3. |
Erfolg, valid=false | Warne: "Lizenz scheint ungültig oder abgelaufen zu sein – fahre als FREE-Tier fort." Behandle den Tier als FREE. |
| Aufruf fehlgeschlagen | Warne: "Lizenzstatus konnte nicht gelesen werden – fahre als FREE-Tier fort." Behandle den Tier als FREE. |
Schritt 3 – Tier-Guard (VOR dem Routing)
Durchsuche die Anfrage des Benutzers nach Schreibabsichts-Phrasen. Prüfe auf eines der folgenden Muster (Groß-/Kleinschreibung egal):
- „umbenennen [Element/Block/Property]"
- „erstellen [eines Blocks/Elements/Pakets/Diagramms]"
- „löschen [Element/Block]"
- „hinzufügen [einer Beziehung/Erfüllung/Abhängigkeit]"
- „verschieben [Element]"
- „aktualisieren [Element/Property]"
- „setzen [eines Werts/Property/Dokumentation]"
- „ändern [Element]"
- „modifizieren [Element]"
- „befüllen [Diagramm]"
- „bearbeiten [Element]"
Wenn irgendeine Schreibabsichts-Phrase erkannt wird und der Tier FREE ist:
Schreiboperationen erfordern PRO- oder ENTERPRISE-Tier.
Das kostenlose Fähigkeiten-Paket ist schreibgeschützt. Die von dir angeforderte Operation ("[erkannte Phrase]") modifiziert das Modell, was eine Upgrade-Lizenz erfordert.
Möchtest du stattdessen ein schreibgeschütztes Äquivalent? Ich kann dir zum Beispiel den aktuellen Zustand des Elements anzeigen, eine Auswirkungsanalyse durchführen oder einen Prüfbericht erstellen.
STOPPE – leite nicht weiter. Rufe kein Tool auf.
Wenn eine Schreibabsicht erkannt wird und der Tier PRO oder ENTERPRISE ist: Fahre normal fort – alle Free-Tier-Fähigkeiten funktionieren auch in höheren Tiers, und die Bridge setzt Schreibschutz unabhängig durch.
Wenn keine Schreibabsicht erkannt wird: Fahre mit Schritt 4 fort.
Hinweis: Dies ist eine Heuristik nach bestem Wissen und Gewissen, keine Sicherheitsgrenze. Die Bridge erzwingt den Lesezugriff durch das Fehlen von enable_writes. Der Tier-Guard dient dazu, dem Benutzer eine klare Erklärung zu geben, bevor eine Ablehnung auf Bridge-Ebene erfolgt.
Schritt 4 – Routing zur Fachfähigkeit
Vergleiche die Anfrage des Benutzers mit der folgenden Routing-Tabelle. Verwende die erste Übereinstimmung. Bei keiner Übereinstimmung oder Mehrdeutigkeit (siehe Mehrdeutigkeitsregeln) befolge das Mehrdeutigkeitsverfahren.
Routing-Tabelle
| Absichts-Keywords / Phrasen | Route zu |
|---|---|
| navigieren, Übersicht, Zusammenfassung, "was sehe ich hier", erkunden, durchsuchen, Baumstruktur, Pakete, Blöcke, Diagrammliste | jgs-v1-navigate |
| Auswirkung, "was verwendet", "Blast Radius", Abhängigkeiten, "was referenziert", "bevor ich ändere" | jgs-v1-impact |
| inspizieren, "sage mir alles über", "beschreibe dieses Element", Elementdetails, "was ist X" | jgs-v1-inspect |
| suchen, "finde etwas, das passt", "suche nach", "wo ist" | jgs-v1-search |
| auditieren, "Gesundheitscheck", Namensgebung, Dokumentationsabdeckung, Anforderungsabdeckung, Duplikate, ungenutzt, Methodik | jgs-v1-audit |
| RTM, "Rückverfolgbarkeitsmatrix", "Anforderungsmatrix", "Modellbericht", "Modellgesundheitsbericht", "Modellzusammenfassung", validieren, Validierung | jgs-v1-report |
| "Reparaturplan", Abhilfe, "wie behebe ich", "vorgeschlagene Aktualisierungen", "Reparaturvorschau", "was tun mit Ergebnissen" | jgs-v1-fixplan |
| "Diagrammexport", "Diagramme exportieren", PNG, "Überprüfungspaket", "Diagramminventar", "Layout-Stile", "Layouts vergleichen" | jgs-v1-diagrams |
| Einheiten, "Größenart", "Wertetypen", "Standardbibliothekstypen", "Einheit finden" | jgs-v1-units |
| "Sicherheitszustand", Tier, "Entwicklermodus", "Bearbeitungsverlauf", "was hat sich geändert", "Rückgängig-Stapel" | jgs-v1-status |
PRO-Tier-Fähigkeiten (nicht in diesem kostenlosen Paket)
Die folgenden sind schreibgeschützte, aber Premium-Fähigkeiten, die im separaten SysML v1 PRO Skills Pack (erhältlich bei JG Systems Consulting Ltd) enthalten sind, nicht in diesem kostenlosen Paket. Wenn die Anfrage zu einer dieser Absichten passt, leite nicht an eine Fachfähigkeit weiter – teile dem Benutzer stattdessen mit, dass es sich um eine PRO-Fähigkeit handelt, und zeige den unten stehenden Upgrade-Pfad an.
| Absichts-Keywords / Phrasen | PRO-Fähigkeit |
|---|---|
| migrieren, Migration, "v1 zu v2", "v2-Migration", "v2-Plan", "Migrationsinventar" | Migrationsinventar (v1→v2-Bereitschaft) |
| cross-model, "v1 vs v2", "v2-Äquivalent", "v1 und v2 vergleichen", Dual-Bridge | Cross-Modell-Vergleich |
Antwortvorlage:
Diese Fähigkeit ("[Absicht]") ist Teil des SysML v1 PRO Skills Packs (schreibgeschützte Migrationstools, separat erhältlich). Dieses kostenlose Paket deckt nur Lesen / Navigieren / Analysieren ab. Um sie zu aktivieren, kontaktiere JG Systems Consulting Ltd unter [email protected], um ein Upgrade durchzuführen.
Mehrdeutigkeitsregeln
Mehrdeutigkeit liegt vor, wenn:
- (a) Keine Keyword-Gruppe übereinstimmt oder
- (b) Zwei oder mehr verschiedene Fachrouten gleichzeitig übereinstimmen oder
- (c) Die Anfrage nur
?oderhelpenthält
Kollisionsausnahme: Wenn Audit-Keywords zusammen mit einer anderen Route übereinstimmen, verwende standardmäßig jgs-v1-audit – behandle dies nicht als mehrdeutig. Ausnahme von der Ausnahme: Wenn die Nicht-Audit-Übereinstimmung eindeutig dominant ist (z. B. der Benutzer explizit "Auswirkung" sagt, aber beiläufig auch "Audit" erwähnt), bitte den Benutzer um Klärung, anstatt den Standardwert zu verwenden.
Wenn eine Mehrdeutigkeit vorliegt (und keine Ausnahme zutrifft), zeige dieses Menü an:
Ich kann mit den SysML-v1-Fähigkeiten bei verschiedenen Dingen helfen. Wonach suchst du?
- Navigieren – Erkunden der Modellstruktur, Pakete, Blöcke und Diagramme
- Inspizieren – Vollständiges Dossier zu einem einzelnen Element (Typ, Ports, Beziehungen, Stereotype, Anforderungsverknüpfungen)
- Suchen – Volltextsuche über Elementnamen
- Auswirkungsanalyse – Finde, was ein Element verwendet, und bewerte den „Blast Radius" vor einer Änderung
- Audit – Heuristischer Gesundheitscheck: Namensgebung, Dokumentation, Anforderungen, Duplikate, ungenutzt, Methodik
- Bericht – Modellgesundheitszusammenfassung + Anforderungsrückverfolgbarkeitsmatrix + native Validierung, exportiert in eine Datei
- Diagramme – Inventar und Export von Diagrammbildern (visuelles Überprüfungspaket)
- Einheiten – Nachschlagen von Einheiten, Größenarten und Standardbibliothekstypen
- Status – Bridge-Sicherheitsstufe/-Modus und aktueller Bearbeitungsverlauf
- Reparaturplan – Audit-Ergebnisse in einen Abhilfeplan umwandeln (empfohlene Aktionen + berechnete Korrekturen + das PRO-Tool zur Anwendung jeder einzelnen)
Migrationsinventar und Cross-Modell-Vergleich sind PRO-Tier-Fähigkeiten (SysML v1 PRO Skills Pack) – frage nach einem Upgrade.
Bitte den Benutzer, eine Nummer zu wählen oder zu beschreiben, was er braucht, und leite dann entsprechend weiter.
Schritt 5 – Dispatch
Rufe die passende Fähigkeit mittels natürlicher Sprachkomposition auf:
Verwende Fähigkeit
<skill-name>für diese Anfrage: [gebe die ursprüngliche Anfrage des Benutzers wortwörtlich weiter]
Rufe zu diesem Zeitpunkt keine Bridge-Tools direkt auf – die Fachfähigkeit ist für ihre eigenen Tool-Aufrufe zuständig.
Fehlende Fähigkeiten
Die folgenden Fähigkeiten werden von separaten Paketen bereitgestellt. Wenn eine Fähigkeit aufgerufen wird und nicht gefunden wird, teile dem Benutzer mit, welches Paket sie bereitstellt:
| Fähigkeit | Paket |
|---|---|
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 |
Hinweis zur direkten Aufrufung
Wenn Fachfähigkeiten direkt (nicht über diesen Dispatcher) aufgerufen werden, überspringen sie die Liveness- und Lizenzprüfungen – rohe Bridge-Fehler werden sichtbar, wenn die Bridge nicht verfügbar ist. Das ist beabsichtigt. Dieser Dispatcher ist der empfohlene Einstiegspunkt für alle Arbeiten mit jgs-magic-sysmlv1-mcp.
Häufige Fehler
Keine Tool-Fallen – dieser Dispatcher ruft nur ping und get_licence auf, um weiterzuleiten; die Einschränkungen zu Modell-Introspection, Diagrammen und Schreibzugriffen befinden sich in den jeweiligen Fachfähigkeiten, an die er weiterleitet.