kami-landing
產生一份 kami (紙) 設計系統的單頁文件。 美學借鑑於編輯印刷、技術白皮書和舊式打字機書信 — 目標是「好內容配上好紙張」,而非「現代應用程式 UI」。
設計系統事實來源:
design-systems/kami/DESIGN.md。 在交付前請先閱讀。權杖(Token)、字體規則、「十項不變原則」以及禁止使用的顏色都在那裡。
你將獲得
一個自包含的 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))。不使用硬陰影、新擬物風格或 backdrop-filter 模糊效果。 - 標籤填充使用純色十六進位碼(例如
#E4ECF5),絕不使用rgba()— 列印渲染器會雙重繪製透明標籤。 - 響應式設計,支援 1280 / 980 / 768 / 560 像素寬度。
頁面結構
1. 眼眉列 — 語言切換器 · 版本號 · 版本 (12px sans 大寫)
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 中的權杖。不要發明新的顏色、粗細或字體家族。
代理可以插入的元件基本元素(全部定義在範例的 <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 個英文單詞;CJK 文字 ≤ 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),此設計系統改編自該專案。