Communitygithub.com

AradhanaID/agent-skills

UI 樣式規則 — 統一字型、以間距取代邊框、80-20-10 色彩配置。在撰寫 UI 時自動套用。

agent-skills 是什麼?

這是一個針對 AI 代理程式(如 Claude Code、Cursor 等)設計的 UI 樣式技能,用於在開發過程中強制套用統一的設計系統。它要求代理程式在撰寫任何 UI 程式碼前,先讀取 `reference.md` 中的風格規則,並根據這些規則來檢查現有程式碼庫的字型、調色盤、圖示集與圓角等設定。主要規則包括:優先使用間距(whitespace)來分隔元素,只有在空間不足時才使用邊框;顏色分配遵循 80% 中性色、20% 次要色、10% 強調色的比例;確保行動版型沒有水平滾動,且文字顏色避免使用純黑或純白。此技能可支援任何能讀取並遵循 markdown 規則的 AI 程式碼生成工具,幫助開發者維持 UI 的一致性與可讀性。

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

在你喜歡的 AI 中提問

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

說明文件

設計系統

專案的 UI 偏好設定,必須在建構時套用,而非事後修正。在未查閱 reference.md 的情況下撰寫 UI,會導致任何步驟執行前就違反了平面處理規則;這些規則位於 context in reference.md 中,且需優先載入。

步驟

  1. 先讀規則,再檢視現有 UI。 套用 reference.md 中的樣式規則,然後找出程式碼庫已使用的內容 — 其字型、調色盤、圖示集與圓角設定。 完成條件:規則已載入實作計劃中;程式碼庫中既有的每一條規則皆被匹配,而非重新整理。
  2. 先以間距取代邊框。 使用空白間距分隔元素;只有當間距不足以區分時,才加入邊框。 完成條件:每個元素邊界僅透過空間呈現;邊框僅存在於計劃中說明為何間距不足之處。
  3. 顏色分為三個區塊。 在撰寫樣式之前,為每個區塊分配:中性色 → 80%、次要色 → 20%、強調色 → 10%;藥丸或徽章元件由強調色占據其位置。 完成條件:控制項與文字僅以 1 到 2 種中性色調呈現;強調色在每個視圖中最多出現一個位置。
  4. 驗證響應式設計與可讀性。 在宣告樣式完成前,先以行動裝置寬度檢視畫面;接近純黑或純白的文字應脫離極端值。 完成條件:行動版型無水平滾動;所有文字顏色均為非極端色調。
  5. 適應圖示庫。 偵測專案的圖示庫,並在每個出現處重複使用同一組圖示。 完成條件:依照規則選用一個圖示,且未引入新的圖示集。

參考資料

  • reference.md — 十一條樣式規則、色彩劃分及一組完整圖示規則。所有知識指向此處;本檔案無需被修改。

Individual skills in this repo

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

相關技能