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模糊效果。 - 標籤填充使用純色 Hex (例如
#E4ECF5),絕不使用rgba()— 因為印刷渲染器會雙重繪製帶 Alpha 的標籤。 - 支援回應式設計,適用於 1280 / 980 / 768 / 560 寬度。
頁面結構
1. 瀏覽列 — 語言切換器 · 版本 · 版本號 (12px 無襯線大寫)
2. 英雄區 — 顯示級標題 (96–106px 襯線字重 500)、副標題 (21px)、
三個英雄 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 中的 Token。不要發明新的顏色、字重或字型系列。
可內嵌的元件基本元素 (均定義於範例的 <style> 區塊中):
.eyebrow、.label— 無襯線上標線.metric— 數值 + 標籤垂直配對.section-num+.section-title+.section-lede.tag.standard、.tag.brush— 純色 Hex 標籤 (每頁最多一個 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。 - 所有標籤填充皆為純色 Hex (例如
#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 # 標準 OpenDesign 渲染
邊界
- 請勿發明新的顏色或字型。kami 調色盤是固定的;如果簡報要求品牌色,請拒絕,或將品牌色呈現為單一
.tag.brush強調。 - 請勿引入第二個強調色。選擇墨藍色,或什麼都不選。
- 請勿在單一宣告中混合所有三種字型堆疊;選擇主要語言,在
:root上覆蓋--serif,讓瀏覽器的逐字元後備鏈結解析內文中混用不同書寫系統的內容。 - 請勿使用
rgba()作為標籤填充 — 印刷渲染器會雙重繪製 Alpha 標籤。請使用design-systems/kami/DESIGN.md§2 表格中預先混合的純色 Hex。 - 請勿加入 JavaScript 用於動畫。頁面是紙張,而非應用程式 — 動態效果應留給讀者自行滾動。
參見
design-systems/kami/DESIGN.md— 完整的 Token 規範。design-templates/kami-deck/— 姊妹技能,用於以相同的 kami 語言產生投影片。- 上游專案:
tw93/kami— 該設計系統所改編的原始 Claude 技能 (MIT 授權)。