Communitygithub.com

alty-oss/dev-design

用於在實作前盤點現有 UI token/元件,並定義一致性的 token 與元件合約。

dev-design 是什麼?

此技能旨在協助開發者與 AI 代理在開始實作 UI 之前,先系統性地盤點現有元件、設計標記(token)、字體、間距與互動慣例。它強調「重複使用」勝於「新增平行系統」,以避免設計不一致。技能會引導使用者撰寫標準化的 tokens.json 與元件決策文件(遵循 artifact 合約範本),並強制將語意角色(如表面色、文字色、動作色、狀態色)對應到既有的標記參考。對於缺少對應標記的情況,則需根據方向性文檔(direction.md)定義簡潔的值。技能也涵蓋色彩角色、字體排版、間距、圓角與動態效果的定義,以及焦點與禁用狀態的處理方式。每個受影響的元件都必須在 flows.md 或 direction.md 中記錄其用途、API/變體、狀態、響應式規則與無障礙行為。最後,技能嚴格禁止在未確認現有技術棧與使用者限制前,擅自引入新的 UI 函式庫或字型依賴,以維護品牌選擇的一致性。支援的平台包括 Claude Code、Cursor 與其他遵循開放合約的 AI 代理工具。

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

在你喜歡的 AI 中提問

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

說明文件

設計系統

Português (Brasil)

首先盤點現有元件、標記(token)、字體、間距與互動慣例。重複使用勝於新增平行系統。

使用 artifact 合約 撰寫 tokens.json 與元件決策。將語意角色對應到現有標記參考(若有);否則定義與 direction.md 一致的簡潔值。

涵蓋色彩角色、字體排版、間距、圓角與動態效果。定義焦點與禁用狀態的處理方式。區分表面/文字/動作/狀態角色。

對於每個受影響的元件,在 flows.md 或 direction.md 中記錄其用途、API/變體、狀態、響應式規則與無障礙行為。

未確認當前技術棧與使用者限制前,請勿引入新的 UI 函式庫或字型依賴。保留明確的品牌選擇。

Individual skills in this repo

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

相關技能