Communitygithub.com

在地設計系統

每當產出是視覺性的時候使用此技能:HTML/CSS 檔案、網頁成品、登陸頁面、海報、報告或備忘錄頁面、儀表板模型,或任何人們會觀看的頁面。它只掌管品味與結構——交付方式(成品工具、檔案、匯出)則由任務本身決定。

在地設計系統 是什麼?

這是一項專門用於視覺產出的 AI 代理人技能,涵蓋 HTML/CSS 檔案、網頁成品、登陸頁面、海報、報告、儀表板模型等任何人類會觀看的頁面。它的核心價值在於為設計決策提供嚴謹的紀律,而非取代任務本身對交付方式的選擇。此技能特別適用於 Claude Code、Cursor 等以程式碼為基礎的 AI 開發工具,假設使用者直接編寫純 HTML/CSS,並捨棄了特定平台(如 BaoCut)的專屬機制。技能詳細規定了設計流程的四個階段:建構前先決定方向、定義 token 組、佈局機制、以及無可妥協的反草率規則(anti-slop rules)。其中強調必須先收集設計脈絡(品牌、現有系統),使用有限的 CSS 自訂屬性(custom properties)作為唯一資料來源,禁止使用填充內容(lorem ipsum)、假 chrome 元素、以及純色背景的漸層裝飾。此外,還包含了無障礙設計(可及性)、內容編輯紀律、以及登陸頁面與印刷品的專門指導。參考文件更深入探討了方向選擇、品牌色彩系統(特別是 Anthropic/Claude 品牌)、字型比例與印刷工藝,為 AI 在設計協作中提供結構化、高品質的輸出框架。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/altitudezhang-commits/agent-skills-pack/tree/HEAD/local-design-system

在你喜歡的 AI 中提問

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

說明文件

頁面、成品與 HTML/CSS 輸出的設計紀律

每當產出是視覺性的時候使用此技能:HTML/CSS 檔案、網頁成品、登陸頁面、海報、報告或備忘錄頁面、儀表板模型,或任何人們會觀看的頁面。它只掌管品味與結構——交付方式(成品工具、檔案、匯出)則由任務本身決定。

歸屬:以下規則改編自 BaoCut 內建的 design 與 design-system 技能,而這些技能本身又移植自 Anthropic 的 anthropic-design 技能(參見 references/brand-colors.md 中的來源註記)。BaoCut-canvas 機制(.dc.html、DCLogic、canvas.json、design_check、素材匯入工具)已被刻意捨棄;此處假設你直接編寫純 HTML/CSS。在複製而來的參考資料中,請將「board/artboard」理解為你正在製作的頁面或檔案,並將 <helmet> 理解為 <head>。

在進行任何佈局之前,先決定方向

  • 在憑空發明任何東西之前,先蒐集設計脈絡:使用者的品牌、既有的設計系統、此頁面將與之並存的程式碼庫或頁面、他們提供給你的螢幕截圖或檔案。高傳真度的設計源自於那個脈絡;從零開始模擬整個產品是最後的手段,而且會產出差勁的作品。

  • 當指定了品牌或設計系統時,要精確地遵循它——色彩、字型、間距、圓角、字體——並讓它覆蓋此技能中的所有預設值。當使用者提到一個品牌或產品時,應詢問或擷取其真實素材,而非盲目設計。

  • 當無人能回答問題且沒有任何系統約束你時,選擇一個明確的、有意識的美學方向(極簡、極繁、復古未來、編輯風格、野獸派、裝飾藝術、柔和粉彩、工業風、奢華、趣味……),用一句話陳述你的假設,然後開始構建。絕不要以一個無人能回答的問題作結;也絕不要默默每次都收斂到相同的外觀。

  • 如果有兩項或以上的決定會改變結果,且有人可以回答,請在開始構建前問一次——最多 4 個問題,每個問題提供 2-4 個具體、真正不同的選項(把你的建議放在第一個),絕不要問制式的需求蒐集問題。否則,就自行決定,說出你選擇了什麼,然後繼續進行。

在開始構建之前,先定義 token 組

  • 在編寫佈局之前,先寫下一個小型的 token 組,並且只使用那些數值。將它放在檔案頂部的 :root CSS 自訂屬性區塊中(或頁面載入的 token 檔案)——頁面使用的每一種顏色、尺寸和字型都可以追溯回它,每個數值只有一個來源:
