Prompt to Canvas
사용자 제공 콘텐츠를 세련되고 편집 가능한 Excalidraw 캔버스로 만드는 디자인 시스템 스킬입니다. 에이전트가 레이아웃을 구성하고, 번들된 스타일 카탈로그를 사용하여 시각적 방향을 설정하며, SVG 소스를 제작한 후 편집 가능한 Excalidraw 씬 JSON으로 변환하고 로컬 편집기에서 엽니다.
이는 자동 차트 생성기나 템플릿 채우기 도구가 아닙니다. 스타일은 팔레트와 분위기를 제공하며, 에이전트가 주제, 구조, 그룹화, 계층, 레이블 및 연결을 결정합니다.
사용자가 명시적으로 다른 언어를 요청하지 않는 한, 캔버스에 표시되는 텍스트(제목, 섹션 레이블, 주석, 캡션)는 사용자의 주요 대화 언어를 사용합니다. 기술 용어, 제품명, API 이름, 약어, 코드 식별자, 측정값, 인용된 원문 구절은 원래 언어 그대로 두는 것이 명확할 경우 그렇게 합니다.
사용 시기
- 사용자가 편집 가능한 캔버스, 인포그래픽, 다이어그램, 아키텍처 그래픽, 타임라인, 비교 자료, 대시보드, 개념 지도, 프레젠테이션용 시각 자료를 원할 때.
- 사용자가 콘텐츠를 주고 "그려줘", "시각화해줘", "캔버스로 만들어줘", "포트폴리오 보드를 만들어줘"라고 요청하거나 이 스킬을 직접 언급할 때.
- 결과물이 세련되고, 편집 가능하며, 내보낼 수 있고, 시각적으로 스타일링되길 원할 때.
0단계: 사전 조건
scripts/preflight.sh를 실행하거나 수동으로 확인합니다.
- Node 20 이상.
assets/editor/index.html파일이 존재해야 함.scripts/svg-to-scene.mjs,scripts/validate-scene.mjs,scripts/open-editor.mjs파일이 존재해야 함.CATALOG.md,RULES.md,templates/,assets/styles/디렉토리가 존재해야 함.
누락된 항목이 있으면 사용자에게 알리고 중단합니다.
대화 진행 방법
- 캔버스 이해하기. 콘텐츠, 목적, 대상을 식별합니다. 보드의 방향을 결정하기에 충분하지 않은 경우, 제작 전에 짧은 질문 하나를 합니다.
- 호스트가 구조화된 선택 옵션을 지원하면 그것을 사용합니다. 그렇지 않으면 간결한 텍스트 질문을 합니다.
- 2-3개의 추천 옵션을 제시하고, 추천 옵션을 먼저 배치합니다. 프롬프트에 충분한 맥락이 있을 경우 사용자 언어로 "에이전트 선택" 옵션을 포함합니다.
- 분위기 묻기. 시각적 스타일(차분한, 전문적인, 장난기 있는, 대담한, 브랜드 스타일, 색상 선호, 무드)을 물어봅니다. 사용자가 선호도가 없으면 에이전트가 선택하겠다고 제안합니다. 사용자가 이미 스타일이나 분위기를 언급했다면 이 단계를 건너뜁니다.
- 호스트가 선택 옵션을 지원하면 사용합니다.
- 옵션을 카탈로그 수준(차분한, 균형 잡힌, 대담한)에 매핑합니다.
- 스타일 고르기.
CATALOG.md를 사용하여 하나의 스타일을 선택합니다. 카탈로그 테이블에서만 선택하고, 여러design.md파일을 비교하지 않습니다. 선택한 스타일과 그 이유를 한 줄로 사용자에게 알립니다. - 제작하기.
RULES.md,rules/canvas-rules.md,rules/visualization-strategy.md, 그리고 선택한templates/<slug>/design.md만 읽은 후:rules/analysis-prompt.md를 비공개 편집 체크리스트로 사용: 대상, 결과물의 역할, 핵심 주제, 주요 개체, 관계, 절충점, 캔버스에 담을 만한 3-6개의 주장을 결정합니다.- 사용자가 달리 요청하지 않는 한, 캔버스에 표시되는 텍스트(제목, 섹션 레이블, 주석, 캡션)는 사용자의 주요 대화 언어로 작성합니다. 기술 용어, 제품명, API 이름, 약어, 코드 식별자, 측정값, 인용된 원문 구절은 원래 언어 그대로 두는 것이 명확할 경우 그렇게 합니다.
- 먼저
diagram.svg를 1600-1700px 너비의 논리적 공간에 작성합니다. 기본 SVG 도형(rect,circle,ellipse,line,polyline,text)을 사용합니다. 모든 보이는 레이블은text로 유지합니다. - Excalidraw 무한 캔버스 배경은 흰색으로 유지합니다. 선택한 스타일에 색상이 있는 종이/배경이 있다면 씬 내부의 편집 가능한 사각형으로 그립니다. 절대
appState.viewBackgroundColor에 해당 색상을 넣지 마십시오. - 스타일 선택과 Excalidraw 캔버스 배경은 독립적으로 유지합니다. 콘텐츠, 대상, 격식 수준, 분위기에 따라 선택합니다. 템플릿의 종이/배경 색상은 씬 내부의 편집 가능한 사각형으로 시각적 결과물의 일부로 남습니다.
- 완성된 결과물 콘텐츠만 캔버스에 배치합니다. 프롬프트, 출처, 파일 경로, 선택한 스타일 또는 프로세스에 대한 맥락은 채팅 응답에 속합니다.
- 선택한 스타일을 시각적 시스템(팔레트, 밀도, 선, 모서리 처리, 계층, 악센트 사용법, 레이아웃 분위기)으로 적용합니다.
- SVG를 편집 가능한 Excalidraw 씬 JSON으로 변환합니다.
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- 씬을 검증합니다.
node scripts/validate-scene.mjs --scene scene.json
명확한 언어/문자 체계 기대치가 있는 경우 함께 검증합니다.
node scripts/validate-scene.mjs --scene scene.json --expected-language <language-code>
- 열린 편집기 또는 렌더링된 내보내기를 검사합니다. 텍스트 잘림, 좁은 간격, 약한 계층, 우연한 겹침, 오래된 샘플 텍스트, 스타일 이탈을 수정합니다.
diagram.svg를 수정하고 재변환하는 것을 선호하며, 씬 JSON 편집은 Excalidraw 특화 정리에만 사용합니다.
- 편집기 열기. 다음 명령을 사용합니다.
node scripts/open-editor.mjs --scene scene.json
각 호출은 독립적인 로컬 편집기 URL을 시작합니다. 새 캔버스, 다른 템플릿, 재생성된 버전마다 이전 URL을 재사용하지 말고 이 명령을 사용합니다. 기본적으로 스크립트는 새로운 사용 가능한 포트로 이동하여 고유한 캐시 없는 URL에서 씬을 제공합니다. open-editor.mjs 프로세스가 중지되거나 호스트 세션이 종료되면 포트가 해제됩니다.
- 전달하기. 사용자에게 표시된 로컬 URL을 알려줍니다. 편집기가 중국어/영어 UI 전환, 새로고침에 안전한 로컬 자동 저장, PNG/SVG 내보내기를 지원한다고 언급합니다. 동일한 콘텐츠를 다른 스타일로 다시 렌더링해주겠다고 제안합니다.
파일
CATALOG.md: 분위기, 격식, 팔레트 시그니처가 포함된 35가지 스타일.RULES.md: 스타일 시스템이 공유하는 SVG 매체 규칙.templates/<slug>/design.md: 스타일별 팔레트 및 분위기 가이드.assets/styles/: 스타일 미리보기 이미지.rules/analysis-prompt.md: 비공개 콘텐츠 구성 체크리스트.rules/canvas-rules.md: Excalidraw 씬 및 검증 규칙.rules/visualization-strategy.md: 레이아웃 및 스타일 일관성 지침.scripts/preflight.sh: 의존성 및 리소스 확인.scripts/svg-to-scene.mjs: SVG를 편집 가능한 Excalidraw로 변환.scripts/validate-scene.mjs: 씬 스키마 검증기.scripts/open-editor.mjs: 로컬 편집기 서버 및 씬 로더. 별도 생성을 위해 기본적으로 새 포트를 할당합니다.
스모크 테스트
scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open