Sitesmith — 대화형 웹사이트 빌더
몇 번의 대화만으로 완성된, 선택적으로 이중 언어를 지원하는 웹사이트를 만들어 게시합니다. 코드가 아닌 데이터, 즉 단일 site.json 파일을 생성하며, 고정적이고 잘 설계된 템플릿이 이를 렌더링합니다. 이렇게 하면 출력 결과가 안정적이고 추후 리스킨이 가능합니다.
사용 시기
사용자가 웹사이트, 랜딩 페이지, 개인/비즈니스 사이트 또는 포트폴리오를 만들거나 업데이트하려 할 때 사용합니다. 예: "내 사이트 만들어 줘", "我想做个网站", "내 홈페이지 업데이트", "내 빵집 랜딩 페이지 만들어 줘".
빠른 참조
참조 파일 — skill_view("sitesmith", "<path>")로 필요할 때만 로드하세요.
references/site.schema.json— 모든site.json이 반드시 충족해야 하는 계약(스키마).references/sections.md— 14가지 섹션 유형 (posts포함): 사용 시기, 필드, 복사 제한.references/theme.md— 테마 토큰 (템플릿, 색상, 글꼴, 둥글기, 밀도).references/assets.md— 이미지 전략 (placeholder / unsplash; 자산을 임의로 생성하지 마세요).references/examples/innoe.site.json— 완전한 단일 페이지 예제 (few-shot).references/examples/multipage.site.json— 다중 페이지 + 블로그 예제 (few-shot).
스크립트 — 터미널 도구를 통해 실행:
| 작업 | 명령어 |
|---|---|
| 검증 | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| 렌더링 | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir> |
| 배포 | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain> |
절차
-
요구사항 수집 (3~5턴, 그룹 질문 — 심문하지 마세요).
- 비즈니스 이름 + 한 줄 설명; 업종 + 고객층.
- 주요 목표 (전화 / 예약 / 가입 / 판매 / 전시).
- 언어 — 기본적으로 채팅 언어를 사용; 이중 언어(예: en + ko) 제안.
- 범위: 단일 페이지 또는 다중 페이지? 기본값은 단일 페이지. 더 많은 페이지를 원하거나 블로그를 언급하면 표준 세트(홈 / 소개 / 서비스 / 블로그 / 연락처)를 제공하고 사용자가 조정할 수 있도록 함 — 구축 전에 페이지 목록을 확인.
- 상위 3~5개 서비스/제품; 차별점; 실제 숫자; 연락처 정보 + 주요 클릭 유도 문구.
- 한두 단어로 표현하는 분위기 (→
theme); 자산 (로고? 브랜드 색상? 실제 사진?). - 사용자가 간결하거나 "그냥 예쁘게 만들어 줘"라고 하면 합리적인 기본값으로 진행 (단일 페이지가 안전한 기본값).
-
site.json초안 작성 —references/site.schema.json을 준수해야 합니다. 먼저 해당 예제를 연구하세요 (단일 페이지는innoe.site.json, 다중 페이지는multipage.site.json). 실제 콘텐츠에 맞는 페이지당 5~8개 섹션을 선택하세요 (references/sections.md에서 목표→섹션 구성표 참조).- 단일 페이지: 모든 내용은 최상위
sections에 들어갑니다. - 다중 페이지: 홈은 최상위
sections에 유지;pages[]를 추가 (각 하위 페이지마다 하나의 항목, 각각 자체sections포함). 내비게이션은 페이지에서 자동 파생됩니다. 블로그는posts섹션이 있는 페이지입니다 (가벼움: 헤드라인 카드, 기사 페이지 없음). - 디자인 선택 (
references/theme.md참조): 브랜드가 강하고 명확한 미적 감각을 가질 때만 스타일 템플릿(newchinese/cyber/portfolio)을 사용하거나, 기본값으로template:"pro"를 사용하고 비즈니스 느낌에 맞게 직접 맞춤형 팔레트 (primary/accent/neutral/font/radius/density)를 디자인하여 각 사이트가 고유하도록 하세요. 모든 이미지는references/assets.md에 따라 처리합니다.
- 단일 페이지: 모든 내용은 최상위
-
검증.
validate.mjs를 실행합니다. 실패 시 오류를 읽고 JSON을 수정한 후 다시 실행하세요. 유효하지 않은 파일로 절대 진행하지 마세요. -
렌더링.
render.mjs <site.json> <out-dir>실행 →<out-dir>/dist에 정적 사이트 생성.UNSPLASH_ACCESS_KEY가 설정되어 있으면 렌더링 시unsplash플레이스홀더를 실제 사진(크레딧 포함)으로 자동 교체; 키가 없으면 테마 플레이스홀더가 렌더링됩니다. 둘 다 배포해도 괜찮습니다. -
미리보기 및 반복. 구축한 내용을 일반 언어로 요약하세요 ("5페이지 이중 언어 사이트: 홈, 소개, 서비스, 저널, 연락처" 또는 "6개 섹션 단일 페이지"). 사용자에게 사이트가 완전히 편집 가능하다고 알리세요 — 언제든지 페이지나 섹션을 추가/제거하고, 카피를 다시 작성하고, 색상을 변경하거나 블로그 게시물을 추가하도록 요청할 수 있습니다. 전체
site.json을 다시 내보내고 다시 검증 + 다시 렌더링하여 수정 사항을 적용합니다. -
배포 (사용자가 미리보기를 승인한 후에만).
deploy.sh <out-dir> <domain>실행 → HTTPS와 함께 Nginx로 라이브 배포. 라이브 URL을 보고합니다.
주의 사항
- 출력은 데이터이지 코드가 아닙니다.
site.json만 생성하세요. 직접 HTML/CSS를 작성하지 마세요. - 스키마는 법입니다. 필드 이름과 열거형 값은 정확히 일치해야 하며, 알 수 없는 필드는 생략합니다.
- 자산을 임의로 만들지 마세요. 미디어
type:"placeholder"(장식용) 또는query가 있는"unsplash"(콘텐츠 사진)를 사용하세요."image"는 사용자가 제공한 실제 URL이 있는 경우에만 사용합니다. 로고는 실제 로고 파일이 없으면 기본적으로type:"text"입니다. - 기능/서비스에는 이미지보다 아이콘을 선호 — Lucide 이름은 항상 렌더링되고 색상이 변경됩니다.
- 모든 LocalizedText는 사이트의 모든 언어를 포함합니다. 관용적으로 번역하고, 절대 하나를 비워두지 마세요.
- 과도하게 구축하지 마세요. 5~8개 섹션. 섹션 배경을 번갈아 사용하고,
dark또는primary가 연속으로 두 번 오지 않도록 하세요. 항상hero로 시작하고cta또는contact로 끝냅니다. - 규정 위험 주장 금지 — 사용자가 언급하지 않은 인증, 보증, 정부 보조금/지원금, 수상 내역 또는 통계는 절대 포함하지 마세요.
- 단일 페이지가 기본값입니다. 사용자가 더 풍부한/다중 페이지 사이트나 블로그를 원할 때만
pages[]를 추가하고, 먼저 페이지 목록을 확인하세요. 블로그(posts)는 헤드라인 목록이지 전체 기사가 아닙니다. 그렇게 말하고, 기사는 나중에 추가할 수 있다고 알리세요.
검증
validate.mjs가0으로 종료됩니다 (해결된 섹션 순서를 출력합니다).render.mjs가<out-dir>/dist/index.html을 생성합니다.- 배포 후
curl -I https://<domain>이200을 반환합니다.