kami-landing
製作一份 kami (紙 / 纸) 設計系統的單頁文件。 其美學借鏡編輯印刷、技術白皮書與舊式打字機信件——目標是讓好內容呈現在好紙上,而非現代應用程式介面。
設計系統的權威來源:
design-systems/kami/DESIGN.md。 出貨前請務必閱讀。代碼記號、字體規則、「十不變原則」以及禁用顏色皆定義於此。
你會得到什麼
一個單一、自包含的 HTML 檔案,包含:
- 溫暖羊皮紙背景 (
#f5f4ed) —— 絕不使用#ffffff。 - 單一色彩強調 —— 墨藍色 (
#1B365D),用於章節編號、標題強調詞、宣言左側線條以及指標數值。在其他任何地方,墨藍色覆蓋面積不得超過文件表面的 5%。 - 單一字重 (500) 的襯線字體用於層級結構 —— 英文使用 Charter,簡體中文使用 TsangerJinKai02 / Source Han Serif,日文使用 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. 眉列 — 語言切換器 · 版本 · 版號(12px 無襯線字體,大寫)
2. 英雄區 — 顯示標題(96–106px 襯線字體 500),標語(21px),
三個英雄標記晶片(紙色調背景)
3. 宣言區 — 引用段落,襯線字體 400,20px,行高 1.65,帶有
墨藍色左側線條與簽名頁尾
4. 指標列 — 3-6 個儲存格:數值(24px 襯線字體 500 墨藍色,表格數字),
標籤(12px 襯線字體 500 橄欖色)
5. 章節 — 編號(`01`、`02`、…)墨藍色襯線字體 500 14px,
章節標題 28-32px,內文 14-15px
6. 頁尾 — 強調字(大型襯線字體 500),授權 · 年份 · 聯絡方式,
三欄網站索引,12px 襯線字體 500
工作流程合約
1. 收集品牌簡報
使用 AskQuestion(或同等功能)分塊收集品牌簡報。不要一次性將整個輸入列表拋給使用者;應分兩輪詢問:
- 身份輪次 —— 名稱、標語、地點、版本 / 版號、主要網址、主要語言。
- 內容輪次 —— 宣言段落 + 簽名、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—— 純色十六進位標籤(每頁最多一個筆刷標籤).quote—— 左側線條襯線字體 500 的引用ul.dash—— 墨藍色的破折號項目符號列表.code—— 象牙色背景、1px 邊框的程式碼區塊.footer-kicker—— 大型襯線字體 500 的強調字
為每個可編輯元素標記 data-od-id="<唯一縮寫>",以便主機應用程式的評論模式可以定位到它。
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 # 標準開放設計渲染範例
邊界
- 不要發明新的顏色或字型。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)。