Communitygithub.com

ARYAN2302/liquid_researcher

根據自然語言描述的工作室資訊,生成一個單一中式工作室風格的 HTML 作品集網站,包含橫排列表、懸浮預覽、隸書字體及詳細頁面。

liquid_researcher 是什麼?

此技能專為快速生成中式工作室風格的單頁作品集網站而設計,目標是產生一個可直接運作的 HTML 檔案。其核心特點是橫排文字列表,當滑鼠懸浮時會在右側顯示作品縮圖,並使用「阿里媽媽刀隸體」展現藝術性大字。網站支援淺色/深色主題切換,並透過 Hash 路由實現詳細作品頁面。此技能支援兩種運行模式:在 Claude Code 等具備文件系統的環境中,會將生成的檔案寫入桌面;而在 GLM 或其他線上對話環境中,則直接輸出完整的 HTML 程式碼區塊給使用者。無論哪種模式,使用者只需提供工作室的描述(如名稱、主理人、領域、作品清單),技能就能自動處理圖片佔位、生成作品文案與規格,並最終輸出一個結構完整、風格典雅的中式工作室作品集。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ARYAN2302/liquid_researcher/tree/HEAD/skills/design/design-templates/portfolio-detail

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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-data JSON 的字段密度和 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
2meta description一句網站簡介
3curtain 單字工作室名首字(如「白」)
4logo SVG 內單字同 SWAP-3
5logo SVG 內拼音{PINYIN} 大寫
6主導航 li通常 3 項:作品 / 關於 / 聯繫
7brand-block 中文名{ATELIER_NAME} 拆字加空格(如 白&nbsp;&nbsp;屋)
8brand-block 英文{PINYIN} Studio · {CITY}
9tagline楷體一句話定位,20-40 字,可用 <br> 換行
10list 項 N 件每件 <a class="item" href="#work/{slug}"> 包含 num/project-name/en-name/location/photo-thumb
11gallery 項 N 件同樣的 N 件作品,更緊湊的網格 — slug 必須和 list 一致
12關於標題關&nbsp;于&nbsp;{name}<span class="en">About</span>
13關於段落1-3 段楷體(成立背景 / 主理人 / 設計觀),每段 60-120 字
14關於事實表4-6 項 li (Founded/Location/Discipline/Director/Hours)
15聯繫標題來&nbsp;信<span class="en">Get in Touch</span>
16聯繫段落1-2 段邀請來信 + 回信週期承諾
17聯繫事實表4-6 項 (E-mail/Phone/Address/Instagram/公眾號)
18rotating creditSite by {WHO}(通常是工作室名)
19footer 三塊© / ICP / 社交鏈接
20works-data JSONN 件作品的完整詳情數據(關鍵!)

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()

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

ARYAN2302/liquid_researcher

Chinese-market SaaS pricing page template — soft sky-blue glass-morphism, 4-tier card grid with one elevated "recommended" tier, monthly/annual toggle, FAQ accordion, ¥ pricing with Inter numerals, careful CJK linebreaking, ICP filing footer.

ARYAN2302/liquid_researcher

Premium calm-tech SaaS landing template — bilingual (CN/EN) literary voice over a dark forest-night palette with warm gold accent, Cormorant + Noto Serif SC, Three.js procedural forest hero, station-based scrolling narrative, custom cursor. Built for ambient-AI / creative-tool / philosophical SaaS, not loud commercial launch.

ARYAN2302/liquid_researcher

Pro-camera HUD mockup template — full-viewport black canvas wrapping a real video with monospace overlays (corner brackets, top status bar, side AF/exposure columns, bottom timecode + aperture/shutter/ISO row, vertical 8-filter wheel, animated reticle). For cinematographer portfolios, camera-app demos, LUT pack previews, filter-look auditions. NOT a TikTok/Reels mockup, NOT a storyboard, NOT a shot list, NOT a script document. The chrome wraps real footage — never a div placeholder.

ARYAN2302/liquid_researcher

Premium pre-launch waitlist page template — dark charcoal canvas with subtle vignette, drifting portrait video-thumbnail cards, fade-up cascades, glass nav, live-updating join counter, single email form with success/error states. Built for creative-tool / AI / niche-SaaS invite-only launches with hushed exclusive tone, not loud growth-marketing.

ARYAN2302/liquid_researcher

Route design-related HTML artifact tasks to the right artifact skill, reference, design system generation, or export skill.

ARYAN2302/liquid_researcher

Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to convert text into natural-sounding speech, create audio content, build voice-enabled applications, or generate spoken audio files. Supports multiple voices, adjustable speed, and various audio formats.

ARYAN2302/liquid_researcher

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

ARYAN2302/liquid_researcher

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

相關技能