portfolio-detail — 중식 스튜디오 / 해서체 포트폴리오 (상세 페이지 포함)
한 줄 요약
가로 텍스트 행 + hover 시 오른쪽 큰 이미지 표시 + Alimama DaoLiTi 예술적 큰 글자 + 흑백 순색 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 이중 보기.
다른 포트폴리오 스킬과의 차이점
| 스킬 | 핵심 모드 | 적합한 대상 |
|---|---|---|
portfolio-gen | 무한 드래그 캔버스 + tile 평면 배열 | 사진작가 / 그래픽 디자이너 샘플 전시 |
portfolio-museum-gen | 히어로 캐러셀 + 큰 카드 + 폭포수 레이아웃 + 상세 페이지 (영상 큐레이션 느낌) | 영상/영상/설치 예술가 |
industrial-archive-gen | 검정 테두리 페이지 넘기기 표지 + 사이드바 아카이브 + 북유럽 산업 | 실물 제품 / 기물 / 하드웨어 |
lishu-portfolio-gen | 가로 텍스트 행 + hover 시 오른쪽 썸네일 표시 + 해서체 큰 글자 + 중국식 절제미 | 제본 / 서체 / 공예 / 중식 스튜디오 |
사용자의 프로젝트가 '책 / 서체 / 전시 / 정물 / 한약 / 차 / 도자기 / 나무 / 종이 / 향' 등 절제되고 우아한 분위기가 필요한 경우 — 이 템플릿을 사용하세요.
언제 트리거되는가
사용자가 다음과 같이 말할 때:
- "중식 / 동양 / 고전 스타일의 포트폴리오를 만들어 줘"
- "해서체 스타일의 웹사이트 / 스튜디오 홈페이지를 만들어 줘"
- "백옥 스타일의 포트폴리오를 만들어 줘" / "Gurgel D'Alfonso 같은 가로 목록 웹사이트를 만들어 줘"
- "lishu-portfolio-gen ..."
그리고 다음 정보를 제공할 때:
- 스튜디오 설명 (필수): 이름, 디렉터, 도시, 분야, 몇 개의 작품 제목과 스토리
- 작품 이미지 (선택): URL / 업로드 / 경로. 없어도 작동 (picsum 플레이스홀더 사용)
사용자가 작품 제목을 전혀 제공하지 않으면 → 최소한 어떤 작품을 전시할지 한 번 물어봐야 합니다. 사용자가 제목만 제공하고 세부 정보는 제공하지 않으면 → 직접 작성: 각 작품에 대해 1개의 lead + 3개의 prose 단락 + 6-8개의 specs + 3-6개의 picsum 이미지 + 몇 개의 credits를 생성합니다. 어조는 작품 유형과 일치해야 합니다 (책 → 제본 / 글자 → 서체 / 물건 → 정물 / 전시 → 전시 시각).
두 가지 실행 모드
모드 A · Claude Code / 로컬 (파일 시스템 있음)
Bash를 사용하여 폴더 나열,sips로 각 이미지의 너비와 높이 확인- 출력 위치:
~/Desktop/{slug}-portfolio.html(단일 파일, 모든 이미지는 URL 사용) - 사용자가 로컬 이미지를 제공한 경우:
~/Desktop/{slug}-portfolio-images/로 복사하고 src를 상대 경로로 변경
모드 B · GLM / 온라인 대화 (파일 시스템 없음)
- 사용자가 zip을 드래그하여 압축을 풀면 4개의 파일을 볼 수 있음
- 완전한 HTML 문자열 하나만 출력하며,
```html코드 블록으로 감쌈 - 사용자가 이미지를 업로드했지만 URL을 제공하지 않은 경우 → 모두
https://picsum.photos/id/{id}/{w}/{h}플레이스홀더 사용 (알려진 존재하는 ID 사용) - 로컬 파일에 접근하거나 명령줄 작업을 제안하지 마십시오
판단: 로컬 이미지를 Read 할 수 없으면 → 기본적으로 B를 따릅니다.
파일 분담
| 파일 | 역할 | 사용 방법 |
|---|---|---|
reference.html | 완성된 참고 자료 — BAIWU 6개 작품 | 확인: list 항목의 표현, prose 어조, specs 용어, JSON 필드 밀도 |
template.html | 빈 뼈대 — 동일한 CSS/JS/라우팅 시스템, 2개 예시 + 20개의 SWAP 마크 | 이를 기반으로 수정하여 최종 HTML 출력 |
README.md | 사용자 관점의 사용 설명서 | 모델이 볼 필요 없음 |
SKILL.md | 모델이 볼 워크플로 (이 파일) | 필독 |
핵심 규칙: 모든 변경은 template.html을 기반으로 합니다. reference.html에서 작성 방법 (어조, 글자 수, 태그 용어)을 배우되, 구체적인 내용을 복사하지 마십시오.
작업 단계
1. 두 HTML 파일 읽기
- 먼저
reference.html을 읽어 "완성되었을 때 어떻게 보이는지" 파악 (특히works-dataJSON의 필드 밀도와 prose 어조) - 그런 다음
template.html을 읽어 20개의 SWAP 위치를 찾습니다
JS / CSS / 상세 페이지 라우팅 시스템 / 글꼴 로딩을 수정하지 마십시오. SWAP은 모두 HTML 텍스트와 JSON 데이터에 있습니다.
2. 사용자 입력을 파싱하여 정보 추출
추출:
- ATELIER_NAME_ZH — 스튜디오 중국어 이름 (2-4자가 가장 좋음, 예: 「白屋」「素园」「墨记」「青庐」「拙轩」)
- PINYIN — 병음 (5-6개의 영문자, 모두 대문자: BAIWU / SUYUAN / MOJI)
- CHAR — 로고에 사용할 단일 글자 (일반적으로 스튜디오 이름의 첫 글자: 白 / 素 / 墨 / 青 / 拙)
- CITY — 도시
- DIRECTOR_ZH / DIRECTOR_EN — 디렉터 이름 + 병음
- DISCIPLINE — 3개의 분야 단어 ("제본 · 서체 · 정물")
- TAGLINE — 한 줄 소개 (20-40자, 해서체 스타일)
- YEAR_FOUNDED — 설립 연도 (간지 사용 가능: 乙未冬 / 甲辰春)
각 작품 추출:
- slug — URL ID, 소문자 영어 하이픈 (
kong-shan-ji/wu-ming-shu) - title_zh — 중국어 제목 (2-5자가 가장 좋음, 간결할수록 스타일 있음)
- title_en — 영어 부제 (책 제목 스타일:
An Anthology of Empty Mountains) - year — 연도 또는 간지 (
甲辰 / 2024/2025/乙巳 / 2025) - tag — 상단 분류, 대괄호 포함, 예:
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — 상세 페이지 큰 이미지 URL
- list 행 location —
도시, 연도 · 공예/사양(호버 시 표시) - meta — 4개의 키-값 쌍 (상세 페이지 4열 요약)
- lead — 30-70자의 시작 큰 글자,
<em>키워드</em>로 한 곳 강조 가능 - prose — 3-4개의 산문 단락, 각 80-150자
- specs — 6-10행 사양표 (판형/종이/제본/서체/인쇄량/인쇄/공예/가격 등)
- gallery — 3-6개의 이미지, 레이아웃은 세 가지 중 하나:
g-wide/g-half/g-third - credits — 4-7쌍의 직위/이름
사용자가 한 마디만 하고 이야기를 제공하지 않으면 → 직접 작성: 작품 제목과 유형에 따라 작품의 성격에 맞는 lead와 prose를 작성합니다. 어조는 reference.html을 참고하세요 — 마케팅 언어가 아니라 '박물관 wall-text + 스튜디오 노트' 느낌 (절제되고, 구체적이며, 느리고, 수공예 흔적이 있는).
3. 작품 나열 + 크기 확인 (모드 A만)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
각 이미지의 (filename, w, h, aspect)를 얻습니다. list 썸네일에는 세로 이미지를 우선 선택합니다 (4:3 컨테이너, 세로 이미지가 더 잘 보임).
4. 20개의 SWAP 교체
| SWAP | 위치 | 내용 |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio |
| 2 | meta description | 웹사이트 한 줄 소개 |
| 3 | curtain 단일 글자 | 스튜디오 이름 첫 글자 (예: 「白」) |
| 4 | logo SVG 내 단일 글자 | SWAP-3과 동일 |
| 5 | logo SVG 내 병음 | {PINYIN} 대문자 |
| 6 | 주요 네비게이션 li | 일반적으로 3개: 作品 / 关于 / 联系 |
| 7 | brand-block 중국어 이름 | {ATELIER_NAME} 글자 분리 후 공백 추가 (예: 白 屋) |
| 8 | brand-block 영어 | {PINYIN} Studio · {CITY} |
| 9 | tagline | 해서체 한 줄 소개, 20-40자, <br>로 줄바꿈 가능 |
| 10 | list 항목 N개 | 각각 <a class="item" href="#work/{slug}"> 포함: num/project-name/en-name/location/photo-thumb |
| 11 | gallery 항목 N개 | 동일한 N개 작품, 더 조밀한 그리드 — slug는 list와 일치해야 함 |
| 12 | 소개 제목 | 关 于 {name}<span class="en">About</span> |
| 13 | 소개 단락 | 1-3개의 해서체 단락 (설립 배경 / 디렉터 / 디자인 철학), 각 60-120자 |
| 14 | 소개 사실표 | 4-6개 항목 li (Founded/Location/Discipline/Director/Hours) |
| 15 | 연락처 제목 | 来 信<span class="en">Get in Touch</span> |
| 16 | 연락처 단락 | 1-2개의 초대 편지 + 답장 기간 약속 |
| 17 | 연락처 사실표 | 4-6개 항목 (E-mail/Phone/Address/Instagram/公众号) |
| 18 | rotating credit | Site by {WHO} (일반적으로 스튜디오 이름) |
| 19 | footer 세 블록 | © / ICP / 소셜 링크 |
| 20 | works-data JSON | N개 작품의 완전한 상세 데이터 (중요!) |
5. works-data JSON 작성 (가장 중요한 단계)
각 작품은 JSON 배열에 하나의 항목이 있어야 하며, slug는 list/gallery 카드 href의 #work/SLUG와 완전히 일치해야 합니다.
JSON 필드:
{
"slug": "kong-shan-ji",
"title_zh": "空山集",
"title_en": "An Anthology of Empty Mountains",
"year": "甲辰 / 2024",
"tag": "[ 诗集 · 装帧设计 ]",
"cover": "https://picsum.photos/id/143/1800/1100",
"meta": [
{"label": "Type / 类型", "value": "诗集装帧"},
{"label": "Year / 年份", "value": "2024"},
{"label": "Edition / 印量", "value": "首印 320 本"},
{"label": "Format / 开本", "value": "130 × 195 毫米"}
],
"lead": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见<em>风声</em>,再读见字的书。",
"prose": [
"段落一:诗稿来源 / 设计语境。80—150 字。",
"段落二:制作中的关键决定 — 字体、纸张、装订选择。",
"段落三:最后呈现 / 留给读者的感受。"
],
"specs": [
["开本 / Format", "130 × 195 毫米"],
["页数 / Pages", "144 页"],
["纸张 / Paper", "本色棉纸 90gsm"],
["装订 / Binding", "线装四目"],
["字体 / Typeface", "老宋(标题)· 楷体(正文)"],
["印刷 / Printing", "单色凸印"],
["印量 / Edition", "首印 320 本"],
["定价 / Price", "¥ 388"]
],
"gallery": [
{"src": "...", "layout": "g-wide", "caption": "封面"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"}
],
"credits": [
["设计 / Design", "周墨白"],
["手工装订 / Binding", "陈漱石(杭州·订书坊)"]
]
}
JSON 오류 주의 ⚠️:
- 중국어 prose 내에서 따옴표를 사용해야 하는 경우 → 전각
「...」또는"..."(U+201C / U+201D)를 반드시 사용하고, ASCII"를 사용하면 JSON이 깨집니다 - JSON 문자열 내에서 실제 줄바꿈을 하지 마십시오. 단락을 나누려면 prose 배열에 항목을 추가하십시오
- lead 내
<em>단어</em>는 HTML 태그를 직접 작성하면 됩니다. 렌더링 시 innerHTML로 출력됩니다 - gallery의
layout은 세 가지 중 하나여야 합니다:g-wide(전체 차지) /g-half(절반 차지) /g-third(1/3 차지)
6. 이미지 소스 선택
- picsum 플레이스홀더:
seed/X형식보다id/X형식을 사용하세요 (더 안정적). 알려진 좋은 ID: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - 같은 작품의 cover / gallery는 인접한 몇 개의 ID를 사용하면 일관된 톤을 만들 수 있습니다
?grayscale매개변수를 사용하지 마십시오 (사용자는 컬러 이미지를 원합니다)
7. 중국 스튜디오 이름 아이디어 (사용자가 제공하지 않은 경우)
사용자가 "직접 지어줘"라고 하면 → 2자 + 고풍스러운 것을 선택:
- 사물 이름류: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- 글자 행류: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- "工作室 / 设计 / Studio"와 같은 기능적 단어는 피하고, 이름 자체가 시가 되도록 하십시오
8. 비디오 지원
작품 커버가 .mp4 / .webm / .mov인 경우, 상세 페이지는 자동으로 <video autoplay muted loop>를 사용하여 <img>를 대체합니다. 모델은 cover URL에 비디오 경로를 제공하기만 하면 됩니다.
9. 보고
모드 A: 한 줄 보고서.
~/Desktop/baiwu-portfolio.html 생성 완료 — 6개 작품, hover 행으로 썸네일 보기, 클릭하여 상세 페이지 진입. Light/Dark는 왼쪽 아래, 목록/화첩은 상단 중앙.
모드 B: 완전한 HTML 코드 블록 + 한 줄 설명 직접 제공.
위 내용을
index.html로 저장하고 더블클릭하여 엽니다. 작품 이름 위에 마우스를 올리면 오른쪽에 나타나는 썸네일을 보고, 클릭하면 상세 페이지로 이동합니다. 이미지를 바꾸려면 picsum URL을 이미지 주소로 바꾸십시오.
강제 유지 (변경 불가)
- 글꼴 로딩:
@font-face로 Alimama DaoLiTi의 woff2 URL 로딩 (글꼴 소스 변경 금지) - CSS 변수 시스템: light/dark 이중 테마
- 전체 JS: theme toggle, view mode toggle, hover-row 상호작용, rotating credit, 상세 페이지 해시 라우팅
applyRoute(),renderDetail() <script id="works-data">노드는 반드시 유지<main id="detail-root">반드시 유지 (상세 페이지 마운트 지점)body[data-view="home/detail"]및body[data-mode="list/gallery"]상태 시스템- #logo / #main-menu / .theme-toggle / #project-view / #svp-credit 다섯 개의 고정 위치 요소
오류 빠른 확인
- slug 불일치: list 항목
#work/kong-shan-ji↔ gallery 항목#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— 세 곳이 완전히 일치해야 합니다 - JSON 따옴표: 중국어 내용 내의 따옴표는 반드시 전각 「」 또는
"..."를 사용하고, ASCII"를 사용하지 마십시오 - gallery 너무 많음: 각 작품당 최대 6개의 이미지, 초과 시 레이아웃이 어긋납니다
- prose 너무 김: 각 단락 80-150자, 200자 초과 시 가독성 저하
- list / gallery 불일치: 동일한 작품 세트를 포함해야 합니다 (일대일 대응)
- picsum seed:
seed/X대신id/X를 사용하여 삭제된 이미지에 대한 랜덤 ID를 피하십시오 - 작품 < 3개: 가능, 최소 2개면 실행 가능
- 작품 > 8개: 두 묶음으로 나누는 것이 좋습니다. list 행이 너무 많으면 페이지가 길어집니다
- 첫 글자 드롭캡: 상세 페이지의
.detail__prose p:first-of-type::first-letter는 해서체 사용 — 첫 번째 단락은 반드시 중국어로 시작해야 합니다 (<em>또는 영어로 시작 금지) - picsum 컬러 제거 금지: 이미지는 컬러를 유지해야 하며, CSS에
filter: grayscale()을 추가하지 마십시오