Drawio Visuals Skill
네이티브로 사용자 편집이 가능한 Draw.io 파일을 서버, MCP, 고정 템플릿, Scene IR 또는 사용자 정의 렌더러 없이 생성, 재구성 및 편집합니다.
기본값: 텍스트 모듈이 아닌 객체
새로운 설명 흐름 (프로세스, 파이프라인, 스윔레인, 요청 수명 주기 또는 아키텍처 흐름)의 경우 기본적으로 인식 가능한 편집 가능한 객체와 가시적인 변경 사항을 사용합니다. '워크플로우를 그려줘'와 같은 일반적인 요청은 이 규칙을 활성화합니다. 사용자가 '그림', '구체적인', 또는 '예시' 그래픽을 요청할 필요가 없습니다. 다이어그램 유형은 이 시각적 처리와 별도로 선택하세요.
노드를 배치하기 전에 무엇이 이동하고, 무엇이 변경되며, 누가 행동하는지 식별하세요. 그런 다음 각 주요 비즈니스 객체 및 처리 단계에 대해 실루엣, 의미 있는 내용 또는 작은 객체 장면을 선택하세요: 큐에는 별도의 작업 카드와 입/출구가 있습니다. 파서는 문서가 추출된 부분으로 변환되는 것을 보여줍니다. 환불은 보류 중인 자금과 반환된 자금을 구분합니다. 이러한 네이티브 부분을 먼저 그린 다음, 짧은 이름/동작을 추가하세요. 레이블이 간결하고 레이아웃이 깔끔하더라도 일련의 단계 이름이 포함된 사각형은 이 기본값을 충족하지 못합니다. 반복되는 서버 랙, 이모지 또는 산문 카드에 관련 없는 아이콘을 사용하는 것은 시각적 의미를 대체할 수 없습니다. 이러한 흐름을 작성하기 전에 visual-storytelling.md를 읽으세요.
번들 그래픽부터 시작하세요: 컴포넌트 인덱스를 참조하고, assets/components/ 아래의 관련 .drawio XML을 읽고, 네이티브 하위 항목을 재사용할지, 해당 부분을 조정/결합할지, 또는 새 네이티브 객체 생성을 위한 참조로 해당 구성을 사용할지 선택하세요. 작업에 필요한 대로 브라우저, 문서, 메시지, 큐, 작업자, 스토리지, 청크, 테이블, 벡터, 리뷰, 결정 및 알림 객체를 결합하세요. 예를 들어, 브라우저 + 문서 → 스토리지, 그리고 별도의 메시지 → 큐 → 작업자를 구성하고, 사각형 안에 이름만 쓰지 마세요. 12개의 시작점은 확장 가능한 시드 라이브러리이지 완전한 템플릿이나 기능 제한이 아닙니다. 추가 객체를 생성할 때 실루엣, 의미 있는 내용, 상태 표시, 중첩 및 연결 포트와 같은 관련 구성 아이디어를 차용하여 도메인에 맞게 조정하세요. 시작점의 샘플 팔레트를 강제로 적용하거나 정확한 복사본을 강요하지 마세요.
내장 컴포넌트 언어: assets/components/ 아래에서 재사용 가능한 자산을 추가, 생성 또는 유지 관리할 때 모든 캡션, 필드 이름, 설명 텍스트 값, 상태, 페이지 이름 및 도구 설명을 영어로 유지하세요. 숫자, 수식 및 기호는 그대로 유지될 수 있습니다. 이는 라이브러리 작성 규칙입니다. 사용자를 위해 생성된 다이어그램은 여전히 요청된/소스 언어를 따르며, 시작 텍스트는 그에 따라 조정됩니다.
예외는 편의가 아닌 작업을 따릅니다: 충실한 재구성, 로컬 편집 범위, 명시적인 텍스트 전용/최소 상자 요청 및 필수 공식 표기법을 유지하세요. 클래스/ER 컴파트먼트, 시퀀스 수명선, 결정/포크/조인 기호 및 상태 경계는 실제 의미를 전달하므로 유지하세요. '플로우차트', '간단한' 다이어그램, 시작점 누락 또는 Mermaid 사용 가능에 대한 일반적인 요청은 예외가 아닙니다. 호환되는 경우 가시적인 객체 변경으로 상태를 설명하고, 공식 관계를 그림으로 대체하지 마세요. 이러한 기본값은 모든 페이지에 적용되며 방향/유형 변경에도 유지됩니다.
핵심 규칙
- 현재
.drawio파일을 내부 편집 가능한 소스 오브 트루스(진실 공급원)로 취급합니다. 기본적으로 페이지별 PNG 이미지와 하나의 HTML 미리보기만 제공하고, 네이티브 파일은 전달 디렉토리 외부의 내부 작업 디렉토리에 보관하며, 인계 시 연결하지 않습니다. 명시적으로 요청된 경우에만 네이티브 파일, SVG, PDF 또는 기타 형식을 제공합니다. - 입력을 절대 덮어쓰지 마세요. 모든 기계적 쓰기는 내부 작업 파일을 포함하여 새 출력 경로를 사용해야 합니다.
- 테마, 도형 목록, 다이어그램 유형, 좌표 그리드 또는 레이아웃 레시피를 강요하지 마세요.
- 사용자가 지정한 다이어그램 유형, 표기법 및 방향을 따르세요. 지정되지 않은 경우 UML 및 비UML 형식을 포함하여 작업의 실제 질문에 가장 잘 답하는 프레젠테이션을 선택하고, 모든 요청을 기본적으로 플로우차트 또는 스윔레인으로 처리하지 마세요. 프레젠테이션을 선택하거나 크게 변경할 때는 diagram-selection.md를 사용하세요.
- 새로운 설명 흐름에 위의 객체 우선 기본값을 적용하세요. 표준 제어 기호와 재사용 가능한 컴포넌트 시작점은 고정된 아이콘 카탈로그를 강요하지 않고 이를 지원합니다.
- 세로 플로우차트의 경우 기본 경로를 위에서 아래로 실행하고, 병렬 분기를 나란히 배치하고, 결정 다이아몬드에서 나가는 레이블을 지정하고, 지원 검사를 밝은 회색 점선 상자에 일반 언어 목적과 함께 그룹화합니다.
- 중앙 엔진이 외부 모듈을 조정하는 경우 코어를 중앙에 배치하고, 입력과 작업자를 양쪽에 그룹화하고, 번호가 매겨진 화살표와 동작 레이블을 사용하여 작업을 통해 독자를 안내합니다. 관련된 경우 피드백을 코어 위로 라우팅하고, 인간의 결정과 알림 채널을 코어 아래에 배치하고, 예제 워크플로를 하단에 표시합니다. 주제에 맞게 색상을 선택합니다.
- 임의의 네이티브 Draw.io 도형, 스텐실, 스타일, 지오메트리, 웨이포인트, 레이어, 그룹 및 래퍼 메타데이터를 유지합니다.
- 압축된 노드, 레이블 또는 라우팅 통로보다 더 큰 캔버스나 컨테이너를 선호합니다. 충돌이 없는 파일이 반드시 넉넉하고, 읽기 쉽고, 잘 구성된 것은 아닙니다.
- 인접한 노드를 배치하기 전에 커넥터 레이블 공간을 확보하세요. 긴 레이블은 연결된 모양 사이에 가시적인 여백과 함께 맞거나, 명시적인 줄 바꿈/다른 명확한 레이블 위치를 사용해야 합니다. 엔드포인트 레이블 위험을 해결하고 다이어그램이 준비되었다고 표시하기 전에 실제 렌더링된 텍스트 범위를 확인하세요. 커넥터 레이블 여백을 참조하세요.
- 새로 작성되거나 대대적으로 재설계된 콘텐츠의 경우 일반, 보조, 데이터, 예외 및 재시도 흐름을 포함하여 방향성이 있는 의미적 흐름 에지에 기본적으로
flowAnimation=1을 설정합니다. 참조, 주석, 포함, 그룹화 및 순수하게 구조적인 관계는 정적으로 유지합니다. 명시적인 사용자 의도가 이 정책을 재정의하도록 합니다. - 로컬 편집 중 애니메이션 정규화가 요청되지 않는 한 관련 없는 애니메이션 스타일을 유지합니다. 모션이 계층 구조를 모호하게 만드는 경우 렌더링된 QA 중에 토폴로지를 변경하는 대신 우선 순위가 낮은 의미적 흐름을 정적으로 만듭니다.
- 커넥터 애니메이션을 시각적 효과로 취급하고, 라우팅이나 충돌 방지로 취급하지 마세요.
- 번들 CLI를 검사, 쿼리, 패치, 유효성 검사, 레이아웃/토폴로지 검사, 데스크톱/웹 내보내기 오케스트레이션, 동반 HTML, 페이지 CRUD, 버전 나열, 게시 및 복원에만 사용하세요. CLI는 작성, 레이아웃 또는 렌더러를 구현하지 않습니다.
render는 Draw.io Desktop에 위임하고,web-svg-bridge는 선택된 한 페이지를 공식 Draw.io Web에 위임하며, 미리보기 HTML은 공식 원격 뷰어에 위임합니다. <base>-vNNN을 해당 이미지와 HTML이 공유하는 논리적 전달 버전으로 취급하고, 모든 내부 쓰기가 아닙니다. 네이티브 버전 관리는 소스 전달이 요청되지 않는 한 내부적으로 유지됩니다. 기본적으로 사용자가 승인한 하나의 변경 사항은 최대 하나의 새 형제 버전을 소비합니다.- 모든 공개 CLI
--page-index는inspect가 반환하는index와 일치하는 0부터 시작합니다. 다중 페이지 작업에는 안정적인 페이지 ID를 선호합니다. - 각 문서를 15페이지로 제한합니다. CLI는
PAGE_COUNT_LIMIT으로 더 큰 기존 문서와 이 한도를 초과하는 추가를 거부합니다. 이를 충족시키기 위해 페이지를 자르지 마세요. - 이 스킬을 공식
drawio@drawio스킬과 함께 활성화하지 마세요. 이 스킬은 이미 동일한 네이티브 Mermaid/XML 작성 경로를 가지고 있습니다.
프레젠테이션 선택
다이어그램 유형을 작성 도구와 분리하세요. 독자가 이해해야 할 내용(진행, 책임, 상호 작용, 상태, 구조, 배포, 데이터 이동 또는 비교)에 따라 선택하세요. 제공된 다이어그램, 명시적 형식 또는 요청된 로컬 편집은 그 선택을 제한합니다. 사용자가 열어 둔 경우 자율적으로 선택하고, 유용할 때 간략히 설명한 후 진행하세요. 사용자가 카탈로그에서 선택하도록 하지 마세요. 질문-형식 가이드 및 트레이드오프에 대한 diagram-selection.md를 읽으세요.
기본 시각적 처리를 작업의 명시적 예외와 함께 모든 페이지 및 개정판에 적용하세요. 객체 기반 설명을 대체하기 위해 일반 텍스트 동반 페이지를 추가하지 마세요.
그런 다음 해당 프레젠테이션에 적합한 객체와 표기법을 선택하세요. 구체적인 일러스트레이션은 페이로드와 변환을 설명할 수 있지만, 공식 UML, ER 및 기타 확립된 기호는 의미적 관례를 유지해야 합니다. 레이블이 지정된 모든 클래스, 상태 또는 스키마 상자를 텍스트 중심 흐름 결함으로 취급하지 마세요.
워크플로 선택
| 요청 | 워크플로 |
|---|---|
| 프로세스, 파이프라인, 스윔레인, 수명 주기 또는 아키텍처 흐름 설명 | 증거/소유권 → visual-storytelling → 객체/상태 구성 → 직접 네이티브 XML → 공식 렌더러 QA |
| 공식 구조 다이어그램 또는 명시적으로 최소 상자 다이어그램 생성 | 표기법/내용 유지 → 의도된 표현을 유지하고 Desktop을 사용할 수 있는 경우 Mermaid; 그렇지 않으면 네이티브 XML |
| 사용자 정의 도형/스타일/위치로 생성 | 직접 네이티브 XML → .drawio |
| PDF 또는 텍스트에서 생성 | 소스 읽기 → 지원되는 구조 추출 → 동일한 기본값을 사용하여 표현 선택 → 네이티브 XML 또는 적합한 Mermaid |
| 이미지에서 재구성 | 원본 해상도에서 검사 → 편집 가능한 네이티브 셀 → 선택적 미리보기 비교 |
| 시각적 충돌 확인 | check-layout → Desktop render → 이미지 검사 → 작은 패치 → 재렌더링; Viewer HTML으로 대체 |
| 비즈니스 흐름 확인 | 알려진 시작점, 종점 및 필수 에지로 check-topology |
| Desktop 없이 보기 | preview → 공식 원격 뷰어를 사용하여 표시되는 페이지 수/이름이 포함된 동반 .html |
| Desktop 없이 SVG 내보내기 | 하나의 web_svg_session.py 루프백 세션 선호; 수동 복구를 위해 web-svg-bridge → commit-web-svg 유지 |
| 요청된 레이아웃 내보내기 또는 적용 | 먼저 .drawio 생성 → Draw.io Desktop CLI |
| 편집, 대상 불명 | inspect → query → patch |
| 편집, 페이지 및 셀 ID 알려짐 | query → patch |
| 편집, 신뢰할 수 있는 최신 CLI 결과에 이미 개정 및 대상이 있음 | patch |
| 페이지 추가, 이름 변경 또는 삭제 | inspect → page add/rename/delete |
| 파일 버전 나열 또는 복원 | versions 또는 versions → inspect old → restore |
| 완료된 작업 파일 게시 | inspect working → publish |
| 하나 이상의 알려진 셀 보기 | query |
| 파일 독립적으로 확인 | validate |
생성, 미리보기, Desktop 감지, 레이아웃 및 내보내기에 대한 references/authoring.md를 읽으세요. Desktop을 사용할 수 없고 공식 Draw.io Web을 통해 요청된 SVG를 명시적으로 내보내야 하는 경우에만 references/web-svg-export.md를 읽으세요. 복잡한 다이어그램을 작성하거나, 페이지 간 시각적 일관성을 유지하거나, check-layout을 해석하거나, 렌더링된 시각적 QA를 수행할 때 references/layout-authoring.md를 읽으세요. 프로세스, 수명 주기 또는 요청 경로를 연결해야 하는 경우 references/topology.md를 읽으세요. 소스가 PDF, 텍스트 또는 이미지인 경우 references/source-to-diagram.md를 읽으세요. 직접 XML 작성에만 references/drawio-xml.md를 읽으세요. 패치를 구성하기 전에 references/patch-contract.md를 읽으세요. 페이지 명령 및 불변 기록에 대한 references/versioning.md를 읽으세요.
논리적 전달 계획
- 쓰기 전에 요청된 모든 변경 사항을 해당 페이지/셀, 필요한 결정 종료, 중요한 시작/종점/에지 제약 조건, 부작용 또는 오류 경로, 용어 및 영향을 받는 모든 페이지에 매핑합니다.
- 새 다중 페이지 문서의 경우 작성 전에 문서-로컬 시각적 역할을 정의하고 페이지 기초, 타이포그래피, 반복되는 컴포넌트 스타일 및 관계 스타일을 페이지 전체에 재사용합니다. 콘텐츠를 추가하거나 편집할 때 요청된 범위 내에서 기존 문서 규칙을 상속합니다. 역할 선택, 의도적인 예외 및 교차 페이지 수락에 대한 문서 시각적 일관성을 따르세요.
- 나중에 토폴로지, 레이아웃 또는 시각적 수정이 필요하지 않은 단일 원자 편집의 경우 새 내부 네이티브 버전에 직접 작성합니다.
- 다중 페이지 편집 또는 QA 수정이 필요할 가능성이 있는 작업의 경우 에이전트 소유의 임시 디렉토리를 만들고
working-01.drawio,working-02.drawio등을 작성합니다. 요청된 모든 편집 및 검사를 거기서 완료합니다.publish는 내부 최종 스냅샷 또는 명시적으로 요청된 네이티브 전달에 선택 사항입니다. - 동일한 최종 확인된 네이티브 스냅샷에서 전달 HTML 및 페이지별 PNG를 생성합니다. 게시된
.drawio전달물은 필요하지 않습니다. 사용자 대상 HTML의 경우preview --fallback-png(페이지 순서대로 반복)를 사용하여 각 페이지의 확인된 렌더를 포함합니다. 원격 Viewer가 차단된 상태(좁은 너비 포함)에서 전달된 HTML을 확인합니다. 성공적인 온라인 렌더만으로는 수신자의 미리보기를 확인할 수 없습니다. 사용 가능한 공식 렌더가 없는 경우 HTML을 온라인 전용으로 표시하고 제한 사항을 공개합니다. 임시 미리보기는 QA 아티팩트이지 전달물이 아닙니다. - 자체 포함된 이미지와 HTML을 확인한 후 이 작업에서 생성된 폐기 가능한 QA 파일만 제거합니다. 나중에 편집할 수 있도록 최종 네이티브 스냅샷은 내부에 유지합니다. 명시적인 사용자 승인 없이 기존의 공식 버전을 절대 정리하지 마세요.
생성
references/authoring.md를 읽고 구문을 선택하기 전에 표현을 선택합니다. 새로운 설명 흐름의 경우 객체 우선 기본값과 직접 네이티브 XML을 사용합니다. Desktop 가용성은 내보내기를 변경하며 시각적 요구 사항을 변경하지 않습니다. 선택한 의미/표현을 유지하는 경우에만 Mermaid를 사용합니다(예: 공식 구조 또는 명시적으로 최소 상자 다이어그램). 변환/내보내기를 위해 Desktop을 감지합니다.- 설명적인 소문자-하이픈으로 연결된 베이스를 선택하고, 초기 이미지/HTML 전달을 위해
<base>-v001을 예약하고 해당.drawio스냅샷을 내부에 보관합니다.
... [번역을 위해 잘림]