portfolio-detail — 中式工作室 / 隷書作品集(詳細ページ付き)
一言で表すと
横書き文字行 + ホバーで右側に大きな画像が浮かび上がる + 阿里媽媽刀隷体のアート大字 + 白黒の純色 + light/dark + ハッシュルーティング詳細ページ + リスト/ギャラリーの2ビュー。
他のポートフォリオスキルとの違い
| スキル | コアモード | 対象者 |
|---|---|---|
portfolio-gen | 無限ドラッグキャンバス + タイル配置 | 写真家 / グラフィックデザイナーがサンプルを展示 |
portfolio-museum-gen | ヒーローカルーセル + ラージカード + ウォーターフォール + 詳細ページ(映像キュレーション感) | 映像 / メディアアート / インスタレーションアーティスト |
industrial-archive-gen | 黒枠のページめくり表紙 + サイドバーアーカイブ + 北欧インダストリアル | 実物製品 / 器物 / ハードウェア |
lishu-portfolio-gen | 横書き文字行 + ホバーで右側にサムネイル表示 + 隷書の大字 + 中国風の抑制 | 装丁 / フォント / 工芸 / 中国風スタジオ |
ユーザーのプロジェクトが「本 / フォント / 展覧会 / 静物 / 漢方薬 / 茶 / 陶器 / 木 / 紙 / 香」など、抑制の効いた典雅な雰囲気を必要とする場合は、こちらを使用してください。
いつトリガーされるか
ユーザーが次のように言った場合:
- 「中国風 / 東洋風 / 古典的なポートフォリオを作って」
- 「隷書スタイルのウェブサイト / スタジオホームページを作って」
- 「白屋スタイルのポートフォリオを作って」 / 「Gurgel D'Alfonso のような横書きリストサイトを作って」
- 「lishu-portfolio-gen ...」
そして、以下を提供する場合:
- スタジオの説明(必須):名前、主宰者、都市、分野、何作品かのタイトルとストーリー
- 作品画像(オプション):URL / アップロード / パス。なくても動作します(picsum でプレースホルダー)
ユーザーが作品のタイトルをまったく与えなかった場合 → 少なくともどの作品を表示するか、一度質問する必要があります。 ユーザーがタイトルだけで詳細を与えなかった場合 → 自分で作成する:各作品に1文のリード + 3段落の散文 + 6-8行のスペック + 3-6枚のpicsum画像 + いくつかのクレジットを生成します。トーンは作品のタイプに合わせます(本 → 装丁 / フォント → フォント / 物 → 静物 / 展 → 展覧会ビジュアル)。
2つの動作モード
モード 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作品 | 参照:リスト項目の言い回し、散文のトーン、スペックの語彙、JSONフィールドの密度 |
template.html | 空のスケルトン — 同じCSS/JS/ルーティングシステム、2つのサンプル作品 + 20箇所の SWAP マーク | これをベースに変更し、最終的なHTMLを出力 |
README.md | ユーザー視点の使用説明 | モデルは見る必要はない |
SKILL.md | モデル向けワークフロー(本ファイル) | 必読 |
コアルール:すべての変更は template.html をベースに行う;reference.html からは書き方(トーン、文字数、タグの語彙)を学び、具体的な内容はコピーしない。
作業手順
1. 2つのHTMLを読む
- 最初に
reference.htmlを読み、「完成後がどのようなものか」を理解する(特にworks-dataJSON のフィールド密度と散文のトーン) - 次に
template.htmlを読み、20箇所の SWAP 位置を見つける
JSは変更しない / CSSは変更しない / 詳細ページのルーティングシステムは変更しない / フォントの読み込みは変更しない。 SWAP はすべてHTMLテキストとJSONデータ内にあります。
2. ユーザー入力を解析して情報を抽出
抽出するもの:
- ATELIER_NAME_ZH — スタジオの中国語名(2-4文字が最適、例「白屋」「素園」「墨記」「青廬」「拙軒」)
- PINYIN — ピンイン(5-6文字の英字、すべて大文字:BAIWU / SUYUAN / MOJI)
- CHAR — ロゴに使用する一文字(通常はスタジオ名の最初の文字:白 / 素 / 墨 / 青 / 拙)
- 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 —
都市、年 · 技法/仕様(ホバー時に表示) - meta — 4つのキーと値のペア(詳細ページの4列サマリー)
- lead — 30-70文字の開幕の大文字、
<em>キーワード</em>で一箇所強調可能 - prose — 3-4段落の散文、各段落80-150文字
- specs — 6-10行のスペック表(判型/用紙/製本/フォント/刷部数/印刷/技法/価格など)
- gallery — 3-6枚の画像、レイアウトは
g-wide/g-half/g-thirdから選択 - credits — 4-7組の役職/名前
もしユーザーが一言/ストーリーを与えなかった場合 → 自分で作成する:作品のタイトルとタイプに基づき、作品のトーンに合ったリードと散文を書きます。トーンは reference.html を参考に — マーケティング的な言葉ではなく、「博物館の壁面テキスト + スタジオノート」のような感覚(抑制が効いていて、具体的で、ゆっくりとしていて、手作りの痕跡がある)。
3. 作品をリストアップし、寸法を調べる(モード A のみ)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
各画像の (filename, w, h, aspect) を取得します。リストのサムネイルには縦長の画像を優先して選びます(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 の3ブロック | © / ICP / ソーシャルリンク |
| 20 | works-data JSON | N 件の作品の完全な詳細データ(最重要!) |
5. works-data JSON を書く(最も重要なステップ)
各作品は JSON 配列内に1つのエントリーを持ち、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 の注意点 ⚠️:
- 中国語の散文内で引用符を使う場合 → 全角の
「...」または『...』(U+201C / U+201D)を使用する必要があり、ASCII の"は使用不可(JSON が壊れる) - JSON 文字列内に実際の改行を入れないでください;段落を分けたい場合は prose 配列に項目を追加してください
lead内の<em>語</em>はHTMLタグとしてそのまま記述——レンダリング時に innerHTML として出力されます- gallery の
layoutは3つのうちから選択:g-wide(横幅いっぱい)/g-half(半分の幅)/g-third(1/3の幅)
6. 画像ソースの選択
- picsum プレースホルダー:
seed/X形式ではなくid/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作品、行にホバーしてサムネイルを表示、クリックで詳細ページへ。Light/Dark は左下、リスト/ギャラリーは上部中央。
モード B:完全なHTMLコードブロック + 一行の説明を直接提供。
上記を
index.htmlとして保存し、ダブルクリックして開いてください。マウスを作品名に移動すると右側に浮かび上がるサムネイルが表示され、クリックで詳細ページにジャンプします。画像を変更するには、picsum URL をあなたの画像アドレスに置き換えてください。
強制保持(変更不可)
- フォントの読み込み:
@font-faceで阿里媽媽刀隷体の woff2 url を読み込む(フォントソースを変更しないこと) - CSS 変数システム:light/dark の二重テーマ
- すべての JS:テーマ切り替え、ビューモード切り替え、ホバー行のインタラクション、rotating credit、詳細ページのハッシュルーティング
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 の5つの固定配置要素
よくある間違いとチェックリスト
- slug の不一致:list 項目の
#work/kong-shan-ji↔ gallery 項目の#work/kong-shan-ji↔ JSON の"slug": "kong-shan-ji"—— 3箇所が完全に一致している必要がある - JSON の引用符:中国語の内容内の引用符は必ず全角の「」または『』を使用し、ASCII の
"は使用しない - gallery が多すぎる:各作品の画像は最大6枚まで、超えるとレイアウトが崩れる
- prose が長すぎる:各段落80-150文字、200文字を超えると読みやすさが低下する
- list / gallery の同期不足:同じ作品セットを含む必要がある(一対一対応)
- picsum seed:
id/Xを使用しseed/Xは使わない。ランダムIDで削除済み画像に当たるのを避けるため - 作品が3点未満:問題ない、最低2点から動作する
- 作品が8点超:2回に分けることを推奨、リスト行が多すぎるとページが長くなる
- 頭文字のドロップキャップ:詳細ページの
.detail__prose p:first-of-type::first-letterに刀隷体を使用——最初の段落は中国語で始まる必要がある(<em>や英語で始めないこと) - picsum のカラー削除:画像はカラーを保持する必要があり、CSS で
filter: grayscale()を追加しないでください