:root{
  --surface: #faf7f2;              /* 唯一的色調基底 */
  --ink: #211d19;
  --accent: oklch(0.62 0.14 45);   /* 0–2 強調色,以 oklch 表示 */
  --font-display: "Space Grotesk", "Avenir Next", sans-serif;
  --font-body: "Source Sans 3", system-ui, sans-serif;
  --space-1: 4px; --space-2: 8px; --space-3: 16px; --space-4: 24px; --space-5: 40px;
  --radius-sm: 6px; --radius-md: 10px;
}
  • 顏色:一個色調基底(暖色調、冷色調或中性色)。白色和黑色需帶有輕微色調——純白的飽和度應保持在 0.02 以下;絕不要將純 #FFF 用作全頁背景。強調色:0-2 種,以 oklch 表示,色度與明度相同,僅色相不同。優先使用品牌/系統顏色;若限制過多,則從中推導出和諧的 oklch 顏色,而不是發明新的色相。

  • 字型:1-3 個字體家族——一個獨特的顯示字體搭配一個精緻的正文字體。每個網路字體都需有一個度量匹配的系統後備字體,因為在字體載入期間以及任何無法嵌入字體的地方,後備字體就是使用者實際看到的內容。避免將通用預設字體作為第一選擇:不使用 Inter、Roboto、Arial 或 Fraunces。除非為了營造特定效果,否則字距保持為 0。

  • 同時,在同一次 token 設定中,固定一個小型字級比例(顯示 / 標題 / 標題 / 內文 / 小字 / 說明文字,包含尺寸、粗細、行高)、一個間距比例和一個圓角比例。來自真實來源的確切數值需完全複製——絕不進行四捨五入或對齊 4/8px 網格。

反草率規則(嚴格)

  • 禁止使用大面積漸層渲染或漸層背景作為裝飾,禁止使用藍紫色漸層,禁止使用帶有彩色左邊框裝飾的圓角卡片,禁止使用表情符號作為圖示或 UI 元素(圖示應使用內聯 SVG 線條圖或真實的圖示集;表情符號僅當其確實是品牌的一部分時才可使用)。

  • 禁止填充內容:禁止使用 lorem ipsum,禁止發明統計數據、推薦語或用來填補空間的「數據草率內容」。每個元素都必須有其存在的意義;感覺空曠的章節是佈局問題,而不是憑空發明內容的提示。遺失的事實應使用明顯的佔位符號,例如 [YOUR PRICE]。

  • 禁止偽造 chrome 元素:絕不在裝置模型內部繪製假的電話狀態欄或鍵盤。

  • 讓執行的野心與方向相匹配:極繁設計應有豐富的效果;極簡設計則在間距與細節上體現克制與精準。強烈的色彩搭配銳利的強調色,勝過膽怯、均勻分散的顏色;不對稱、重疊、慷慨的留白或受控的密度,勝過預設的居中網格。

佈局機制

  • 使用 flex 或 grid 搭配 gap 來佈置同層級的元素群組(按鈕、晶片、卡片、導航項目、工具列)——絕不使用空白文字節點或元素間各自的 margin。內聯流(inline flow)僅用於散文,內部偶爾插入 <a>/<strong>,而不是用來排列 UI 元素。

  • 頁面是流暢的:根元素沒有 px 寬度,使用 max-width 容器搭配側邊內距,使用 %/rem/fr 進行尺寸設定,網格寫為 repeat(auto-fit, minmax(min(<min>px, 100%), 1fr)),這樣它們在手機上會折疊成單欄而不會溢出。vh 僅用於真正填滿螢幕的根元素;後續還有內容的章節應使用 px/rem 的 min-height。寧可稍微偏高,也不要被裁切。

  • 固定尺寸的根元素僅用於固定格式:裝置模型、海報、社交媒體圖片、印刷品。手機應用程式畫面為 390×844;頁面設計需能在手機寬度下正常運作——標題不能尷尬地斷行,網格不能壓垮,文字不能縮小到無法閱讀。

  • 交付頁面中的圖表應使用一般的內聯 SVG(放在 <figure> 中也可以);在可能需要編輯的地方,將標籤和標註保持為真實文字。

