kami-landing
產生一份基於 kami(紙) 設計系統的單頁文件。 其美學借鑑了編輯印刷、技術白皮書與老式打字機書信 — 目標是好內容在好紙上,而非現代應用程式 UI。
設計系統權威來源:
design-systems/kami/DESIGN.md。 在交付前請務必閱讀。色票、字型規則、「十不變原則」以及禁止使用的顏色都定義於此。
你會得到什麼
一個完全自包含的單一 HTML 檔案,包含:
- 溫暖的羊皮紙底色(
#f5f4ed)— 絕不使用#ffffff。 - 單一色相強調色 — 墨水藍(
#1B365D),僅用於章節編號、標題強調詞、宣言的左側邊線以及指標數值。在其他任何地方,墨水藍的覆蓋面積不得超過文件可視區域的 5%。 - 單一字重 (500) 的襯線字體用於層級 — 英文使用 Charter,中文使用 TsangerJinKai02 / 思源宋體,日文使用 YuMincho,透過
language參數選擇。任何地方都不使用斜體。 - 緊湊的印刷節奏 — 行高 1.10–1.55,字距根據語言調整(英文 0,簡體中文 0.35px,日文 0.02em)。
- 數值堆疊設定
font-variant-numeric: tabular-nums,使指標欄位與頁碼數字能整齊對齊。 - 透過 1px 邊框與輕柔陰影創造深度(
0 4px 24px rgba(0,0,0,0.05))。不使用生硬的下拉式陰影、新擬物風格或背景濾鏡模糊效果。 - 標籤填充使用純色十六進位碼(例如
#E4ECF5),絕不使用rgba()— 因為印刷渲染器會重複繪製帶透明度的標籤。 - 響應式設計,支援 1280 / 980 / 768 / 560 像素寬度。
頁面結構
1. Eyebrow 行 — 語言切換器 · 版本 · 版號(12px 無襯線大寫)
2. Hero 區域 — 顯示級標題(96–106px 襯線 500)、副標語(21px)、
三個 hero-token 標籤(紙色調)
3. 宣言區 — 襯線 400 拉引段落,20px,行高 1.65,附
墨水藍左側邊線與簽名頁腳
4. 指標行 — 3-6 個區塊:數值(24px 襯線 500 墨水藍,tabular-nums)、
標籤(12px 襯線 500 橄欖色)
5. 章節 — 編號(`01`, `02`, …)墨水藍襯線 500 14px,
章節標題 28-32px,內文 14-15px
6. 頁腳 — 強調詞(大型襯線 500)、授權 · 年份 · 聯絡方式、
三欄站點索引(12px 襯線 500)
工作流程契約
1. 收集品牌簡介
使用 AskQuestion(或同等功能)分塊收集品牌簡介。不要一次將整個輸入清單丟給使用者;分兩輪提問:
- 識別輪 — 名稱、標語、地點、版本 / 版號、主要 URL、主要語言。
- 內容輪 — 宣言段落 + 簽名、3-6 個指標區塊、3-5 個章節(標題 + 引言 + 內文)項目。
2. 選擇語言堆疊
language 參數控制 :root 上設定的 --serif 堆疊。根據宣言和章節內文的主要語言來選擇:
language | --serif | 備註 |
|---|---|---|
en | Charter, Georgia, Palatino, Times New Roman, serif | 預設值 |
zh-CN | TsangerJinKai02, Source Han Serif SC, Songti SC, Georgia | 內文字距 0.35px |
ja | YuMincho, Hiragino Mincho ProN, Source Han Serif JP | 同時將 --olive 覆寫為 #4d4c48(YuMincho 筆畫較細) |
混合腳本的內聯內容是允許的 — 瀏覽器會自動按字符級別處理字體回退。不要將三種字體家族串聯在一個 font-family 宣告中;這會稀釋字符特性。
3. 撰寫 index.html
輸出一個所有 CSS 皆內聯的單一檔案。鏡像 example.html 的結構,並僅使用 design-systems/kami/DESIGN.md 中的色票。不要發明新的顏色、字重或字體家族。
代理可直接使用的組件基本元素(全部定義於範例的 <style> 區塊中):
.eyebrow,.label— 無襯線頂線文字.metric— 數值 + 標籤垂直配對.section-num+.section-title+.section-lede.tag.standard,.tag.brush— 純色十六進位標籤(每頁最多一個 brush 標籤).quote— 左側邊線襯線 500 引用ul.dash— 墨水藍破折號項目符號.code— 象牙色背景、1px 邊框的程式碼區塊.footer-kicker— 大型襯線 500 強調詞
為每個可編輯元素標記 data-od-id="<unique-slug>",以便主機應用程式的評論模式可以定位它。
4. 交付前自我檢查
- 頁面背景是羊皮紙色(
#f5f4ed),絕非#ffffff。 - 墨水藍(
#1B365D)覆蓋面積不超過可視區域的 5% — 計算章節編號、宣言邊線、指標數值、標題強調詞。總計 ≤ 5%。 - 所有灰色皆為暖色(R ≈ G > B)。無
slate-*,無#f3f4f6。 - 襯線字體重量維持 500 — 襯線文字任何地方都不能有
font-weight: 700或900。 - 任何地方都沒有
font-style: italic。強調改用墨水藍顏色或.tag。 - 所有數值堆疊(指標數值、分頁、日期、財務數字)都帶有
font-variant-numeric: tabular-nums。 - 所有標籤填充都是純色十六進位碼(例如
#E4ECF5),絕非rgba()。 - 陰影:最多一個
1px邊框或0 4px 24px rgba(0,0,0,0.05)的輕柔陰影。無生硬的下拉式陰影。 - 顯示級標題英文 ≤ 6 個單詞;中日韓文 ≤ 8 個字符。
- 在 768px 和 560px 寬度下,佈局折疊為單欄且無橫向滾動。
此技能中的檔案
design-templates/kami-landing/
├── SKILL.md # 此契約
├── README.md # 人類快速入門指南
└── example.html # 標準的 MishMash 渲染範例
邊界
- 不要發明新的顏色或字體。kami 調色板是固定的;如果品牌簡介要求品牌色,請拒絕,或將品牌色渲染為單一的
.tag.brush強調色。 - 不要引入第二個強調色。選擇墨水藍,或者不選擇任何顏色。
- 不要將三種字體堆疊混合在一個宣告中;選擇主要語言,在
:root上覆寫--serif,讓瀏覽器按字符級別回退來處理混合腳本的內聯內容。 - 不要使用
rgba()作為標籤填充 — 印刷渲染器會重複繪製帶透明度的標籤。請使用design-systems/kami/DESIGN.md§2 表格中預先混合好的純色十六進位碼。 - 不要為了動畫效果添加 JavaScript。頁面是紙張,不是應用程式 — 動態效果屬於讀者滾動的範疇。
另請參閱
design-systems/kami/DESIGN.md— 完整的色票規範。design-templates/kami-deck/— 姊妹技能,用相同的 kami 語言產生簡報投影片。- 上游專案:
tw93/kami— 原始 Claude 技能(MIT 授權),此設計系統改編自該專案。