Communityライティング&編集github.com

jgsystemsconsulting/jgs-magic-sysmlv1-free-skills

CATIA Magic 向けの無料の読み取り専用 SysML v1 モデル分析スキル — ナビゲート、検査、監査、レポート作成。Claude Code などのエージェントと連携します。

jgs-magic-sysmlv1-free-skills とは?

このスキルパックは、CATIA Magic 環境内の SysML v1 モデルに対して、読み取り専用の分析機能を提供するエージェントディスパッチャーです。Claude Code や Codex などの AI エージェントと連携し、モデル構造のナビゲート、要素の詳細検査、インパクト分析、監査、レポート作成、ユニット検索、図のエクスポートなど、10 以上の専門スキルへのルーティングを一元管理します。利用者はまずディスパッチャー (jgs-v1) にリクエストを送ることで、ライブネスチェック、ライセンス確認、書き込み意図の検出を自動的に通過し、適切なスキルにルーティングされます。無料版は読み取り専用であり、書き込み操作には PRO または ENTERPRISE ライセンスが必要であることをユーザーに明示します。このスキルパックは、SysML v1 モデルの品質管理、ドキュメントレビュー、要件トレーサビリティ、モデルヘルスチェックなどの日常的な分析タスクを効率化するために設計されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add jgsystemsconsulting/jgs-magic-sysmlv1-free-skills

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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=truetier フィールド(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 listjgs-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, methodologyjgs-v1-audit
RTM, "traceability matrix", "requirements matrix", "model report", "model health report", "model summary", validate, validationjgs-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 スキルを使用していくつかのことをお手伝いできます。どれを希望しますか?

  1. ナビゲート — モデル構造、パッケージ、ブロック、図を探索します
  2. 検査 — 単一の要素の完全な詳細情報(タイプ、ポート、関係、ステレオタイプ、要件リンク)
  3. 検索 — 要素名の全文検索
  4. インパクト分析 — 要素を使用しているものを特定し、変更前の影響範囲を評価します
  5. 監査 — ヒューリスティックヘルスチェック:命名、ドキュメント、要件、重複、未使用、方法論
  6. レポート — モデルヘルスサマリー + 要件トレーサビリティマトリックス + ネイティブ検証、ファイルにエクスポート
  7. 図 — 図画像のインベントリとエクスポート(ビジュアルレビューパック)
  8. ユニット — ユニット、数量種類、標準ライブラリタイプを検索
  9. ステータス — ブリッジのセーフティティア/モードと最近の編集履歴
  10. 修正計画 — 監査結果を修正計画に変換(推奨アクション + 計算された修正 + 各修正を適用するための PRO ツール)

マイグレーションインベントリとクロスモデル比較は PRO ティア機能です(SysML v1 PRO スキルパック)— アップグレードについてはお問い合わせください。

ユーザーに番号を選んでもらうか、必要な内容を説明してもらい、それに従ってルーティングします。


ステップ 5 — ディスパッチ

自然言語スキル構成を使用して、一致したスキルを呼び出します:

このリクエストにはスキル <skill-name> を使用します:[ユーザーの元のリクエストをそのまま渡します]

この段階ではブリッジツールを直接呼び出さないでください — 専門スキルが独自のツール呼び出しを管理します。


見つからないスキル

以下のスキルは別のパックで提供されます。スキルが呼び出されて見つからない場合、ユーザーにどのパックが提供するかを伝えてください:

スキルパック
jgs-v1-navigatejgs-magic-sysmlv1-free-skills
jgs-v1-inspectjgs-magic-sysmlv1-free-skills
jgs-v1-searchjgs-magic-sysmlv1-free-skills
jgs-v1-impactjgs-magic-sysmlv1-free-skills
jgs-v1-reportjgs-magic-sysmlv1-free-skills
jgs-v1-diagramsjgs-magic-sysmlv1-free-skills
jgs-v1-unitsjgs-magic-sysmlv1-free-skills
jgs-v1-statusjgs-magic-sysmlv1-free-skills
jgs-v1-fixplanjgs-magic-sysmlv1-free-skills
jgs-v1-auditjgs-magic-sysmlv1-free-skills
jgs-v1-audit-namingjgs-magic-sysmlv1-free-skills
jgs-v1-audit-docsjgs-magic-sysmlv1-free-skills
jgs-v1-audit-requirementsjgs-magic-sysmlv1-free-skills
jgs-v1-audit-duplicatesjgs-magic-sysmlv1-free-skills
jgs-v1-audit-unusedjgs-magic-sysmlv1-free-skills
jgs-v1-audit-methodologyjgs-magic-sysmlv1-free-skills

直接呼び出しに関する注意

専門スキルが(このディスパッチャーを経由せずに)直接呼び出された場合、ライブネスチェックとティアチェックをスキップします — ブリッジが利用できない場合、生のブリッジエラーが表面化します。これは仕様です。このディスパッチャーは、すべての jgs-magic-sysmlv1-mcp 作業の推奨エントリーポイントです。

よくある間違い

ツールに関する落とし穴はありません — このディスパッチャーはルーティングのために ping と get_licence のみを呼び出します。モデルイントロスペクション、図、および書き込みに関する注意事項は、ディスパッチ先の各専門スキルに記載されています。

関連スキル