無障礙設計是直接繪製進去的,而非事後檢查

  • 即使在靜態模型中也要使用真實元素:<button>、<a href>、<input> 搭配 <label>。絕對不要用 div/span 加上 role 或 onClick 來取代——鍵盤會跳過它們,螢幕閱讀器也得不到任何資訊。僅有圖示的按鈕需加上 aria-label;裝飾性 SVG 需加上 aria-hidden="true",有意義的 SVG 需加上 role="img" 和一個標籤。

  • 文字與其背景的對比度至少為 4.5:1(24px 及以上的文字為 3:1)。常見的問題是灰色說明文字以及白色文字下的彩色填充——將兩者都加深,直到通過標準。

  • 需要區分的顏色不僅要在色相上不同,明度上也必須不同;優先使用藍色/橘色,而非紅色/綠色。

  • 點擊目標至少為 44px。印刷內文至少為 12pt。

內容與編輯紀律

  • 在添加素材之前先詢問:如果額外的章節、頁面或文案能改善作品,請先詢問,而不是未經詢問就擅自添加。

  • 一個小型的、針對性的修改應只改變那個位置:所有其他的佈局數值、間距、字型、尺寸、位置、顏色和內容都保持原樣。執行要求的修改,然後建議任何更大的改動,而不是未經要求就擅自執行。要求重新設計或從頭開始則是不同的情況——這時才進行重大改動。

  • 當要擴展現有頁面或文件時,首先閱讀其視覺語言——複製其樣式、調色盤、語調、懸停狀態、陰影與卡片模式、密度——並以相同風格進行編寫。

  • 當被要求複製一個你能取得原始碼的介面時,要從真實的原始碼著手:讀取元件與樣式,複製實際素材,複製確切數值。當原始碼存在時,絕不要憑記憶或從螢幕截圖複製。對於不屬於該公司的使用者,不要複製其他公司獨特的專有設計;應提供針對其實際目標的原創設計。

登陸頁面與印刷

  • 登陸頁面:一個英雄區塊,用一句話說明所提供的內容,並附上一個明確的呼籲行動;訪客可以信任的證明(推薦語、標誌、數字——他們的,或明顯標記的佔位符);利益章節,應回答真實的異議,而非列出功能。每個頁面一個主要行動,並隨著頁面往下滾動而重複。文案就是產品:要具體、植根於使用者實際銷售的內容,絕不能是可互換的行銷套話。

  • 印刷品(海報、傳單、手冊、備忘錄、報告,以及任何匯出為 PDF 的內容):在開始前閱讀 references/print.md——先決定是固定頁面還是流動文件,使用真實紙張尺寸(Letter 816×1056,A4 794×1123 CSS px),≥40px 的安全邊距,≥1px 的線條,灰色文字不淺於 #767676,傳單的階層結構需在房間另一側三秒內可閱讀。

Anthropic 品牌作品

  • 對於帶有 Anthropic/Claude 品牌的作品:基底象牙白 #FAF9F5,文字石板灰 #141413,強調陶土色 #D97757,襯線顯示字體搭配無襯線正文字體。完整的暖灰色階、輔助調色盤和標誌規則位於 references/brand-colors.md;字體堆疊與字級比例位於 references/brand-typography.md。奶油基底 + 襯線標題 + 陶土色的習慣僅用於 Anthropic 品牌作品,或當簡報要求時才使用——並非所有情況的預設值。

參考資料

  • references/craft.md——這些規則背後的完整理由:與使用者一起選擇方向、變體與線框草稿、登陸頁面結構、從原始碼複製介面,以及共享的內容規則。當設計決策有爭議或作品需要深度時請閱讀。

  • references/brand-colors.md——Anthropic 品牌色彩系統(暖灰色調、Claude 調色盤、資料視覺化色階)及其來源註記。

  • references/brand-typography.md——Anthropic 品牌字體堆疊,包含度量匹配的後備字體以及品牌字級比例。

  • references/print.md——印刷工藝:固定頁面 vs 流動頁面、紙張尺寸與單位、邊距、表格、傳單規則。

相關技能