새 Tsumu 웹사이트 만들기
사용자가 Tsumu에서 새 웹사이트를 만들어 달라고 요청할 때 사용합니다. 결과물은 실제로 편집 가능한 Tsumu 사이트여야 하며, 디자인 설명, 스크린샷, HTML 목업 또는 빈 사이트가 아닙니다.
결과물: 비공개 Tsumu 가져오기 링크
사용자가 요청한 새 사이트의 경우, stage_site_doc의 성공적인 결과에는 importUrl이 포함됩니다. 이는 요청자가 생성된 사이트를 Tsumu에서 열기 위해 사용하는 전달 아티팩트입니다. 무엇이 구축되었는지에 대한 간략한 설명과 함께 정확한 링크를 포함하십시오. 링크에 대한 추가 요청은 필요하지 않습니다. 링크는 비공개이며 로그, 관련 없는 컨텍스트 또는 타사 서비스에 복사되어서는 안 됩니다. 절대 링크를 임의로 생성하거나 재구성하지 마십시오.
스테이징된 링크는 가져오기, 게시 또는 배포의 증거가 아닙니다. 그러한 작업이 발생했다고 주장하지 마십시오.
워크플로 선택
- 새 사이트 만들기: 기존 사이트가 연결되어 있지 않더라도
stage_site_doc을 직접 사용하십시오. 사용자는 MCP OAuth 화면에서 사이트 연결 코드 없이 새 사이트 생성만 승인할 수 있습니다. 기존 연결 사이트 권한으로도 새 사이트를 스테이징할 수 있습니다. - 대신 사용자의 기존 사이트 편집:
tsumu-edit-site를 활성화하고 연결된 편집 도구를 사용하십시오. 사본을 스테이징하거나 기존 사이트를 덮어쓰지 마십시오. - 스테이징 도구가 없거나 성공적인 권한 부여가 없는 경우: URL을 조작하지 마십시오. 아티팩트 생성이 가능하다면 유효한 다운로드 가능한
doc.json을 생성하십시오. 그렇지 않으면 누락된 기능과 수행 가능한 작업을 설명하십시오. create_site는 이미 연결된 편집기에서 빈 브라우저 로컬 사이트를 생성하기 위한 것입니다. 전체 생성된 디자인을 업로드하지 않으며 새 사이트를 다시 연결해야 합니다.stage_site_doc의 대체품으로 사용하지 마십시오.
2단계 생성: 자유롭게 디자인한 후 Tsumu로 변환
1단계 — SiteDoc 형식으로 작업하기 전에 원본 웹사이트 콘셉트를 만듭니다. 사용자의 요청을 샘플 JSON 문서를 리스킨하라는 지시가 아닌 웹사이트 디자인 브리프로 취급하십시오.
- 사이트의 목적, 대상 청중, 핵심 메시지, 페이지, 콘텐츠 우선순위 및 기본 사용자 행동을 결정하십시오. "멋진 웹사이트를 만들어줘"와 같은 모호한 요청의 경우, 샘플 포트폴리오를 기본값으로 사용하거나 불필요한 질문을 하지 말고 독립적으로 독특하고 그럴듯한 콘셉트를 선택하십시오. 실제 주소, 사용 후기, 제품 주장 또는 가격을 만들지 마십시오.
- Tsumu의 노드 스키마가 존재하지 않는 것처럼 웹사이트를 디자인하십시오. 원본 정보 아키텍처, 페이지별 콘텐츠, 섹션 구성, 계층 구조, 타이포그래피, 색상, 이미지 또는 그래픽 요소, 간격 및 반응형 동작을 계획하십시오. 일반적인 히어로/특징/사용후기/연락처 템플릿을 기계적으로 반복하지 마십시오.
- 도구와 시간이 허락된다면, 레이아웃을 자유롭게 탐색하기 위해 독립형 HTML/CSS 프로토타입(및 명확한 상호작용 노트)으로 전체 디자인을 초안하십시오. 그렇지 않으면 동등하게 구체적인 페이지 및 컴포넌트 청사진을 준비하십시오. 이는 중간 디자인 아티팩트이며 최종 결과물이 아니며, Tsumu가
stage_site_doc을 통해 임의의 HTML을 가져올 수 있다는 주장이 아닙니다. 사용 가능한 라이브 미리보기가 없으면 요구하지 마십시오. - 브리프에 대해 초안을 비판적으로 검토하십시오: 식별 가능한 시각적 정체성, 신뢰할 수 있는 콘텐츠, 목적 있는 섹션, 명확한 사용자 여정 및 모바일 레이아웃이 있습니까? 예제 SiteDoc 레이아웃을 참조하기 전에 개선하십시오.
2단계 — 해당 디자인을 기본 편집 가능한 Tsumu SiteDoc으로 변환합니다. 이제서야 get_site_doc_spec, 스키마 가이드 및 최소 예제를 참조하여 유효한 데이터 형태를 학습하십시오. 이는 사이트가 어떻게 보여야 하는지 결정하기 위함이 아닙니다. Tsumu가 지원하는 기본 요소, 스타일, 에셋 및 상호작용을 사용하여 설계된 페이지와 레이아웃을 재구축하십시오. 중간 디자인의 독특한 구성, 타이포그래피, 간격, 콘텐츠 및 반응형 의도를 단순히 색상이 변경된 예제로 축소하지 말고 유지하십시오. 지원되지 않는 세부 사항이 있으면 가장 가까운 유효한 편집 가능한 표현으로 조정하거나 제한 사항을 공개하십시오. 절대 스키마 필드를 임의로 만들지 마십시오.
독창성 확인: 스테이징하기 전에 변환된 SiteDoc을 1단계 디자인과 비교하십시오. 최종 사이트가 단어, 색상 또는 이미지만 변경된 번들 예제와 본질적으로 동일하다면 변환에 실패한 것입니다. 구조와 구성을 재설계하십시오. 사용자가 특정 템플릿을 명시적으로 요청한 경우 해당 요청을 따르십시오.
원본 디자인을 SiteDoc으로 변환
SiteDoc을 구성하기 전에: 읽기 전용 MCP 도구 get_site_doc_spec을 호출하고 guide와 example을 모두 검사하십시오. 이 작업은 원본 디자인을 계획한 후 SiteDoc 페이지, 노드, 스타일, 스크립트 또는 첫 번째 stage_site_doc 시도를 생성하기 전에 수행하십시오. 새 사이트 전용 OAuth 권한으로 참조를 사용할 수 있습니다. 스킬 텍스트가 로드되었다고 해서 건너뛰지 마십시오. 일부 MCP 클라이언트는 참조를 자동으로 가져오지 않습니다. 사양 도구를 사용할 수 없는 경우 references/site-doc.md 및 references/minimal-site.json을 대신 읽으십시오. 절대 데이터 형태를 추측하지 마십시오.
- 1단계 웹사이트의 페이지 맵, 콘텐츠 및 구성을 SiteDoc으로 변환하십시오. 예제 JSON으로 시작하여 복사본이나 팔레트를 바꾸지 마십시오. 가이드와 예제는 유효한 속성과 관계만 설명합니다. 고급 기능이 필요하면 접근 가능할 때 현재 Tsumu
lib/types.ts,lib/presets.ts,lib/site-import-format.ts및skills/tsumu/references/site-doc.md를 참조하십시오. - 완전한
SiteDoc객체(JSON 문자열, HTML 페이지 또는 압축 파일이 아닌)를 구성하십시오. 필수 필드:schemaVersion: 1, 비어 있지 않은siteName,pages,pageOrder,nodes,assets. 홈페이지의slug는 ""입니다. 페이지 및 노드children은 노드 ID를 참조합니다. 노드는 편집 가능한box,image등입니다. 텍스트와 제목은box.text를 사용하고, 임의로 만든heading노드를 사용하지 마십시오. - 설계된 구조와 일치하는 의미 있는 기본 페이지 레이아웃을 만드십시오. 노드에 적절한 의미론적 레이블, 스타일 및 반응형 재정의를 제공하십시오. 1단계의 실제 계층 구조, 간격, 타이포그래피 대비, 시각적 악센트 및 섹션 변형을 유지하십시오. 탐색 대상, 대체 텍스트, 대비 및 모바일 동작을 확인하십시오. 깨진 에셋, 빈 링크, 플레이스홀더 콘텐츠 및 화면 밖 요소를 피하십시오.
- 디자인에 애니메이션, 스크립트, 컴포넌트 또는 양식 동작이 포함된 경우 정확한 현재 유형 정의를 참조하고 지원되는 구조만 구현하십시오. 스크립트 요소 대상은 대상 노드의 HTML
attrId를 사용하며 SiteDoc 노드 ID가 아닙니다.@self는 요소에 첨부된 스크립트에만 사용됩니다. 모든 중첩 단계와 조건을 확인하십시오. 모션 또는 스크립트 속성을 임의로 만들거나 비활성 버튼을 기능적이라고 설명하지 마십시오. stage_site_doc은 완전한 SiteDoc만doc(직렬화된 JSON 최대 12MiB)으로 허용합니다. 1단계 HTML 프로토타입, ZIP 또는 별도의 바이너리 에셋은 허용되지 않습니다. 가능한 경우assets: {}, 적절한 경우 확인된 외부 이미지, 또는 제한 내에서 작은 내장dataUrl에셋을 사용하십시오. Tsumu 저장소 경로를 임의로 만들지 마십시오.- 결과 SiteDoc을 샘플의 미학이 아닌 원본 디자인과 비교하여 검토하십시오. 완전히 편집 가능하고 구조적으로 유효한지 확인하십시오. 변환으로 인해 독특한 레이아웃이나 콘텐츠가 손실된 경우 스테이징 전에 기본 요소 계층 구조를 개선하십시오.
확인 및 전달
- 스테이징하기 전에 최종 페이지를 1단계 디자인과 비교하여 충실하고 독립적으로 구성된 웹사이트이며 최소 예제를 리스킨한 것이 아닌지 확인하십시오. 사용자가 요청하지 않는 한 디자인 중간 결과물을 비공개로 유지하십시오. 최종 결과물로 SiteDoc 또는 가져오기 링크를 전달하십시오.
- 스테이징하기 전에 모든 보이는 디자인 선언이
nodes[id].styles.base.default또는 관련 반응형 재정의에 배치되었는지 확인하고, 임의로 만든style,css또는className필드에 배치되지 않았는지 확인하십시오. 실제 CSS 선언 값은 문자열이어야 합니다. ID, 참조, 비순환 트리 및 가져오기 규칙을 확인하십시오. 도구가 허용하는 범위 내에서 페이지 계층 구조, 응답성 및 요청된 상호작용을 확인하십시오. 실제로 미리보지 않았다면 미리봤다고 말하지 마십시오. stage_site_doc({ doc: <완전한 SiteDoc> })을 호출하십시오.editorOrigin은 사용자가 특정 자체 호스팅 Tsumu 설치를 요청하는 경우에만 사용하십시오.- 성공적인 새 사이트 핸드오프에는 요청자를 위한 클릭 가능한 링크로서 도구의 정확한
importUrl과 이를 열면 편집 가능한 새 사이트를 가져온다는 간략한 설명이 포함됩니다. 링크는 게시된 사이트 URL이 아닙니다. - 실패하면 실제 오류를 명시하고 사이트가 저장되었다고 주장하지 마십시오. 실패한 도구 작업을 임의로 만든 링크로 대체하거나 조용히 기존 사이트로 전환하지 마십시오.
- 링크는 URL 프래그먼트에 비공개 액세스 토큰을 보유하며 1시간 후에 만료되고 Tsumu가 성공적인 가져오기를 확인한 후에 소비됩니다. 타인에게 공개하지 마십시오. 실패한 가져오기는 5분 임시 클레임 임대가 만료된 후 다시 시도할 수 있습니다.
핸드오프 예시(설명용): "편집 가능한 카페 사이트를 가져오기 위해 스테이징했습니다. 비공개 Tsumu 가져오기 링크는 다음 1시간 동안 유효합니다." 실제 핸드오프에는 스테이징이 성공했을 때 도구가 생성한 실제 링크가 포함됩니다.