Diagram Studio
JSON 스펙으로 깔끔한 다이어그램을 생성합니다. 모양은 완전히 설정 가능합니다:
- 손글씨: rough.js의 흔들림과 손글씨 폰트.
- 깔끔한 벡터: 흔들림 없음, 산세리프 또는 세리프 폰트, 부드러운 그림자.
- 그 외 모든 중간 스타일.
모든 텍스트는 외곽선으로 변환되므로 SVG와 PNG가 모든 곳에서 동일하게 보입니다. 린터가 겹침, 텍스트 넘침, 경계선 위의 레이블, 상자를 통과하는 화살표를 잡아냅니다.
모든 것이 번들로 제공됩니다: Node 18+만 필요하며 npm install이나 네트워크가 필요하지 않습니다.
SKILL_DIR은 이 스킬 폴더의 절대 경로(이 파일이 포함된 폴더)를 의미합니다.
node SKILL_DIR/scripts/render.mjs diagram.json --out out/ # → out/diagram.png (2x), .svg, .report.json, .tiles/
0. Codex, Claude Code 또는 다른 에이전트에서 실행하기
- SKILL_DIR:
- Codex에서는 스킬의 짧은 경로를 스킬 루트 테이블로 확장합니다(예:
r0/diagram-studio/SKILL.md→~/.codex/skills/diagram-studio). - Claude Code에서는 보통
~/.claude/skills/diagram-studio입니다. - 항상 스크립트를 해당 절대 경로로 호출하세요.
- Codex에서는 스킬의 짧은 경로를 스킬 루트 테이블로 확장합니다(예:
- 이미지 보기는 필수입니다: 원본, 그리드, 타일 및 비교 결과를 확인해야 합니다.
- Codex: PNG 경로를 사용하여
view_image도구를 사용하세요.render.mjs가name.preview.png(≤ 1400 px)를 생성하므로 직접 크기를 조정할 필요가 없습니다. 세부 사항은name.tiles/*.png를 사용하세요. - Claude Code: Read 도구를 사용하세요.
- 린트 출력만으로 렌더링을 판단하지 마세요.
- Codex: PNG 경로를 사용하여
- 샌드박스 친화적:
node만 필요합니다. 네트워크 호출이나 설치가 없습니다.- 출력은
--out디렉토리로 이동합니다. 작업 공간 내에 유지하세요(예:./diagram-out). - WebP/HEIC 변환은 시스템 임시 디렉토리를 사용합니다.
- 사용자가 경로 대신 이미지를 붙여넣은 경우: 첨부 파일 경로를 볼 수 있으면 사용하세요. 그렇지 않으면 파일 경로를 물어보세요. 도구가 실제 파일을 필요로 하기 때문입니다.
- 마무리: PNG, SVG 및 JSON의 절대 경로를 나열하여 사용자가 열 수 있도록 하세요.
1. 작업 선택
| 사용자 요청 | 작업 | 다음 읽기 |
|---|---|---|
| "이 이미지를 더 선명하게 / 고해상도로 / 깔끔하게", "redraw / rebuild / 复刻 / 高清重建 this" | A. 이미지에서 재구성. 충실도 우선: 다른 지시가 없으면 원본 스타일 유지 | references/rebuild-from-image.md (필수) |
| "Beautify / tidy / 美化 this diagram" | A + 다듬기. A와 동일한 후 계층, 간격 및 정렬 개선 | references/rebuild-from-image.md |
| 설명, 코드 또는 노트에서 새 다이어그램 생성 | B. 새 다이어그램 | references/spec.md |
| 다른 스타일 적용 ("손글씨로", "플랫 코퍼레이트", "청사진", "논문용") | C. 스타일 변경 | references/style-guide.md |
주어진 이미지에 대해 기본적으로 스타일을 일치시킵니다: 손글씨는 손글씨로, 플랫은 플랫으로 유지하고 색상과 폰트 카테고리도 그대로 유지합니다. 사용자가 요청할 때만 모양을 변경합니다. 프리셋은 시작점일 뿐 한계가 아닙니다. styleOverrides, 사용자 정의 팔레트 및 사용자 정의 폰트 파일("fonts")로 거의 모든 모양을 재현할 수 있습니다. 요청이 진정으로 모호한 경우(예: 참조 스타일 없이 "beautify")에만 충실도 수준에 대해 물어보세요. 그렇지 않으면 충실 + 더 선명하게를 기본값으로 사용하세요.
templates/에서 가장 가까운 템플릿부터 시작하여 작업 폴더에 복사하고 복사본을 편집하세요. 미리보기는 assets/gallery/에 있습니다. 템플릿은 패턴이지 콘텐츠가 아닙니다: 모든 텍스트를 바꾸고 줄 바꿈과 화살표를 소스와 정확히 동일하게 유지하세요. --expect는 누락된 부분과 변경된 문구를 잡아냅니다.
| 템플릿 | 보여주는 내용 |
|---|---|
dense-rebuild.json | 밀집된 아키텍처 이미지 재구성: 명시적 좌표, 카드, 패널, 병합된 커넥터, 인라인 레이블 |
pipeline-rag.json | 왼쪽에서 오른쪽 파이프라인: connect, rightOf, 자동 맞춤 패널이 있는 행 |
layered-architecture-zh.json | 중국어 계층형 아키텍처: 쌓인 below 행, 팬인 화살표, 실린더 |
flowchart-decision.json | 순서도: 알약, 다이아몬드, 예/아니오 분기, 루프백 화살표 |
agent-loop.json | 사이클: 곡선 화살표, 배지, 타원 허브 |
auto-layout.json | 좌표 없음: ELK 자동 레이아웃 및 그룹 |
2. 루프 (모든 작업)
-
먼저 목록을 작성하세요. 모든 텍스트 문자열을 그대로 나열하고(
texts.txt에 한 줄에 하나씩 저장), 모든 노드, 모든 화살표(from → to, 레이블) 및 모든 그룹을 나열하세요. 어떤 것도 새로 만들거나 버리지 마세요. -
템플릿에서 시작하여
name.json을 작성하세요. -
렌더링:
node SKILL_DIR/scripts/render.mjs name.json --out OUT --expect texts.txt -
모든 ERROR를 수정하세요. 각 오류에는 구체적인
→수정 사항이 함께 제공됩니다. 의도하지 않은 WARN은 수정하고, 의도된 WARN은 해당 요소 또는 화살표에"ignore": ["code"]를 사용하여 무음 처리하세요. -
OUT/name.png및OUT/name.tiles/*.png를 확인하고 원본과 비교하세요(scripts/compare.mjs사용).prompts/visual-review.md의 체크리스트를 실행하세요. 린터는 의미, 균형 또는 충실도를 판단할 수 없습니다. -
오류가 0개가 되고 내용이 잘 읽힐 때까지 3
5단계를 반복하세요(보통 24회). -
전달:
name.png: 2x; 인쇄용으로는--scale 3을 사용하세요.name.svg: 벡터.name.json: 추후 편집을 위해 보관.
유지한 항목과 개선한 항목을 한 줄로 추가하세요.
3. 60초 스펙
{
"canvas": { "width": 1600 },
"style": "marker",
"title": "Checkout Service",
"subtitle": "{blue:clients} · {purple:services} · {green:data}",
"elements": [
{ "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
{ "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
"lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
{ "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
{ "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
{ "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
],
"arrows": [
{ "from": "web", "to": "api", "label": "HTTPS" },
{ "from": "api", "to": "db", "label": "INSERT", "color": "green" }
]
}
-
요소 유형:
box(기본값),pill,ellipse,circle,diamond,cylinder,note,card,panel,text,icon,badge,image,path(사용자 정의 SVG 모양) 및 레이아웃 도우미row,column,group. -
각 요소 위치 지정은 다음 중 하나를 사용합니다:
- 왼쪽 위 모서리의 경우
x/y, 또는 중심의 경우cx/cy. below/above/rightOf/leftOf+gap.contains는 자식 주위에 패널을 자동으로 맞춥니다.
크기는 자동입니다. 원본과 정확히 일치시키려면
w/h를 설정하세요. - 왼쪽 위 모서리의 경우
-
텍스트:
title은 굵게 표시되며\n은 줄을 바꿉니다.lines는 본문 줄입니다. 텍스트 내 마크업:**bold**`code`(코드 폰트 사용){green:span}및{muted:span}->(화살표 글리프로 그려짐)
중국어와 영어가 자유롭게 혼합됩니다. 요소별로
size,textSize,font,textColor및align을 설정할 수 있습니다. -
색상은 계열(
blue purple green orange red teal yellow pink gray navy), 음영(blue.tint),#hex또는 일반 CSS 이름(예:white)을color,fill,stroke및textColor를 통해 설정합니다. -
화살표는
from을to에 연결합니다:- 측면에 고정하고
"id.right"또는"id.right+20"으로 슬라이드합니다. - 레이블:
label,labelPos(above,below,left,right또는inline)로 배치하고labelAt으로 조정합니다. - 모양:
dash,color,width및head(end,start,both또는none). - 경로:
via포인트,points(정확한 폴리라인) 또는"route": "curve".
- 측면에 고정하고
모든 키는 references/spec.md에 있습니다.
4. 모양: 스타일, 팔레트, 폰트, 효과
-
스타일 프리셋:
- 손글씨:
marker(기본값),neat,excalidraw,sketchy,whiteboard,pencil,blueprint,chalk. - 깔끔함:
clean,paper.
styleOverrides를 통해 모든 프리셋 필드를 재정의할 수 있습니다:roughness(0 = 완벽하게 직선) 및bowingfillStyle(solid,hachure,cross-hatch,dots또는none)strokeScale,cornerRadiusshadow(none,soft또는hard)font,cjkFont,codeFont,background
- 손글씨:
-
팔레트:
marker,pastel,excalidraw,mono,academic,colorblind,modern,blueprint,chalkboard,midnight. 원본의 색상을 정확히 재현하려면node SKILL_DIR/scripts/palette.mjs original.png을 실행하고 결과를 붙여넣으세요. -
폰트:
- 손글씨:
shantell,kalam,caveat,patrick,architects. - 산세리프:
inter. 세리프:serif. 모노:mono. - CJK:
kai(손글씨),kuaile(장난기 있는),sans-sc(깔끔함). - 사용자
.ttf/.otf/.woff:"fonts": {"brand": {"regular": "Brand.ttf", "bold": "Brand-Bold.ttf"}}, 그 다음"font": "brand".
- 손글씨:
-
카탈로그:
assets/gallery/styles.png,palettes.png및fonts.png.scripts/catalog.mjs로 다시 생성하세요. -
아이콘: 1,500개 이상의 Lucide 아이콘.
node SKILL_DIR/scripts/icons.mjs search 数据库 robot queue로 검색하고icons.mjs sheet a,b,c로 미리보기. -
원본 이미지 도구:
grid.mjs: 원본에 좌표 오버레이. 빨간색 축 레이블을 읽고, 픽셀 위치는 읽지 마세요.fontmatch.mjs: 원본의 확대된 부분 옆에 모든 폰트로 샘플 텍스트를 표시합니다.palette.mjs: 원본의 색상을 추출합니다.crop.mjs: 로고, 사진 또는 스크린샷을 잘라서image요소로 포함시킵니다.compare.mjs: 나란히 비교 검토합니다. 두 이미지를 동일한 영역으로 확대하려면--crop x,y,w,h를 추가하세요.
-
어두운 테마 또는 대체 버전: 동일한 스펙을 유지하고
palette(midnight,blueprint또는chalkboard) 또는style만 변경한 다음 다른--name으로 렌더링하세요. -
슬라이드용 (PPT, Keynote):
"canvas": {"aspect": "16:9"}는 이미지를 슬라이드 비율로 패딩합니다."background": "transparent"는 알파 채널이 있는 PNG를 제공합니다. SVG도 직접 붙여넣을 수 있습니다.
5. 명확성 규칙 (항상 적용)
- 단어를 정확히 유지하세요: 레이블, 코드 식별자 및 중국어 용어. 요청하지 않는 한 텍스트를 만들거나, 번역하거나, 삭제하지 마세요.
- 계층 구조를 보이게 만드세요:
- 상자당 굵은 제목.
- 식별자는 본문 또는
code텍스트로. - 설명은
muted텍스트로. - 섹션 제목은 해당 섹션의 색상으로.
- 색상은 의미가 있습니다: 영역 또는 역할당 하나의 계열, 일관되게 사용됨. 화살표 레이블은 화살표의 색상을 상속합니다.
- 숨 쉴 공간:
- 레이블이 있는 화살표로 연결된 도형 사이 ≥ 60px, 그 외에는 ≥ 24px.
contains로 패널 맞춤.- 경계선 위에 레이블 없음.
- 축소 시 읽기 가능:
- 텍스트 ≥ 18px (기본값: 노드 30, 본문 25, 레이블 24).
- 캔버스 너비 1400–2200px, 종횡비 1:2에서 3:1 사이. 린터가 그렇지 않으면 경고합니다.
- 6개 이상의 노드로 구성된 긴 체인: 2-3줄로 구부리거나 ELK
"direction": "DOWN"을 사용하여 매우 긴 단일 행을 피하세요.
- 교차점이 적고 우회로가 없습니다.
via를 추가하기 전에 정렬하고 재정렬하세요. - 재구축 작업에서는 재설계하지 말고 다듬으세요: 정렬, 간격 및 계층 구조를 개선하지만 토폴로지, 읽기 순서 및 스타일 정체성은 유지하세요.
6. 완료 조건
-
render.mjs가 0개의 오류를 보고합니다. 남아 있는 경고는 의도된 것이며ignore로 무음 처리됩니다. - 모든 목록 문자열이 존재하고 정확히 철자되었습니다(
--expect texts.txt통과). - PNG와 타일을 보았으며, 재구축의 경우 원본과 나란히 비교했습니다: 동일한 구조, 동일한 스타일 정체성, 더 선명함.
- PNG, SVG 및 JSON을 짧은 "유지 / 개선" 노트와 함께 전달했습니다.
7. 문제 해결
node: command not found: Node 18+를 설치하세요. 다른 것은 필요하지 않습니다.- WebP, HEIC, BMP 또는 TIFF 입력은
sips,magick,dwebp,ffmpeg또는 Python PIL을 사용할 수 있을 때 자동으로 변환됩니다. 그렇지 않으면 사용자에게 PNG 또는 JPEG를 요청하세요. - 문자가
?로 렌더링됨: 번들 폰트는 라틴 문자, GB2312 중국어 및 공통 기호를 다룹니다. 문구를 바꾸거나 해당 문자가 있는 폰트를 등록하세요. - 모든 린트 코드 및 수정 사항은
references/troubleshooting.md를 참조하세요.