kami-landing 是做什麼的?
產生一份在 kami(紙) 設計系統下的單頁文件。其美學借鑑自編輯印刷、技術白皮書和舊式打字機通信——目標是好紙上的好內容,而非現代應用程式 UI。
設計系統的權威來源:
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)) 製造深度。不採用強烈投影、新擬物風格或 backdrop-filter 模糊。 - 標籤填充使用純色十六進位碼(例如
#E4ECF5),絕不使用rgba()——印刷渲染器會雙重渲染含 alpha 的標籤。 - 響應式——支援 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(或同等功能)分塊收集品牌簡報。不要一次列出所有輸入項目;應分兩輪詢問:
- 身分輪——名稱、標語、地點、版本 / 版號、主要網址、主要語言。
- 內容輪——宣言段落 + 簽名、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——墨水藍 en-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()——印刷渲染器會雙重渲染含 alpha 的標籤。應使用design-systems/kami/DESIGN.md§2 表格中預先混合好的純色十六進位碼。 - 不要為動畫加入 JavaScript。頁面是紙,不是應用程式——動態效果屬於讀者的滾動行為。
參見
design-systems/kami/DESIGN.md——完整的記號規格。skills/kami-deck/——姊妹技能,以相同的 kami 語言產生簡報。- 上游:
tw93/kami——此設計系統所改編的原始 Claude 技能(MIT 授權)。