portfolio-detail — 中式工作室 / 隸書作品集(帶二級詳情頁)
一句話特徵
橫排文字行 + hover 浮現右側大圖 + 阿里媽媽刀隸體藝術大字 + 黑白純色 + light/dark + hash 路由詳情頁 + 列表/畫冊雙視圖。
與其他作品集 skill 的差別
| skill | 核心模式 | 適合誰 |
|---|---|---|
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 學怎麼寫(語氣、字數、tag 用詞),但不要複製具體內容。
工作步驟
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 — Logo 用的單字(通常是工作室名首字:白 / 素 / 墨 / 青 / 拙)
- 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 — 不要 marketing 語言,要有「博物館 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 陣列裡多寫一項
<em>詞</em>在 lead 裡直接寫 HTML 標籤——渲染時按 innerHTML 出- gallery
layout必須三選一:g-wide(佔滿)/g-half(佔一半)/g-third(佔 1/3)
6. 圖片源選擇
- picsum 佔位:用
id/X形式而非seed/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 件作品,hover 行查看縮略圖,點選進入詳情頁。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、詳情頁 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:用
id/X不要用seed/X,避免隨機 ID 命中已刪除的圖 - 作品 < 3 件:可以,最少 2 件就能跑
- 作品 > 8 件:建議分兩批,太多 list 行會讓頁面變長
- 首字下沉:詳情頁的
.detail__prose p:first-of-type::first-letter用刀隸體 — 第一段必須是中文開頭(不要以<em>或英文開頭) - 刪了 picsum 的彩色:圖片應保持彩色,不要在 CSS 加
filter: grayscale()