kami-landing
使用 kami(紙) 設計系統產生一份單頁文件。其美學借鑑自編輯印刷、技術白皮書和舊式打字機書信風格——目標是優質內容印在好紙上,而非現代應用程式 UI。
可攜式設計系統合約: 此技能中的代碼標記、字型規則、不變量和禁止使用的顏色為最終依據。請勿仰賴可能無法隨技能一起移動的儲存庫層級設計系統檔案。
你將獲得
一個單一自包含的 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 sans-serif 大寫)
2. 英雄區 — 展示標題(96–106px serif 500),標語(21px),
三個英雄代碼晶片(紙色調背景)
3. 宣言區 — 引用段落,serif 400,20px,行高 1.65,
帶墨水藍左側邊框和簽名頁尾
4. 指標列 — 3–6 個儲存格:數值(24px serif 500 墨水藍,tabular-nums),
標籤(12px serif 500 橄欖色)
5. 章節區 — 編號(`01`、`02`、…)墨水藍 serif 500 14px,
章節標題 28–32px,內文 14–15px
6. 頁尾 — 結語詞(特大 serif 500),授權 · 年份 · 聯絡方式,
三欄網站索引,12px serif 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——帶左側邊框的 serif 500 引言ul.dash——墨水藍色的破折號項目符號.code——淺米色背景、1px 邊框的程式碼區塊.footer-kicker——特大 serif 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 個單詞;中日韓文字(CJK)≤ 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。頁面是紙,不是應用程式——動態效果應由讀者捲動產生。
參閱
skills/kami-deck/——姊妹技能,能以相同的 kami 語言產生投影片。- 上游:
tw93/kami——本設計系統所改編的原始 Claude 技能(MIT 授權)。