| name | cis-design-system |
| description | CIS (Corporate Identity System) 設計規範建立與維護。前端專案的色彩、字型、間距、元件用途統一定義。新專案建立時或前端修改時自動觸發,確保設計一致性。 |
| source | 自建 |
| updated | "2026-04-04T00:00:00.000Z" |
CIS Design System
When to Use
自動觸發(hook 強制):
- 編輯
.css / .tsx / .vue / .scss / tailwind 相關檔案時
- 新增/修改 UI 元件時
- 修改色彩、字型、間距時
手動觸發:
/cis-design-system — 建立或更新 CIS 文件
- 新專案初始化時
CIS 文件位置
每個前端專案必須有:wireframes/cis-design-tokens.html
核心流程
新專案建立
1. 讀取 globals.css / tailwind config 萃取所有 CSS 變數
2. 讀取 package.json 確認 UI 框架(shadcn/PrimeVue)
3. 讀取字型設定(layout.tsx / fonts)
4. 生成 cis-design-tokens.html,包含以下區塊:
前端修改時(hook 觸發)
1. 偵測修改了哪些前端檔案
2. 檢查修改內容是否涉及色彩/字型/間距/元件
3. 若涉及 → 比對 CIS 文件是否需更新
4. 若不一致 → block 並提示更新 CIS
CIS 文件必須包含的區塊(附編號)
每個區塊有固定編號,方便討論時引用(如「調整 C1.3 的深色值」)。
C1 — 色彩系統
| 編號 | 內容 |
|---|
| C1.1 | 品牌色(primary / accent,雙主題) |
| C1.2 | 背景色(background / card / muted / input) |
| C1.3 | 文字色(foreground / muted-foreground / dim) |
| C1.4 | 邊框色(border / ring) |
| C1.5 | 語意色(destructive / success / warning) |
| C1.6 | 領域專用色(如運勢等級、特殊日、七曜) |
每個色必須列:Token 名 / Light 值 / Dark 值 / 用途說明
C2 — 字型系統
| 編號 | 內容 |
|---|
| C2.1 | 字型家族定義(serif / sans / mono) |
| C2.2 | 字級表(名稱 / 大小 / 字重 / 用途) |
| C2.3 | 行高規則 |
C3 — 間距系統
| 編號 | 內容 |
|---|
| C3.1 | 基數定義(如 4px) |
| C3.2 | 間距階梯(gap-sm / gap-md / gap-lg) |
| C3.3 | 元件內距(card padding / page padding) |
C4 — 圓角系統
| 編號 | 內容 |
|---|
| C4.1 | 圓角階梯(radius-sm / radius / radius-lg / radius-xl) |
| C4.2 | 特殊圓角(pill / circle) |
C5 — 元件色彩對照
| 編號 | 內容 |
|---|
| C5.1 | 每個 UI 元件該用哪個 token |
| C5.2 | Badge 色彩規則(bg 透明度 + text 實色) |
| C5.3 | 卡片色彩規則 |
| C5.4 | 互動狀態(hover / active / focus) |
C6 — 禁止事項
| 編號 | 內容 |
|---|
| C6.1 | 禁用 hardcode hex/rgb |
| C6.2 | 禁用非原典術語(專案特定) |
| C6.3 | 禁用 emoji |
| C6.4 | 其他專案特定禁止項 |
C7 — 專案特定定義
| 編號 | 內容 |
|---|
| C7.x | 由專案自行定義的領域色彩、術語色彩等 |
比對規則
修改前端檔案時,hook 檢查以下項目:
- 新增顏色 — 是否在 CIS C1 中有定義?
- 修改 CSS 變數 — CIS 文件是否同步更新?
- 新增元件 — C5 元件對照是否更新?
- 修改字型 — C2 是否同步?
- 修改間距 — C3 是否同步?
生成指令
/cis-design-system
討論用法範例
用戶: 「C1.6 的甘露日金色太亮了,深色模式要暗一點」
Claude: 調整 C1.6 kanro dark 從 #d4af37 → #b8941f,同步更新 globals.css + CIS 文件
用戶: 「C5.2 的 badge 透明度統一改 15%」
Claude: 更新所有 badge bg 從 12% → 15%,影響 C1.5/C1.6 所有 -bg token