Communitygithub.com

AiCurv/ADBCommander

根據自然語言描述的工作室資訊,生成單一HTML檔案的東方風格(中式)工作室作品集網站,特色為橫排文字行與滑鼠懸停顯示右側縮略圖的互動,並支援Light/Dark主題與Hash路由詳細頁面。

ADBCommander 是什麼?

這個「AiCurv/ADBCommander」技能(又稱lishu-portfolio-gen)專為生成具有東方典雅氣質的單頁作品集網站而設計。它能將使用者以自然語言描述的工作室(如名稱、主理人、城市、學科與作品清單)自動轉化為一個完整的、可立即使用的HTML檔案。其核心視覺風格包含橫排文字列表、滑鼠懸停時在右側浮現作品縮圖、使用「阿里媽媽刀隸體」藝術字型,並提供Light/Dark主題切換與基於Hash路由的詳細作品頁面。此技能支援兩種運行模式:在Claude Code等本地環境中,它會將生成的HTML檔案寫入使用者桌面;在GLM等無檔案系統的線上對話中,則會直接輸出完整的HTML程式碼。此技能特別適合書法、字體設計、工藝、茶、陶、木、香等需要克制、典雅氣質的創作者或工作室使用。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AiCurv/ADBCommander/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 7 individual skills — each has its own dedicated page.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

相關技能