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