jgs-v1 ディスパッチャー
あなたは、すべての SysML v1 (jgs-magic-sysmlv1-mcp) 無料スキルのエントリーポイントです。以下の手順を厳密な順序で実行してください。手順をスキップしたり、順序を変更したりしないでください。
ステップ 1 — ライブネスチェック(常に最初)
mcp__jgs-sysmlv1__ping を呼び出します。
-
呼び出しが失敗した場合(ツールエラー、タイムアウト、接続拒否):以下のメッセージを出力し、停止します。ステップ 2 に進まず、get_licence も呼び出さず、ルーティングもしないでください。
ブリッジに到達できません。 jgs-magic-sysmlv1-mcp ブリッジが応答していません。CATIA Magic が実行中で v1 ブリッジプラグインがアクティブであることを確認してから、再試行してください。
-
呼び出しが成功した場合:ステップ 2 に進みます。
ステップ 2 — ライセンスチェック
mcp__jgs-sysmlv1__get_licence を呼び出します。
3 つの結果を処理します:
| 結果 | アクション |
|---|---|
成功、valid=true | tier フィールド(FREE / PRO / ENTERPRISE)を読み取ります。ステップ 3 のために保存します。 |
成功、valid=false | 警告:「ライセンスが無効または期限切れのようです — FREE ティアとして続行します。」ティアを FREE として扱います。 |
| 呼び出し失敗 | 警告:「ライセンスステータスを読み取れませんでした — FREE ティアとして続行します。」ティアを FREE として扱います。 |
ステップ 3 — ティアガード(ルーティング前)
ユーザーのリクエストをスキャンして、書き込み意図のフレーズを検出します。以下のパターン(大文字小文字を区別しない)を確認します:
- 「rename [element/block/property]」
- 「create [a block/element/package/diagram]」
- 「delete [element/block]」
- 「add [a relationship/satisfy/dependency]」
- 「move [element]」
- 「update [element/property]」
- 「set [a value/property/documentation]」
- 「change [element]」
- 「modify [element]」
- 「populate [diagram]」
- 「edit [element]」
書き込み意図のフレーズが検出され、かつティアが FREE の場合:
書き込み操作には PRO または ENTERPRISE ティアが必要です。
無料スキルパックは読み取り専用です。リクエストされた操作(「[検出されたフレーズ]」)はモデルを変更するものであり、アップグレードされたライセンスが必要です。
代わりに読み取り専用の同等機能を実行しましょうか? たとえば、要素の現在の状態を表示したり、インパクト分析を実行したり、監査レポートを作成したりできます。
停止 — ルーティングしないでください。ツールを呼び出さないでください。
書き込み意図が検出され、ティアが PRO または ENTERPRISE の場合:通常どおり続行します — すべての無料スキルは上位ティアでも動作し、ブリッジが書き込み安全性を独立して適用します。
書き込み意図が検出されない場合:ステップ 4 に進みます。
注記: これはベストエフォートのヒューリスティックであり、セキュリティの境界ではありません。ブリッジは enable_writes がないことで読み取り専用アクセスを適用します。ティアガードは、ブリッジレベルの拒否に直面する前に、ユーザーに明確な説明を提供するために存在します。
ステップ 4 — 専門スキルへのルーティング
以下のルーティングテーブルとユーザーのリクエストを照合します。最初に一致したものを使用します。一致しない場合、または曖昧な場合(曖昧性ルールを参照)、曖昧性手順に従います。
ルーティングテーブル
| 意図キーワード / フレーズ | ルーティング先 |
|---|---|
| navigate, overview, summary, "what am I looking at", explore, browse, tree, packages, blocks, diagram list | jgs-v1-navigate |
| impact, "what uses", "blast radius", dependencies, "what references", "before I change" | jgs-v1-impact |
| inspect, "tell me everything about", "describe this element", element details, "what is X" | jgs-v1-inspect |
| search, "find anything matching", "look for", "where is" | jgs-v1-search |
| audit, "health check", naming, documentation coverage, requirements coverage, duplicates, unused, methodology | jgs-v1-audit |
| RTM, "traceability matrix", "requirements matrix", "model report", "model health report", "model summary", validate, validation | jgs-v1-report |
| "fix plan", remediation, "how do I fix", "proposed updates", "fix preview", "what to do about findings" | jgs-v1-fixplan |
| "diagram export", "export diagrams", PNG, "review pack", "diagram inventory", "layout styles", "compare layouts" | jgs-v1-diagrams |
| units, "quantity kind", "value types", "standard library types", "find unit" | jgs-v1-units |
| "safety state", tier, "dev mode", "edit history", "what changed", "undo stack" | jgs-v1-status |
PRO ティア機能(この無料パックには含まれません)
以下は読み取り専用ですがプレミアムな機能で、別の SysML v1 PRO スキルパック(JG Systems Consulting Ltd 販売)に含まれており、この無料パックには含まれません。リクエストが以下の意図のいずれかに一致する場合、専門スキルにルーティングせず、代わりに PRO 機能であることをユーザーに伝え、以下のアップグレードパスを表示します。
| 意図キーワード / フレーズ | PRO 機能 |
|---|---|
| migrate, migration, "v1 to v2", "v2 migration", "v2 plan", "migration inventory" | マイグレーションインベントリ(v1→v2 準備状況) |
| cross-model, "v1 vs v2", "v2 equivalent", "compare v1 and v2", dual-bridge | クロスモデル比較 |
応答テンプレート:
その機能(「[意図]」)は SysML v1 PRO スキルパック(読み取り専用のマイグレーションツール、別売り)の一部です。この無料パックは読み取り / ナビゲート / 分析のみをカバーしています。有効にするには、[email protected] まで JG Systems Consulting Ltd に連絡してアップグレードしてください。
曖昧性ルール
曖昧性は次の場合に発生します:
- (a) キーワードグループが 0 個一致した場合、または
- (b) 2 つ以上の異なる専門ルートが同時に一致した場合、または
- (c) リクエストに
?またはhelpのみが含まれている場合
衝突例外: 監査キーワードが別の 1 つのルートと一緒に一致した場合、デフォルトで jgs-v1-audit にルーティングします — これを曖昧とは見なさないでください。例外の例外:監査以外の一致が明らかに優勢である場合(例:ユーザーが明示的に「impact」と言いながら「audit」を軽く言及した場合)、デフォルトにするのではなく、ユーザーに確認を求めてください。
曖昧な場合(および例外が適用されない場合)、以下のメニューを表示します:
SysML v1 スキルを使用していくつかのことをお手伝いできます。どれを希望しますか?
- ナビゲート — モデル構造、パッケージ、ブロック、図を探索します
- 検査 — 単一の要素の完全な詳細情報(タイプ、ポート、関係、ステレオタイプ、要件リンク)
- 検索 — 要素名の全文検索
- インパクト分析 — 要素を使用しているものを特定し、変更前の影響範囲を評価します
- 監査 — ヒューリスティックヘルスチェック:命名、ドキュメント、要件、重複、未使用、方法論
- レポート — モデルヘルスサマリー + 要件トレーサビリティマトリックス + ネイティブ検証、ファイルにエクスポート
- 図 — 図画像のインベントリとエクスポート(ビジュアルレビューパック)
- ユニット — ユニット、数量種類、標準ライブラリタイプを検索
- ステータス — ブリッジのセーフティティア/モードと最近の編集履歴
- 修正計画 — 監査結果を修正計画に変換(推奨アクション + 計算された修正 + 各修正を適用するための PRO ツール)
マイグレーションインベントリとクロスモデル比較は PRO ティア機能です(SysML v1 PRO スキルパック)— アップグレードについてはお問い合わせください。
ユーザーに番号を選んでもらうか、必要な内容を説明してもらい、それに従ってルーティングします。
ステップ 5 — ディスパッチ
自然言語スキル構成を使用して、一致したスキルを呼び出します:
このリクエストにはスキル
<skill-name>を使用します:[ユーザーの元のリクエストをそのまま渡します]
この段階ではブリッジツールを直接呼び出さないでください — 専門スキルが独自のツール呼び出しを管理します。
見つからないスキル
以下のスキルは別のパックで提供されます。スキルが呼び出されて見つからない場合、ユーザーにどのパックが提供するかを伝えてください:
| スキル | パック |
|---|---|
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 |
直接呼び出しに関する注意
専門スキルが(このディスパッチャーを経由せずに)直接呼び出された場合、ライブネスチェックとティアチェックをスキップします — ブリッジが利用できない場合、生のブリッジエラーが表面化します。これは仕様です。このディスパッチャーは、すべての jgs-magic-sysmlv1-mcp 作業の推奨エントリーポイントです。
よくある間違い
ツールに関する落とし穴はありません — このディスパッチャーはルーティングのために ping と get_licence のみを呼び出します。モデルイントロスペクション、図、および書き込みに関する注意事項は、ディスパッチ先の各専門スキルに記載されています。