HTML 다이어그램 및 덱
이 스킬(에이전트 스킬: Claude Code, GitHub Copilot 및 기타 에이전트가 이를 읽습니다)은 두 개의 소형 그림 라이브러리, 덱 엔진, 세 가지 테마 및 세 가지 템플릿을 제공합니다. 각 결과물은 GSAP이 캐시되면 오프라인에서 작동하는 하나의 HTML 파일이며, 뷰어의 라이트 또는 다크 테마를 따르고, claude.ai 아티팩트로 게시할 수 있습니다.
| 경로 | 설명 |
|---|---|
lib/edgediagram.js | 선언적 SVG 그래프: zone, node, text, link (기본적으로 직교, 화살표, 레이블, 패킷 흐름), fan (하나의 지점에서 여러 노드로 연결), bindFocus, steps, 그리고 모든 단계에서 레이아웃 검사 |
lib/edgesketch.js | 그리드 위 손그림 그림: zone, box (텍스트에 맞춰짐, 세로 열 및 중앙 막대), arrow (직각, 두 머리), connect (박스 간 연결), fan, text, 그리고 EdgeSketch.check (모든 SVG, 비스듬하고 구부러진 와이어 포함) |
lib/icons.js | window.EDGE_ICONS: 24유닛 그리드의 50개 라인 아이콘 (그리드 장비, 컴퓨팅, 트러스트, 운영) |
lib/edgedeck.js | EdgeDeck.run: 슬라이드별 단계, 캡션, 키보드, 스와이프 및 #n 링크가 있는 1600×900 슬라이드 스테이지 |
themes/*.css | 하나의 토큰 계약에 따른 색상 및 서체 테마, 라이트 및 다크: engineering (녹회색에 파랑, Archivo Narrow 및 IBM Plex), indigo (라벤더회색에 남색, Space Grotesk 및 Inter), drafting (따뜻한 종이에 청록, Barlow Condensed 및 Source Sans 3) |
templates/diagram.html | 캡션, 이전/다음 및 점이 있는 단계별 EdgeDiagram 그림 |
templates/sketch.html | 손그림 EdgeSketch 그림: 왼쪽에서 오른쪽 영역, 열, 서비스, 양방향 화살표, 범례 |
templates/deck.html | 제목 슬라이드와 다이어그램이 단계별로 구성되는 콘텐츠 슬라이드 |
scripts/inline.py | 라이브러리 파일과 테마를 페이지에 인라인하여 하나의 파일로 게시, 찾을 수 없는 항목이 있으면 실패 |
scripts/shot.sh | 헤드리스 스크린샷 (라이트 또는 다크, 모든 너비, 지정된 클릭 후, --only 하나의 요소, --full 페이지) 및 --check (페이지의 모든 그림에 대한 레이아웃 검사) |
scripts/todrawio.sh | 빌드된 페이지의 그림 하나를 draw.io 파일로 내보내어 편집 가능: 연결된 링크가 있는 EdgeDiagram 그림, 손그림 SVG 그림, HTML 그림 |
scripts/check_theme.py | 라이트 및 다크에서 테마의 WCAG 대비를 확인하고, 두 개의 다크 블록이 일치하는지 확인 |
scripts/theme_from_design.py | DESIGN.md 파일(브랜드 색상 및 서체)에서 라이트 및 다크 테마 생성, 모든 쌍이 대비 조건 충족 |
scripts/test.sh | tests/의 테스트 실행, lib/, scripts/ 또는 themes/ 변경 후 실행 |
scripts/vendor.sh | 라이브러리를 다른 프로젝트로 복사, --check는 복사본이 뒤쳐졌는지 표시 |
references/api.md | 두 라이브러리와 덱 엔진의 모든 옵션 |
references/conventions.md | 토큰, 각 톤의 의미, 레이아웃 규칙, 게시 및 실행할 검사 |
examples/ci-canary-deck.html | 중립적인 워크플로(CI/CD, 이어서 카나리 롤아웃)에 대한 완전한 두 슬라이드 덱 |
examples/isometric/ | 등각 투영 계층 그림 생성기(SGAM 큐브), 교훈 포함 |
examples/design-md/DESIGN.md | 샘플 DESIGN.md (Harbor) — 테마 생성용 |
워크플로
- 그림이 무엇을 보여줘야 하는지 결정하세요. 메커니즘, 그것이 의존하는 부분, 그리고 그것을 공개할 순서를 이름 붙이세요. 그림보다 더 빠르게 설명하는 한 문장이 더 낫습니다.
- 라이브러리를 선택하세요. 의미 있는 와이어로 연결된 부분들의 그래프를 단계별로 공개: EdgeDiagram (
templates/diagram.html). 박스 그리드, 계층형 스택 또는 왼쪽에서 오른쪽 플랫폼 뷰로 배열이 의미를 전달: EdgeSketch (templates/sketch.html). 프레젠테이션:templates/deck.html, 슬라이드에서 두 라이브러리 모두 사용 가능. - 템플릿을 작업 디렉토리로 복사하세요. 예:
cp <skill>/templates/sketch.html ./my-figure.html.<script src>및 테마 경로가<skill>/lib/및<skill>/themes/를 가리키도록 수정하거나, 마지막에--lib및--themes와 함께inline.py를 실행하세요. - 그리드 위에 배치하세요. viewBox를 선택한 다음, 영역, 박스(동일한 크기, 균일한 간격), 와이어(아래 커넥터 참조)를 선택하세요. 서로 통신하는 박스는 같은 행이나 열에 배치하여 와이어가 하나의 직선이 되도록 하세요. 의미를 전달하는 링크에는
info를 추가하세요. 옵션은references/api.md를 참조하세요. - 단계를 작성하세요 (EdgeDiagram). 단계 0은 정지 상태입니다. 각 이후 단계는 하나의 아이디어를 추가하고 짧은 캡션을 갖습니다. 움직이는 데이터에는
flows를 사용하고, 단계가 지나간 내용에는dim또는hide를 사용하세요. - 테마. 페이지는 하나의 테마를 링크합니다:
<link rel="stylesheet" href="../themes/engineering.css">, 이름을 바꾸면 테마가 변경됩니다.engineering은 조밀한 기술 자료용,indigo는 제품 및 소프트웨어 전달용,drafting은 문서처럼 읽히는 제안 및 연구용입니다. 각 톤의 의미를 유지하세요(references/conventions.md). 브랜드의 모양을 위해서는 DESIGN.md에서 테마를 만드세요:python3 <skill>/scripts/theme_from_design.py DESIGN.md -o themes/<name>.css(examples/design-md/DESIGN.md는 샘플입니다). 수동으로는 테마를 복사하고, 모든 토큰 이름을 유지한 채 값을 변경한 후,scripts/check_theme.py themes/<name>.css를 실행하여 통과할 때까지 조정하세요. - 빌드, 검사 및 확인:
python3 <skill>/scripts/inline.py my-figure.html > build/my-figure.html <skill>/scripts/shot.sh --check build/my-figure.html # 모든 그림; 문제가 있으면 exit 1 <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-light.png light 1280 <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-dark.png dark 1280 <skill>/scripts/shot.sh build/my-figure.html /tmp/sN.png dark 1280 'for(var i=0;i<5;i++)document.getElementById("next").click()'--check가 보고하는 모든 것을 수정하세요. 그런 다음 PNG를 열고 검사가 볼 수 없는 문제(그리드에서 벗어난 박스, 충돌하는 화살촉 또는 빡빡한 레이블)를 수정하고, 너비 420에서 다시 확인하세요. 스크린샷은 패킷이 와이어 시작 부분 근처에서 멈추므로 실제 브라우저에서 동작을 판단하세요. - 요청 시 편집 가능한 복사본을 제공하세요.
<skill>/scripts/todrawio.sh build/my-figure.html <svg id 또는 선택자> out.drawio "이름"은 빌드된 페이지의 그림 하나를 라이트 테마와 마지막 단계에서 draw.io 파일로 씁니다. 전달되지 않는 것은 다음과 같습니다: 애니메이션, 단계, 툴팁, 그리고 사각형과 타원 이외의 채워진 모양(누락된 개수를 출력합니다). - 게시하세요. 인라인된 파일이 페이지입니다: 파일로 공유하거나, 커밋하거나, Claude에서 아티팩트 도구에 제공하세요(업데이트하려면 동일한 경로나 URL을 다시 게시).
커넥터
와이어는 독자가 따라가는 것이므로 의도적으로 보여야 합니다:
- 수평 및 수직만. 대각선이나 곡선은 절대 안 됩니다. EdgeDiagram 링크는 기본적으로
ortho입니다:route를 생략하세요.'straight'는 두 끝이 이미 정렬된 경우에만,'curve'는 사용자가 요청한 경우에만 사용하세요. EdgeSketch에서는s.arrow,s.connect및s.fan을 사용하며, 이들은 직각으로 꺾입니다. 직접 작성하는 SVG에서는H및V경로 명령으로 와이어를 그리고 모서리만 둥글게 하세요. - 박스가 서로 마주볼 때 하나의 직선. 위치(
t)를 생략하면 EdgeDiagram 또는s.connect는 두 박스가 범위를 공유할 때 두 끝을 정렬합니다. 검사가 몇 픽셀의 꺾임을 보고하면 끝이 정렬되도록 박스를 이동하세요.t를 조정하지 마세요. - 여러 박스에 연결되는 하나의 소스는 별도 와이어 묶음이 아닌 팬입니다.
d.fan(id, {from: [src, 'bottom'], to: ['a', 'b', 'c']})또는s.fan(src, 'bottom', [a, b, c])는 줄기, 직각의 버스, 각 박스로의 분기를 그리며, 각 접합점에 점이 있습니다. 여러 박스가 하나로 연결되는 것은 목록을 바꾼 같은 팬입니다 ({from: [[...], ...], to: [...]}또는{into: true}). - 적은 굽힘, 교차 없음. 각 와이어가 최대 두 번 꺾이도록 면을 선택하세요. 같은 면을 공유하는 와이어를 펼치세요 (
'auto'). 박스를 통과하지 말고 주위로 우회하세요. shot.sh --check는 비스듬하고, 구부러지고, 꺾인 와이어를 보고합니다. 다른 문제처럼 수정하세요. 등각 투영 그림과 같은 의도적인 예외는data-route="free"로 표시하세요.
규칙
- 다른 라이브러리를 사용하지 마세요. cdnjs의 GSAP 3은 선택 사항입니다: 없으면 각 단계가 최종 상태를 표시합니다.
- 모든 색상은 토큰에서 오므로 구성 요소에 리터럴 색상이 포함되지 않습니다.
info가 있는 모든 노드, 박스 또는 링크는 키보드로 포커스 가능합니다. SVG에는role="img"와 그림이 주장하는 내용을 명시한aria-label이 있습니다.- 전화기보다 넓은 그림은 자체
overflow-x: auto컨테이너 내에서 스크롤되며, 페이지는 스크롤되지 않습니다. - 공유될 페이지에서 내부 이름, 고객 이름 및 주소를 보관하지 마세요.