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。
處理三種可能結果：
| 結果 | 動作 |
|---|---|
成功，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) 沒有任何關鍵字群組符合，或
- (b) 兩個或以上不同的專門路由同時符合，或
- (c) 請求僅包含
?或help
衝突例外： 如果稽核關鍵字與另一個路由同時符合，預設使用 jgs-v1-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 來進行路由；模型內省、圖表和寫入的注意事項存在於它所調度的每個專門技能中。