Communitygithub.com

googril/cue-skills - kami 單頁文件技能

製作一份可印刷等級的單頁 kami(紙)文件——溫暖羊皮紙背景、墨藍色強調、同一字重的襯線字體、無斜體、無冷灰色調。輸出成品讀起來像專業白皮書或工作室一頁式文件,而非應用程式介面。多語言設計(EN·zh-CN·ja)。單一自包含 HTML 檔案,無外部依賴。

cue-skills - kami 單頁文件技能 是什麼?

此技能使用 kami (紙) 設計系統,製作一份可直接列印的單頁 HTML 文件。該設計系統借鏡編輯印刷、技術白皮書與舊式打字機信件的風格,目標是呈現「好內容放在好紙上」的感覺,而非現代應用程式介面。文件具有溫暖的羊皮紙背景 (#f5f4ed)、單一墨藍色強調色 (#1B365D,覆蓋面積 ≤ 5%)、以及一種字重 (500) 的襯線字體(根據語言參數自動選擇英文的 Charter、簡體中文的 TsangerJinKai02 / Source Han Serif,或日文的 YuMincho)。嚴格禁止斜體、冷灰色調、 rgba() 顏色、以及 JavaScript 動畫。技能還會透過兩輪對話收集品牌簡報,並生成包含頁眉、英雄區、宣言區、指標區、章節和頁尾的結構化文件。所有樣式均內嵌於單一 HTML 檔案中,無需任何外部依賴。支援 macOS、終端機中的 Claude Code、以及 Cursor 等平台。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/googril/cue-skills/tree/HEAD/autoclaw-design-capability-noqa/%E5%AE%A1%E7%BE%8E%E7%9B%B8%E5%85%B3skill/design-skeletons/kami-landing

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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(或同等功能)分塊收集品牌簡報。不要一次性將整個輸入列表拋給使用者;應分兩輪詢問:

  1. 身份輪次 —— 名稱、標語、地點、版本 / 版號、主要網址、主要語言。
  2. 內容輪次 —— 宣言段落 + 簽名、3-6 個指標方塊、3-5 個章節(標題 + 引文 + 正文)條目。

2. 選擇語言堆疊

language 參數控制設定在 :root 上的 --serif 字型堆疊。根據宣言與章節正文的主要語言進行選擇:

language--serif備註
enCharter, Georgia, Palatino, Times New Roman, serif預設值
zh-CNTsangerJinKai02, Source Han Serif SC, Songti SC, Georgia正文字距 0.35px
jaYuMincho, 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。這個頁面是紙,不是應用程式 —— 動態效果屬於閱讀者的滾動行為。

另請參閱

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能