portfolio-detail — 중국식 스튜디오 / 예서체 포트폴리오 (상세 페이지 포함)
한 줄 요약
가로 텍스트 행 + hover 시 오른쪽에 큰 이미지 표시 + Alimama DaoLiTi 예서체 예술적 큰 글자 + 흑백 순수 색상 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 뷰.
다른 포트폴리오 스킬과의 차이점
| 스킬 | 핵심 모드 | 적합한 대상 |
|---|---|---|
portfolio-gen | 무한 드래그 캔버스 + 타일 배열 | 사진작가 / 그래픽 디자이너의 샘플 전시 |
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 —
도시, 연도 · 공정/사양(hover 시 표시) - meta — 4개의 키-값 쌍 (상세 페이지 4열 요약)
- lead — 30-70자 서두 큰 글자,
<em>키워드</em>로 한 곳 강조 가능 - prose — 3-4개 문단 산문, 각 문단 80-150자
- specs — 6-10행 사양표 (판형/종이/제본/서체/인쇄량/인쇄/공정/가격 등)
- gallery — 3-6개 이미지, layout은 세 가지 중 하나:
g-wide/g-half/g-third - credits — 4-7쌍의 직책/이름
사용자가 한 마디만 하고/이야기를 주지 않았다면 → 직접 만듭니다: 작품 제목과 유형에 따라 작품 성격에 맞는 lead와 prose를 작성합니다. 어조는 reference.html을 참조하세요 — 마케팅 언어가 아닌, '박물관 벽 텍스트 + 스튜디오 노트' 느낌이어야 합니다 (절제되고, 구체적이며, 느리고, 수공예적 흔적이 있는).
3. 작품 목록 작성 + 크기 확인 (모드 A만 해당)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
각 이미지의 (파일명, 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 | about 제목 | 关 于 {name}<span class="en">About</span> |
| 13 | about 문단 | 1-3개 해서체 문단 (설립 배경 / 대표 / 디자인관), 각 문단 60-120자 |
| 14 | about 사실표 | 4-6개 li (Founded/Location/Discipline/Director/Hours) |
| 15 | contact 제목 | 来 信<span class="en">Get in Touch</span> |
| 16 | contact 문단 | 1-2개 초대 편지 + 답장 기간 약속 문단 |
| 17 | contact 사실표 | 4-6개 li (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 카드의 #work/SLUG href와 완전히 일치해야 합니다.
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": [
"문단 1: 시고 출처 / 디자인 맥락. 80—150자.",
"문단 2: 제작 과정의 핵심 결정 — 서체, 종이, 제본 선택.",
"문단 3: 최종 결과 / 독자에게 남기는 느낌."
],
"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. 비디오 지원
작품 cover가 .mp4 / .webm / .mov인 경우, 상세 페이지는 자동으로 <img> 대신 <video autoplay muted loop>를 사용합니다. 모델은 cover URL에 비디오 경로만 제공하면 됩니다.
9. 보고
모드 A: 한 줄 보고.
~/Desktop/baiwu-portfolio.html 생성 완료 — 작품 6개, 행에 마우스를 올리면 썸네일 확인, 클릭하면 상세 페이지로 이동합니다. 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, 상세 페이지 hash 라우팅
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는 DaoLiTi 서체 사용 — 첫 번째 문단은 반드시 중국어로 시작해야 함 (<em>이나 영어로 시작 금지) - picsum 컬러 제거 금지: 이미지는 컬러를 유지해야 하며, CSS에
filter: grayscale()을 추가하지 마세요