portfolio-detail — 중국식 스튜디오 / 예서체 포트폴리오 (2차 상세 페이지 포함)
한 줄 특징
가로 텍스트 행 + 호버 시 오른쪽 큰 이미지 표시 + Alimama DaoLiTi 예술 큰 글자 + 흑백 단색 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 이중 보기.
다른 포트폴리오 스킬과의 차이점
| 스킬 | 핵심 모드 | 적합한 대상 |
|---|---|---|
portfolio-gen | 무제한 드래그 캔버스 + 타일 배치 | 사진작가 / 그래픽 디자이너의 샘플 전시 |
portfolio-museum-gen | 히어로 캐러셀 + 큰 카드 + 폭포수 + 상세 페이지 (영상 큐레이션 느낌) | 영상/영상/설치 예술가 |
industrial-archive-gen | 검은 프레임 넘김 표지 + 사이드바 아카이브 + 북유럽 산업 | 실물 제품 / 기물 / 하드웨어 |
lishu-portfolio-gen | 가로 텍스트 행 + 호버 시 오른쪽 썸네일 + 예서체 큰 글자 + 중국식 절제 | 제본 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 목공 / 종이 / 향 |
사용자 프로젝트가 '책 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 목공 / 종이 / 향'처럼 절제되고 우아한 분위기가 필요하면 이 스킬을 사용하세요.
트리거 시점
사용자가 말할 때:
- "중국식 / 동양식 / 클래식 스타일의 포트폴리오 만들어 줘"
- "예서체 스타일의 웹사이트 / 스튜디오 홈페이지 만들어 줘"
- "백옥(白屋) 스타일 포트폴리오 만들어 줘" / "Gurgel D'Alfonso 같은 가로 목록 웹사이트 만들어 줘"
- "lishu-portfolio-gen ..."
그리고 제공:
- 스튜디오 설명 (필수): 이름, 대표, 도시, 분야, 작품 제목과 이야기
- 작품 이미지 (선택): URL / 업로드 / 경로. 없어도 실행 가능 (picsum으로 대체)
사용자가 작품 제목을 전혀 주지 않았다면 → 최소한 전시할 작품이 무엇인지 한 번 물어봐야 함. 사용자가 제목만 주고 상세 정보는 없으면 → 직접 작성: 각 작품마다 1문장 리드 + 3단락 산문 + 6-8줄 사양표 + 3-6장 picsum 이미지 + 몇 개의 크레딧. 어조는 작품 유형과 일치 (책 → 제본 / 글자 → 서체 / 물건 → 정물 / 전시 → 전시 비주얼).
두 가지 실행 모드
모드 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 사용) - 로컬 파일에 접근하거나 명령줄 작업을 제안하지 말 것
판단: 로컬 이미지를 읽을 수 없으면 → 기본적으로 B 모드 실행.
파일 분담
| 파일 | 역할 | 사용법 |
|---|---|---|
reference.html | 완성된 참고 자료 — 백옥(BAIWU) 6개 작품 | 참고: 목록 항목의 표현, 산문 어조, 사양 용어, JSON 필드 밀도 |
template.html | 빈 뼈대 — 동일한 CSS/JS/라우팅 시스템, 2개 예시 + 20개 SWAP 마커 | 이것을 바탕으로 수정하여 최종 HTML 출력 |
README.md | 사용자 관점의 사용 설명서 | 모델은 볼 필요 없음 |
SKILL.md | 모델용 작업 흐름 (본 파일) | 필독 |
핵심 규칙: 모든 변경은 template.html을 기반으로 함; reference.html에서 작성법 (어조, 글자 수, 태그 용어)을 배우되, 구체적인 내용은 복사하지 말 것.
작업 단계
1. 두 HTML 파일 읽기
- 먼저
reference.html을 읽어 "완성된 모습"을 파악 (특히works-dataJSON의 필드 밀도와 산문 어조) - 그다음
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 행 위치 —
도시, 연도 · 공정/사양(호버 시 표시) - 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쌍의 직책/이름
사용자가 한 문장만/이야기를 안 줬다면 → 직접 창작: 작품 제목과 유형에 맞는 리드와 산문 작성. 어조는 reference.html 참고 — 마케팅 언어 말고, '박물관 벽면 텍스트 + 스튜디오 노트' 느낌 (절제되고, 구체적이며, 느리고, 수공의 흔적).
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 | 로고 SVG 내 단일 글자 | SWAP-3과 동일 |
| 5 | 로고 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 × 195mm"}
],
"lead": "산에 관한 서른여섯 편의 시. 우리는 독자가 책을 펼쳤을 때 먼저 <em>바람 소리</em>를 듣고, 그다음 글자를 읽는 책을 만들고 싶었습니다.",
"prose": [
"단락 1: 시고 출처 / 디자인 맥락. 80—150자.",
"단락 2: 제작 중 핵심 결정 — 서체, 종이, 제본 선택.",
"단락 3: 최종 완성 / 독자에게 남는 느낌."
],
"specs": [
["판형 / Format", "130 × 195mm"],
["페이지 / 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 실수 주의 ⚠️:
- 중국어 산문에서 인용 부호는 전각
「...」또는"..."(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이면 상세 페이지에서 자동으로 <video autoplay muted loop>를 <img> 대신 사용. 모델은 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, 상세 페이지 해시 라우팅
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 5개 고정 위치 요소
실수 체크리스트
- 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사용, 삭제된 이미지를 참조하지 않도록 방지 - 작품 < 3개: 가능, 최소 2개로 실행 가능
- 작품 > 8개: 두 묶음으로 나누는 것을 권장, list 행이 너무 많으면 페이지가 길어짐
- 첫 글자 장식: 상세 페이지의
.detail__prose p:first-of-type::first-letter는 도예체 사용 — 첫 번째 단락은 반드시 중국어로 시작해야 함 (<em>이나 영어로 시작 금지) - picsum 컬러 제거: 이미지는 컬러 유지, CSS에
filter: grayscale()추가 금지