xonika9/agent-skills

다이어그램

시각적 논증과 네이티브 소스의 독립적 정확성을 유지하면서 다이어그램을 디자인, 생성, 리뷰, 변환합니다.

기계 판독 가능한 온보딩 계약서에는 외부 필수 조건이 명시되어 있습니다.

두 가지 결정

먼저 관계를 표현하는 뷰(뷰: 순서도, 시퀀스, 상태, 아키텍처, 데이터 모델, 계층 구조, 타임라인, 비교 또는 기타 지원되는 뷰)를 선택합니다. 그런 다음 전달 형식을 선택합니다. 익숙한 파일 형식이 다이어그램 유형을 결정하게 두지 마십시오.

명시적 형식이 필요한 구조를 표현할 수 있을 때 우선합니다. 만약 명시적 형식이 실질적인 제한을 초래한다면, 해당 제한을 설명하고 결과물을 조용히 변경하지 않고 대안을 제시합니다.

형식이 열려 있을 때 이 매트릭스를 사용합니다:

제약 조건	Excalidraw	Mermaid	draw.io
수동 좌표 제어	강함	약함; 레이아웃 자동	강함
협업 시각 편집	Excalidraw에서 강함	호스트에 따라 다름	diagrams.net에서 강함
텍스트 diff 및 코드 리뷰	나쁨	강함	압축되지 않은 XML에서 보통
자동 레이아웃	수동 우선	강함	가능하지만 수동 기하학은 명시적으로 유지
자유로운 공간 구성	강함	제한적	강함
페이지, 레이어, 컨테이너, 셰이프 라이브러리	제한적	제한적이며 렌더러에 따라 다름	강함
직접 Markdown/채팅 렌더링	드묾	지원 시 강함	드묾
핸드오프 후 네이티브 편집 가능성	.excalidraw	호환 편집기의 Mermaid 소스	.drawio XML
안정적인 유효성 검사 및 렌더링	체커와 충실한 렌더러 필요	대상 파서와 렌더러 필요	XML 검사와 호환 편집기/내보내기 도구 필요

네이티브 편집기, 유효성 검사기, 렌더러가 전달 환경에서 사용 가능한 형식을 선호합니다. 어느 것도 시각적 증명을 제공할 수 없으면 요청된 네이티브 소스가 여전히 유용한 경우에만 생성하고 결과에 DEGRADED 레이블을 붙입니다.

시각적 논증을 소유하십시오

하나의 질문, 대상, 전달 뷰포트, 진입점, 지배적인 읽기 방향을 결정합니다. 설명 레이블을 단축하면서 정확한 사실과 식별자를 유지합니다. 구문이나 좌표보다 먼저 의미론적 노드, 경계, 관계를 모델링합니다.

다이어그램을 만들거나 실질적으로 수정하기 전에 공유 디자인 방법을 읽으십시오. 이 문서는 토폴로지, 계층 구조, 밀도, 그룹화, 경계, 라우팅, 의미론적 모양/색상/선 사용, 분할 기준, 시각적 승인을 소유합니다.

하나의 형식 어댑터 사용

• 네이티브 .excalidraw JSON의 경우, Excalidraw 어댑터를 읽습니다. 번들로 제공되는 체커를 실행하고 충실한 렌더링을 검사합니다.
• Mermaid 소스 또는 채팅 내 Mermaid 블록의 경우, Mermaid 어댑터를 읽습니다. 실제 대상 또는 호환 가능한 기존 도구로 구문 분석하고 렌더링합니다.
• 네이티브 .drawio XML의 경우, draw.io 어댑터를 읽습니다. XML 구조를 검증하고 호환 가능한 diagrams.net 도구로 열거나 내보낸 후 결과를 검사합니다.

형식 어댑터는 직렬화, 이스케이프, 식별자, 바인딩, 기하학, 테마, 페이지, 레이어, 렌더러별 제한을 소유합니다. 이 코어에 변동성이 큰 메커니즘을 복사하지 마십시오.

네이티브 소스 보존

