스킬 자체의 표현으로
extract-static-html, extract-design-md, upload-to-stitch 세 개의 skill을 연결하여 기존 프론트엔드 코드베이스(React + Vite, Next.js, Angular, Vue)를 Stitch Design으로 변환합니다. 실행 중인 앱이나 빌드된 웹 디렉터리를 Stitch로 옮겨 그곳에서 반복 작업을 하려는 디자이너와 개발자를 대상으로 합니다.
이 워크플로우는 독립적인 HTML 파일 하나를 추출하고, 디자인 시스템을 .stitch/DESIGN.md에 작성한 뒤, Stitch에 디자인 시스템을 생성하고, 마지막으로 페이지의 라우트 경로로 제목이 지정된 화면으로 HTML을 업로드합니다. 이는 저장, 마이그레이션 또는 업로드 요청에 필요한 경로이며, HTML 검증은 선택 사항이고 실행을 결코 차단하지 않습니다.
산출물
- 독립적인 HTML 파일 하나, 예를 들어 /path/to/extracted/standalone.html입니다.
- DESIGN.md로 작성된 디자인 시스템 설명입니다.
- 이름과 제목이 애플리케이션 내 출처 라우트를 식별하는, Stitch에 업로드된 화면입니다.
작동 방식
- 01독립적인 HTML 파일 추출하기
extract-static-html skill로 작업을 넘기며, 이는 빌드 출력물이나 Vite, Angular CLI의 ng serve 같은 실행 중인 개발 서버를 기반으로 작동하여 독립형 HTML 파일 하나를 생성합니다.
- 02중단 없이 검증 제공하기
추출이 끝나면 사용자에게 파일 위치를 알려주어 브라우저에서 직접 확인할 수 있도록 하며, 실행은 이와 무관하게 다음 단계로 계속됩니다.
- 03소스를 디자인 시스템으로 분석하기
extract-design-md 스킬은 프로젝트의 컴포넌트, 스타일시트, 테마 설정을 읽고, 그 결과를 디자인 시스템 파일로 작성합니다.
- 04Stitch에서 디자인 시스템 생성하기
manage-design-system 스킬은 DESIGN.md를 업로드하고 필요한 스키마와 함께 create_design_system_from_design_md를 호출합니다.
- 05HTML을 화면으로 업로드하기
동일한 업로드 스크립트가 Stitch API 키와 projectId를 사용해 단독 HTML을 전송하며, title 인자는 페이지 라우트로 설정되어 Stitch에서 해당 화면을 식별할 수 있습니다.