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단계 — 티어 보호 (라우팅 전)
사용자 요청에서 쓰기 의도 구문을 검색합니다. 다음 패턴(대소문자 구분 없음)이 있는지 확인합니다:
- "[요소/블록/속성을] 이름 변경"
- "[블록/요소/패키지/다이어그램을] 생성"
- "[요소/블록] 삭제"
- "[관계/만족/의존성을] 추가"
- "[요소] 이동"
- "[요소/속성] 업데이트"
- "[값/속성/문서를] 설정"
- "[요소] 변경"
- "[요소] 수정"
- "[다이어그램] 채우기"
- "[요소] 편집"
쓰기 의도 구문이 하나라도 감지되고 티어가 FREE인 경우:
쓰기 작업에는 PRO 또는 ENTERPRISE 티어가 필요합니다.
무료 스킬 팩은 읽기 전용입니다. 귀하가 요청한 작업("[감지된 구문]")은 모델을 수정하므로 업그레이드된 라이선스가 필요합니다.
대신 읽기 전용으로 동등한 작업을 수행해 드릴까요? 예를 들어, 요소의 현재 상태를 보여주거나, 영향 분석을 실행하거나, 감사 보고서를 생성할 수 있습니다.
중단 — 라우팅하지 마십시오. 어떤 도구도 호출하지 마십시오.
쓰기 의도가 감지되었고 티어가 PRO 또는 ENTERPRISE인 경우: 정상 진행합니다 — 모든 무료 티어 스킬은 상위 티어에서도 작동하며, 브리지가 쓰기 안전을 독립적으로 강제합니다.
쓰기 의도가 감지되지 않은 경우: 4단계로 진행합니다.
참고: 이는 최선의 휴리스틱이며 보안 경계가 아닙니다. 브리지는 enable_writes의 부재를 통해 읽기 전용 액세스를 강제합니다. 티어 보호는 브리지 수준의 거부가 발생하기 전에 사용자에게 명확한 설명을 제공하기 위해 존재합니다.
4단계 — 전문 스킬로 라우팅
아래 라우팅 테이블과 사용자 요청을 일치시킵니다. 첫 번째 일치를 사용합니다. 일치 항목이 없거나 모호한 경우(모호성 규칙 참조), 모호성 절차를 따릅니다.
라우팅 테이블
| 의도 키워드 / 구문 | 라우팅 대상 |
|---|---|
| 탐색, 개요, 요약, "지금 보고 있는 것", 둘러보기, 트리, 패키지, 블록, 다이어그램 목록 | jgs-v1-navigate |
| 영향, "사용하는 것", "블래스트 반경", 의존성, "참조하는 것", "변경 전에" | jgs-v1-impact |
| 검사, "~에 대한 모든 것", "이 요소 설명", 요소 세부 정보, "X가 무엇인지" | jgs-v1-inspect |
| 검색, "일치하는 항목 찾기", "찾기", "위치" | jgs-v1-search |
| 감사, "건강 상태", 명명, 문서화 범위, 요구사항 범위, 중복, 미사용, 방법론 | jgs-v1-audit |
| RTM, "추적 매트릭스", "요구사항 매트릭스", "모델 보고서", "모델 건강 보고서", "모델 요약", 검증, 유효성 검사 | jgs-v1-report |
| "수정 계획", 시정, "수정 방법", "제안된 업데이트", "수정 미리보기", "결과에 대한 조치" | jgs-v1-fixplan |
| "다이어그램 내보내기", "다이어그램 내보내기", PNG, "검토 팩", "다이어그램 인벤토리", "레이아웃 스타일", "레이아웃 비교" | jgs-v1-diagrams |
| 단위, "수량 종류", "값 유형", "표준 라이브러리 유형", "단위 찾기" | jgs-v1-units |
| "안전 상태", 티어, "개발 모드", "편집 기록", "변경 사항", "실행 취소 스택" | jgs-v1-status |
PRO 티어 기능 (이 무료 팩에는 없음)
다음은 읽기 전용이지만 프리미엄 기능으로, 이 무료 팩이 아닌 별도의 SysML v1 PRO 스킬 팩(JG Systems Consulting Ltd 판매)에 포함되어 있습니다. 요청이 이러한 의도 중 하나와 일치하는 경우 전문 스킬로 라우팅하지 말고 대신 사용자에게 PRO 기능임을 알리고 아래 업그레이드 경로를 표시하십시오.
| 의도 키워드 / 구문 | PRO 기능 |
|---|---|
| 마이그레이션, "v1에서 v2로", "v2 마이그레이션", "v2 계획", "마이그레이션 인벤토리" | 마이그레이션 인벤토리 (v1→v2 준비 상태) |
| 교차 모델, "v1 대 v2", "v2 동등", "v1과 v2 비교", 이중 브리지 | 교차 모델 비교 |
응답 템플릿:
해당 기능("[의도]")은 SysML v1 PRO 스킬 팩(읽기 전용 마이그레이션 도구, 별도 판매)의 일부입니다. 이 무료 팩은 읽기/탐색/분석만 다룹니다. 활성화하려면 [email protected]으로 JG Systems Consulting Ltd에 연락하여 업그레이드하십시오.
모호성 규칙
모호성은 다음 경우에 발생합니다:
- (a) 일치하는 키워드 그룹이 0개인 경우, 또는
- (b) 두 개 이상의 서로 다른 전문 경로가 동시에 일치하는 경우, 또는
- (c) 요청에
?또는help만 포함된 경우
충돌 예외: 감사 키워드가 다른 하나의 경로와 함께 일치하는 경우, jgs-v1-audit을 기본값으로 사용합니다 — 이를 모호한 것으로 처리하지 마십시오. 예외의 예외: 감사가 아닌 일치가 명백히 우세한 경우(예: 사용자가 "영향"이라고 명시했지만 지나가는 말로 "감사"를 언급한 경우), 기본값을 사용하지 말고 사용자에게 명확히 요청하십시오.
모호한 경우(예외가 적용되지 않는 경우), 다음 메뉴를 제시합니다:
SysML v1 스킬을 사용하여 여러 가지 작업을 도와드릴 수 있습니다. 어떤 것을 원하십니까?
- 탐색 — 모델 구조, 패키지, 블록 및 다이어그램 탐색
- 검사 — 단일 요소에 대한 전체 정보 (유형, 포트, 관계, 스테레오타입, 요구사항 링크)
- 검색 — 요소 이름 전체 텍스트 검색
- 영향 분석 — 요소를 사용하는 항목을 찾고 변경 전 블래스트 반경 평가
- 감사 — 휴리스틱 건강 점검: 명명, 문서화, 요구사항, 중복, 미사용, 방법론
- 보고서 — 모델 건강 요약 + 요구사항 추적 매트릭스 + 네이티브 검증, 파일로 내보내기
- 다이어그램 — 다이어그램 이미지 인벤토리 및 내보내기 (시각적 검토 팩)
- 단위 — 단위, 수량 종류 및 표준 라이브러리 유형 조회
- 상태 — 브리지 안전 티어/모드 및 최근 편집 기록
- 수정 계획 — 감사 결과를 시정 계획으로 전환 (권장 조치 + 계산된 수정 + 각 수정을 적용할 PRO 도구)
마이그레이션 인벤토리 및 교차 모델 비교는 PRO 티어 기능입니다(SysML v1 PRO 스킬 팩) — 업그레이드를 요청하세요.
사용자에게 번호를 선택하거나 필요한 사항을 설명하도록 요청한 후 이에 따라 라우팅합니다.
5단계 — 디스패치
일치된 스킬을 자연어 스킬 구성을 사용하여 호출합니다:
이 요청에 대해 스킬
<스킬-이름>을(를) 사용하십시오: [사용자의 원래 요청을 그대로 전달]
이 단계에서는 브리지 도구를 직접 호출하지 마십시오 — 전문 스킬이 자체 도구 호출을 관리합니다.
누락된 스킬
다음 스킬은 별도 팩으로 제공됩니다. 스킬이 호출되었으나 찾을 수 없는 경우, 해당 팩을 사용자에게 알려주십시오:
| 스킬 | 팩 |
|---|---|
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만 호출합니다. 모델 내부 검사, 다이어그램 및 쓰기에 대한 주의사항은 디스패치되는 각 전문 스킬에 있습니다.