kami-landing
產生遵循 kami (紙 / 纸) 設計系統的單頁文件。其美學借鑑編輯印刷、技術白皮書與老式打字機書信——目標是好紙上的好內容,而非現代應用程式 UI。
設計系統源頭:
design-systems/kami/DESIGN.md。 出貨前請務必閱讀。權杖 (tokens)、字型規則、「十大不變性」以及禁用色彩都定義於此。
你會得到什麼
一個單一的自包含 HTML 檔案,包含:
- 溫暖羊皮紙畫布 (
#f5f4ed) —— 絕不使用#ffffff。 - 單一色彩強調——墨藍色 (
#1B365D),僅用於區塊編號、標題強調詞、宣言左邊框線以及指標數值。除此之外任何地方,墨藍色必須佔據文件可見表面 ≤ 5%。 - 單一字重 (500) 的襯線字體用於層級結構——英文使用 Charter,中文使用 TsangerJinKai02 / Source Han Serif (CN),日文使用 YuMincho (JA),透過
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))。不使用硬陰影、新擬物風格 (neumorphism) 或背景濾鏡模糊 (backdrop-filter blur)。 - 標籤填色使用純色十六進位碼 (例如
#E4ECF5),絶不使用rgba()——印刷渲染器會造成透明度疊加問題。 - 響應式設計,支援 1280 / 980 / 768 / 560 像素斷點。
頁面結構
1. 眼眉行 — 語言切換器 · 版次 · 版本 (12px 無襯線大寫)
2. 主視覺 — 顯示級標題 (96–106px 襯線 500)、標語 (21px)、
三個主視覺標籤晶片 (紙張色調)
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 中的權杖。不要發明新的色彩、字重或字體家族。
AI 助理可以直接套用的元件基礎 (全部定義於範例的 <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 的斷點下,佈局折疊為單欄,無水平滾動。
此技能中的檔案
skills/kami-landing/
├── SKILL.md # 本合約
├── README.md # 人類快速入門
└── example.html # 標準 Open Design 渲染範例
邊界
- 不要發明新的顏色或字體。kami 調色盤是固定的;如果簡報要求品牌色,請拒絕,或將品牌色渲染為單一的
.tag.brush強調元素。 - 不要導入第二種強調色。選擇墨藍色,或什麼都不選。
- 不要在單一宣告中混合所有三個字體堆疊;選擇主要語言,在
:root上覆寫--serif,讓瀏覽器逐字形後備來處理混用書寫系統的內嵌內容。 - 不要對標籤填色使用
rgba()——印刷渲染器會造成透明度疊加。請使用design-systems/kami/DESIGN.md§2 表格中預先混合的純色十六進位碼。 - 不要為了動畫效果新增 JavaScript。頁面是紙,不是應用程式——動態歸屬於閱讀者的滾動。
另請參閱
design-systems/kami/DESIGN.md—— 完整的權杖規格。skills/kami-deck/—— 使用相同 kami 語言產生投影片組的姊妹技能。- 上游專案:
tw93/kami—— 本設計系統所改編的原始 Claude 技能 (MIT 授權)。