새로운 명명된 경로의 결과물의 경우, 처음 작성될 때 요청된 경로가 표준 경로가 됩니다. 개정의 경우, 변경 사항이 후보에 있는 동안 기존 소스가 표준으로 유지됩니다. 편집기와 렌더러는 해당 아티팩트를 사용합니다. 다른 곳으로의 내보내기는 암시적으로 표준 소스를 대체하지 않습니다.

개정 후보는 완료 게이트를 충족할 때만 기존 소스를 대체합니다. 그렇지 않으면 DEGRADED를 보고하고 기존 소스를 변경하지 않은 상태로 두며 후보를 미완성으로 식별합니다.

변환 및 리뷰

변환 과정에서 의미론적 정체성(노드 의미, 관계 방향, 시퀀스, 포함 관계, 경계, 카디널리티, 정확한 기술 토큰)을 보존합니다. 소스와 대상이 모두 지원하는 경우 페이지, 레이어, 컨테이너 정체성을 보존합니다. 자동 레이아웃 변경, 지원되지 않는 셰이프 라이브러리, 평탄화된 스타일링과 같은 손실을 명시합니다. 픽셀 완전 동일성을 약속하지 마십시오.

리뷰 전용 작업의 경우, 다시 작성하지 않고 검사하고 보고합니다. 렌더링된 구도와 별도로 네이티브 구조를 확인합니다. 구문 분석 성공이 가독성을 증명하지 않으며, 그럴듯한 그림이 편집 가능성을 증명하지 않습니다.

트리거 경계

이 스킬은 명시적인 x9-diagrams 호출, 형식 선택, 교차 형식 변환, 공유 시각적 방법, 결합된 구조적 및 시각적 검증을 소유합니다. 일반적인 Mermaid 구문에 국한된 요청은 설치된 전용 mermaid-diagrams 스킬에 맡길 수 있습니다. 이 스킬은 해당 타사 스킬이 없는 사용자를 위해 자체 포함되어 있습니다.

트리거 소유권이 모호할 경우, 작업에 더 넓은 결정 또는 검증 계약이 필요한 경우에만 x9-diagrams를 사용합니다. 요청에 Mermaid가 포함되었다고 두 스킬을 모두 호출하지 마십시오.

완료 게이트

완료 증거를 요청된 작업과 일치시킵니다:

• 형식 선택: 뷰와 전달 형식을 명명하고, 선택을 사용자의 제약 조건과 연결하며, 실질적인 제한을 명시하고, 호환 가능한 유효성 검사기, 렌더러 또는 편집기를 사용할 수 있는지 식별합니다.
• 생성 또는 실질적인 수정: 선택한 뷰가 명시된 질문에 답변합니다. 네이티브 소스가 구문 분석되거나 열리며 편집 가능한 상태로 유지됩니다. 에이전트가 스스로 완료할 수 없는 네이티브 파일 또는 디렉토리 선택기를 트리거하지 않았습니다. 형식별 로드 후 레이아웃이 적용 가능한 경우 안정적입니다. 호환 가능한 렌더러 또는 편집기가 최종 변형 이후 최종 표준 소스에서 실제 뷰를 생성했습니다. 해당 뷰가 선언된 전달 모드에서 가독성, 계층 구조, 교차, 클리핑, 오해를 유발하는 구조에 대해 검사되었습니다.
• 변환: 생성 증거를 충족하고 중요한 의미론이 살아남았는지 확인합니다. 레이아웃, 스타일링, 페이지, 레이어, 컨테이너 또는 표기법의 손실을 명시합니다.
• 리뷰 전용: 네이티브 구조 발견 사항과 렌더링된 구도 발견 사항을 구분하고, 아티팩트를 다시 작성하지 않고 검사된 증거를 인용합니다.

활성 작업에 필요한 증거를 얻을 수 없는 경우, 정확히 누락된 검사, 유효성 검사기, 렌더러, 편집기 또는 소스 아티팩트와 함께 DEGRADED를 보고합니다. Excalidraw 체커 회귀 테스트는 scripts/test_check_scene.py에 있습니다.