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 技能包（只读迁移工具，单独出售）。本免费包仅涵盖读取/导航/分析。要启用它，请联系 JG Systems Consulting Ltd：[email protected] 以进行升级。
歧义规则
当以下情况发生时，视为歧义：
- (a) 没有关键词组匹配，或
- (b) 两个或更多不同的专业技能路由同时匹配，或
- (c) 请求仅包含
?或help
冲突例外： 如果审计关键词与另一条路由同时匹配，默认使用 jgs-v1-audit — 不要将其视为歧义。对此例外的例外：如果非审计匹配明显占主导（例如用户明确说“impact”但也顺便提到了“audit”），则要求用户澄清，而不是使用默认值。
当发生歧义时（且没有例外适用），显示以下菜单：
我可以使用 SysML v1 技能帮助您处理几件事。您需要哪一个？
- 导航 — 浏览模型结构、包、块和图表
- 检查 — 单个元素的完整档案（类型、端口、关系、原型、需求链接）
- 搜索 — 跨元素名称的全文搜索
- 影响分析 — 查找哪些地方使用了某个元素，并在更改前评估影响范围
- 审计 — 启发式健康检查：命名、文档、需求、重复、未使用、方法论
- 报告 — 模型健康摘要 + 需求可追溯性矩阵 + 原生验证，导出到文件
- 图表 — 清查和导出示意图图像（可视化审查包）
- 单位 — 查找单位、量种类和标准库类型
- 状态 — 桥接安全层级/模式和最近的编辑历史
- 修复计划 — 将审计结果转化为修复计划（建议的操作 + 计算的修复 + 用于应用每个修复的 PRO 工具）
迁移清单和跨模型比较是 PRO 层级能力（SysML v1 PRO 技能包）— 询问升级。
要求用户选择一个编号或描述他们需要什么，然后相应地进行路由。
步骤 5 — 调度
使用自然语言技能组合来调用匹配的技能：
Use skill
<skill-name>for this request: [逐字传递用户的原始请求]
在此阶段不要直接调用桥接工具 — 专业技能的拥有者负责自己的工具调用。
缺失技能
以下技能由单独的工具包提供。如果技能被调用但未找到，请告知用户哪个工具包提供它：
| 技能 | 工具包 |
|---|---|
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 进行路由；模型自省、图表和写入方面的注意事项位于它调度到的每个专业技能中。