Communitygithub.com

antilsabh789-pixel/kabaddi-pro

生成一个单文件的中式工作室作品集网站(横排文字行 + hover 浮现缩略图交互,艺术隶书字体通过 CDN 加载,亮/暗主题,hash 路由详情页)。接受工作室的自然语言描述,输出一个可用的 .html 文件。可在 Claude Code 和在线聊天中运行。

kabaddi-pro 是什麼?

此技能旨在根据用户提供的自然语言描述,生成一个具有中式典雅风格的、单文件的工作室作品集 HTML 网站。其核心交互是横排文字列表,当鼠标悬停在作品名称上时,右侧会浮现对应的缩略图。网站使用“阿里妈妈刀隶体”作为艺术字体,并支持亮色和暗色主题切换。每个作品都拥有独立的详情页,通过 URL hash 路由进行导航。该技能特别适用于需要展现“书、字体、展览、中草药、茶、陶、木、纸、香”等具有克制、典雅气质内容的工作室。它能自动解析用户输入中关于工作室名称、主理人、城市、学科及作品信息,并填充到一个预制的 HTML 模板中,替换其中的 20 个 SWAP 标记。对于每个作品,它会自动生成包含标题、描述、散文段落、规格表、图片画廊和制作人员信息在内的完整 JSON 数据。该技能支持两种运行模式:在 Claude Code 中,它会将文件保存到用户的桌面;在 GLM 或在线聊天环境中,则会直接输出完整的 HTML 代码块。技能的核心价值在于将复杂的设计决策和风格化内容生成自动化,使非技术用户也能快速获得一个具有专业水准和独特审美的工作室展示网站。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antilsabh789-pixel/kabaddi-pro/tree/HEAD/.migration-backup/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 3 individual skills — each has its own dedicated page.

相關技能