draw.io 다이어그램 생성기 스킬
이 스킬을 사용할 때
- 사용자가 플로우차트, 프로세스 맵, 또는 워크플로 다이어그램을 요청할 때
- 사용자가 ERD, 데이터베이스 다이어그램, 또는 엔터티 관계 모델을 요청할 때
- 사용자가 아키텍처, 시스템, 또는 컴포넌트 다이어그램을 요청할 때
- 사용자가 클래스, 시퀀스, 또는 UML 다이어그램을 요청할 때
- 사용자가 "draw.io", "다이어그램", "플로우차트", "이 프로세스를 시각화해줘"라고 말할 때
- 사용자가 기존
.drawio파일을 업데이트, 수정, 또는 확장하도록 요청할 때
필수 — 생성 전에 반드시 읽을 것
- 먼저 다이어그램 유형을 감지하세요 — XML을 작성하기 전에
references/diagram-types/참조 파일을 확인하세요. - 범용 박스 스타일 표준을 적용하세요 —
references/box-style-standards.md를 참조하세요. - 모든 위치는 하드코딩됩니다 — draw.io XML에는 자동 레이아웃이 없습니다.
- 모든 내보내기 후 시각적 검토 루프를 실행하세요 —
references/visual-review-protocol.md를 참조하세요. - 시각적 검토 없이 완료되었다고 선언하지 마세요 — PNG로 내보내고, 읽고, 수정하고, 반복하세요.
다이어그램 유형 감지
| 사용자가 말하면... | 참조 파일 |
|---|---|
| "플로우차트", "프로세스", "단계", "워크플로", "SOP" | references/diagram-types/flowchart.md |
| "ERD", "데이터베이스", "테이블", "엔터티", "외래 키" | references/diagram-types/erd.md |
| "아키텍처", "시스템", "컴포넌트", "서비스" | references/diagram-types/layout.md |
| "클래스", "UML", "상속", "메서드", "속성" | references/diagram-types/class.md |
| "시퀀스", "상호작용", "생명선", "액터 호출" | references/diagram-types/sequence.md |
표준 생성 워크플로
단계 1 — 유형 참조 로드
XML을 작성하기 전에 올바른 references/diagram-types/ 파일을 읽으세요.
단계 2 — 모든 요소 계획
코딩하기 전에 모든 노드, 연결, 섹션을 목록화하세요. 빌드 중에 레이아웃을 즉흥적으로 변경하지 마세요.
단계 3 — 범용 박스 스타일 적용
모든 노드는 references/box-style-standards.md의 범용 간격 속성을 포함해야 합니다.
단계 4 — 출력 폴더 생성 및 XML 작성
mkdir -p ./diagrams
다음 경로에 저장:
./diagrams/<diagram-name>.drawio
저장 전 체크리스트:
- 모든
mxCell요소에 고유한 순차적 숫자 ID가 있습니다. - 모든 노드 스타일에 범용 박스 간격이 적용됨:
spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top; - 화살표는 단일 소스에서 여러 대상으로 펼쳐지는 방식이 아닌, 체인 라우팅을 사용합니다.
- 두 박스 사이에 최소 15–20px 간격이 있습니다. (하위 항목 목록 하단과 다음 섹션 상단을 확인하세요)
- 높이는
box-style-standards.md의 공식에 따라 계산됨 (fontSize=10에서 한 줄당 ×16px) - 넓은 텍스트 패널(노트, 설명)은 460px 이하가 아닌 530px+ 너비입니다.
-
value속성에 리터럴\n이 없습니다. 줄바꿈에는
를 사용하세요. - 모든 여러 줄 콘텐츠 상자에
verticalAlign=top이 설정되어 있습니다.
단계 5 — PNG 내보내기 및 시각적 검토 루프 실행
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio
그런 다음 references/visual-review-protocol.md의 전체 프로토콜을 따르세요.
단계 6 — 전달
먼저 PNG를 사용자에게 보내세요. 큰 다이어그램의 경우 전체 이미지 전에 섹션 스크린샷(위, 중간, 아래)을 보내세요.
그런 다음 어떤 추가 형식을 원하는지 물어보세요:
다이어그램이 준비되었습니다. 어떤 형식을 원하시나요?
1 — PNG 이미지 (즉시 보기 가능)
2 — .drawio 파일 (draw.io에서 편집 가능)
3 — SVG (확장 가능한 벡터)
4 — PDF
5 — 위의 모든 형식
원하는 번호를 답변으로 보내주세요.
Drive 전달 또는 사용자 정의 출력 경로의 경우 references/workflow-sop.md를 따르세요.
CLI 참조
# macOS — PNG 내보내기 (표준)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>
# macOS — 고해상도 PNG 내보내기
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>
# macOS — SVG 내보내기
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>
# macOS — PDF 내보내기
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>
# Linux / headless — PNG 내보내기
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>
# Linux / headless — SVG 내보내기
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>