portfolio-detail — 중국식 스튜디오 / 예서(隸書) 포트폴리오 (상세 페이지 포함)
한 줄 요약
가로 텍스트 줄 + 마우스 호버 시 오른쪽 큰 이미지 표시 + 알리마마 다오리티(阿里媽媽刀隸體) 예술적 큰 글자 + 흑백 순수색 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 이중 보기.
다른 포트폴리오 스킬과의 차이점
| 스킬 | 핵심 모드 | 적합한 대상 |
|---|---|---|
portfolio-gen | 무한 드래그 캔버스 + 타일 배열 | 사진작가 / 그래픽 디자이너 샘플 전시 |
portfolio-museum-gen | 히어로 캐러셀 + 큰 카드 + 폭포수 레이아웃 + 상세 페이지 (영상 큐레이션 느낌) | 영상/미디어/설치 예술가 |
industrial-archive-gen | 검은 테두리 플립 커버 + 사이드바 아카이브 + 북유럽 인더스트리얼 | 실물 제품 / 기물 / 하드웨어 |
lishu-portfolio-gen | 가로 텍스트 줄 + 마우스 호버 시 오른쪽 썸네일 표시 + 예서 큰 글자 + 중국식 절제 | 제본 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 나무 / 종이 / 향 |
사용자 프로젝트가 '책 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 나무 / 종이 / 향' 등 절제되고 우아한 분위기가 필요한 경우 — 이 스킬을 사용하세요.
트리거 조건
사용자가 말할 때:
- "중국식 / 동양 / 클래식 스타일 포트폴리오를 만들어 줘"
- "예서 스타일 웹사이트 / 스튜디오 홈페이지를 만들어 줘"
- "백옥(白屋) 스타일 포트폴리오를 만들어 줘" / "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장의 이미지, 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
각 이미지의 (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 | 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개 (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": [
"段落一:詩稿來源 / 設計語境。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 배열에 항목을 추가하십시오
<em>단어</em>는 lead 안에 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가 알리마마 다오리티의 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()을 추가하지 말 것