/design-system
如果你看到不熟悉的佔位符號,或需要檢查已連接的工具,請參閱 CONNECTORS.md。
管理你的設計系統 — 進行一致性審計、記錄組件或設計新模式。
使用方式
/design-system audit # 完整系統審計
/design-system document [component] # 記錄一個組件
/design-system extend [pattern] # 設計一個新組件或模式
設計系統的組成
設計令牌 (Design Tokens)
定義視覺語言的原子值:
- 色彩(品牌色、語意色、中性色)
- 字體排印(比例、字重、行高)
- 間距(比例、組件內距)
- 邊框(圓角、寬度)
- 陰影(高度層級)
- 動態(持續時間、緩動函數)
組件 (Components)
可重複使用的 UI 元素,具有定義的:
- 變體(主要、次要、幽靈)
- 狀態(預設、懸停、激活、禁用、載入、錯誤)
- 尺寸(sm, md, lg)
- 行為(互動、動畫)
- 無障礙(ARIA、鍵盤)
模式 (Patterns)
結合多個組件的常見 UI 解決方案:
- 表單(輸入群組、驗證、提交)
- 導航(側邊欄、頁籤、麵包屑)
- 資料顯示(表格、卡片、列表)
- 回饋(吐司訊息、模態框、內聯訊息)
原則
- 一致性優先於創造力 — 系統的存在是為了讓團隊不必重複造輪子
- 在約束下保持靈活 — 組件應可組合,而非僵化
- 記錄一切 — 沒有記錄就不存在
- 版本化與遷移 — 重大變更需要遷移路徑
輸出 — 審計
## 設計系統審計報告
### 摘要
**審閱的組件數量:** [X] | **發現的問題數量:** [X] | **評分:** [X/100]
### 命名一致性
| 問題 | 涉及的組件 | 建議 |
|------|------------|------|
| [命名不一致] | [列表] | [應採用的標準] |
### 令牌覆蓋率
| 類別 | 已定義的令牌 | 發現的硬編碼值 |
|------|-------------|----------------|
| 色彩 | [X] | [X] 處硬編碼的十六進位色碼 |
| 間距 | [X] | [X] 處任意值 |
| 字體排印 | [X] | [X] 處自訂字型/大小 |
### 組件完整性
| 組件 | 狀態 | 變體 | 文件 | 評分 |
|------|------|------|------|------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### 優先處理動作
1. [最有影響的改進]
2. [第二優先]
3. [第三優先]
輸出 — 文件
## 組件:[名稱]
### 描述
[這個組件是什麼以及何時使用]
### 變體
| 變體 | 使用時機 |
|------|----------|
| [主要] | [主要操作] |
| [次要] | [輔助操作] |
### 屬性 / Props
| 屬性 | 型別 | 預設值 | 描述 |
|------|------|--------|------|
| [prop] | [type] | [default] | [description] |
### 狀態
| 狀態 | 視覺表現 | 行為 |
|------|----------|------|
| 預設 | [描述] | — |
| 懸停 | [描述] | [互動] |
| 激活 | [描述] | [互動] |
| 禁用 | [描述] | 不可互動 |
| 載入 | [描述] | [動畫] |
### 無障礙
- **角色 (Role)**: [ARIA role]
- **鍵盤**: [Tab, Enter, Escape 行為]
- **螢幕閱讀器**: [朗讀為...]
### 注意事項
| ✅ 要做 | ❌ 不要做 |
|------|---------|
| [最佳實踐] | [反模式] |
### 程式碼範例
[適合框架的程式碼片段]
輸出 — 擴展
## 新組件:[名稱]
### 問題
[這個組件解決什麼使用者需求或填補什麼差距]
### 現有模式
| 相關組件 | 相似度 | 為何不足 |
|---------|--------|----------|
| [組件] | [共同點] | [缺少什麼] |
### 建議設計
#### API / Props
| 屬性 | 型別 | 預設值 | 描述 |
|------|------|--------|------|
| [prop] | [type] | [default] | [description] |
#### 變體
| 變體 | 使用時機 | 視覺表現 |
|------|----------|----------|
| [變體] | [情境] | [描述] |
#### 狀態
| 狀態 | 行為 | 備註 |
|------|------|------|
| 預設 | [描述] | — |
| 懸停 | [描述] | [互動] |
| 禁用 | [描述] | 不可互動 |
| 載入 | [描述] | [動畫] |
#### 使用的令牌
- 色彩:[哪些令牌]
- 間距:[哪些令牌]
- 字體排印:[哪些令牌]
### 無障礙
- **角色 (Role)**: [ARIA role]
- **鍵盤**: [預期互動]
- **螢幕閱讀器**: [朗讀為...]
### 待解決問題
- [需要設計審查的決策]
- [需要處理的邊界情況]
若已連接工具
如果已連接 ~~設計工具:
- 直接在 Figma 中審計組件 — 檢查命名、變體與令牌使用
- 提取組件屬性與圖層結構以用於文件製作
如果已連接 ~~知識庫:
- 搜尋現有的組件文件與使用指南
- 將更新後的文件發布到你的 Wiki
提示
- 從審計開始 — 先了解現狀,再決定方向。
- 邊做邊記錄 — 在設計組件時記錄它會更容易。
- 覆蓋率優先於完美 — 記錄了 80% 的組件,勝過 100% 地記錄 10 個組件。