drawio-skill
손으로 잡은 배치를 지키며 갱신하는 아키텍처 다이어그램 스킬
npx skills add Agents365-ai/365-skills -g자연어와 실제 시스템 자료를 유지보수 가능한 draw.io 아키텍처 모델로 바꾸는 스킬입니다. 의미와 출처, 좌표를 분리해 두어서 모델 하나에서 경영진용과 시스템, 배포, 데이터 흐름, 보안 관점을 각각 뽑아냅니다. 갱신할 때 손으로 맞춘 좌표와 스타일을 버리지 않고 바뀐 부분만 반영하며, 삭제는 기본적으로 사람이 검토하게 남깁니다. 인터넷에서 데이터베이스로 직접 붙는 경로나 순환, 고아 노드 같은 규칙을 YAML 로 적어 두고 CI 에서 검사할 수 있습니다. 표준 라이브러리만 쓰는 MCP 서버가 함께 들어 있어 도구 아홉 개를 그대로 노출합니다.
판단
이럴 때 씁니다
- 아키텍처 그림을 코드처럼 관리하고 싶을 때
- 그림을 갱신할 때마다 배치가 무너져 다시 잡고 있을 때
- 구조 규칙을 CI 에서 검사하고 싶을 때
이럴 땐 쓰지 마세요
- 한 번 그리고 마는 그림에는 절차가 무겁습니다
- draw.io 데스크톱 CLI 를 따로 깔아야 합니다
- 머메이드 변환과 자동 배치는 30판 이상에서만 됩니다
차별점
- 의미와 출처, 좌표를 분리해 모델 하나에서 여러 관점을 뽑습니다.
- 손으로 맞춘 배치를 지키면서 증분 갱신합니다.
- 구조 규칙을 테스트처럼 검사하고 CI 액션을 제공합니다.
- 표준 라이브러리만 쓰는 MCP 서버가 함께 들어 있어 별도 패키지가 필요 없습니다.
워크플로
- 01draw.io 데스크톱 CLI 를 깔고 판을 확인합니다.
- 02스킬을 설치합니다.
- 03설명이나 실제 코드에서 모델을 만듭니다.
- 04손으로 배치를 다듬습니다.
- 05자료가 바뀌면 동기화 명령으로 바뀐 부분만 반영합니다.
- 06구조 규칙 검사를 CI 에 겁니다.
주요 명령
| 명령 | 설명 |
|---|---|
npx skills add Agents365-ai/365-skills -g | 스킬 규격을 지원하는 에이전트에 설치합니다. |
diagramctl sync | 손으로 맞춘 좌표와 스타일을 지키며 바뀐 부분만 갱신합니다. |
diagramctl test | 구조 규칙 위반을 검사합니다. |
diagramctl story | 의존성 없이 열리는 접근성 안내 페이지를 만듭니다. |
함정
설치 전에 확인하세요
- draw.io 데스크톱 CLI 30판 이상을 권합니다. 그 아래에서는 머메이드 변환과 자동 배치가 동작하지 않습니다.
- 리눅스에서 화면 없이 돌리려면 가상 디스플레이를 따로 깔아야 합니다.
- WSL2 에서는 윈도우 실행 파일을 마운트 경로로 부릅니다. 스킬이 자동으로 감지하지만 경로 문제가 나면 이 구조를 알아야 원인을 찾습니다.
- 동기화는 삭제를 자동으로 반영하지 않고 검토 대상으로 남깁니다. 지운 것이 그림에 남아 있다고 오해하기 쉽습니다.
비교
머메이드 같은 텍스트 다이어그램은 만들기는 쉽지만 배치를 손으로 다듬을 여지가 없습니다. 반대로 그림 도구는 배치는 자유롭지만 자료가 바뀌면 사람이 다시 그립니다. 이쪽은 모델과 좌표를 나눠 두 문제를 동시에 다루려 하며, 그 대가로 절차가 늘어납니다.
최근 변경
특정 마켓플레이스와 에이전트를 강조하던 배지와 설치 안내를 지워 어느 도구에도 치우치지 않는 범용 스킬 묶음으로 문서를 정리했습니다. 실행 동작은 바뀌지 않았습니다.