Communitygithub.com

Cetc2211/AcTR-app

生成單一 HTML 檔案的中式工作室風格作品集(橫排文字行 + 懸浮顯示縮圖互動、藝術隸書字型、明暗主題、雜湊路由詳細頁)。接受工作室的自然語言描述,輸出一個可運作的 .html 檔案。

AcTR-app 是什麼?

此技能專為開發者與 AI 代理設計,可根據自然語言描述,自動生成一個完整、可直接運作的中式工作室風格作品集網頁(單一 HTML 檔案)。其核心設計為「橫排文字行列表」,當滑鼠懸浮於作品名稱上時,右側會浮現對應的縮圖,並採用「阿里媽媽刀隸體」藝術字型,營造典雅、樸素的中式美學。此技能支援明暗主題切換,並內建基於雜湊路由的詳細頁面系統,讓使用者能深入檢視每件作品的完整資訊。它提供兩種運行模式:在 Claude Code 等本地環境中,可直接將產出的 HTML 檔案儲存至桌面;在 GLM 等線上對話環境中,則會將完整的 HTML 程式碼內嵌於回應中輸出。使用者可透過「做箇中式工作室作品集」、「lishu-portfolio-gen」等關鍵詞觸發此技能。此技能會自動解析使用者提供的資訊,並填充作品資料(如標題、年份、詳細描述、圖片等),若使用者未提供足夠細節,它會根據作品主題自行創作,確保最終產出的網站內容豐富且風格一致。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cetc2211/AcTR-app/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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

相關技能