Communitygithub.com

設計系統管理工具

審計、記錄或擴展你的設計系統。用於檢查跨組件的命名不一致或硬編碼值、編寫組件變體、狀態與無障礙說明的文件,或設計符合現有系統的新模式。

設計系統管理工具 是什麼?

這是一個強大的設計系統管理工具,旨在幫助開發者和設計師進行設計系統的全面審計、組件文件撰寫以及新模式擴展。它支援三大核心工作流程:透過 `/design-system audit` 對整個系統進行一致性與硬編碼值檢查,產生詳細的審計報告;使用 `/design-system document [component]` 為特定組件生成包含變體、屬性、狀態、無障礙說明以及最佳實踐的文件;以及透過 `/design-system extend [pattern]` 設計符合現有系統的新組件或模式,涵蓋問題陳述、設計方案、API 屬性、使用令牌及開放問題。該工具適用於 Claude Code 等 AI 代理平台,能有效提升設計系統的維護效率與品質。其輸出採用結構化的 Markdown 格式,易於整合到文件或知識庫中。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/design-system-management

在你喜歡的 AI 中提問

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

說明文件

/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 解決方案:

  • 表單(輸入群組、驗證、提交)
  • 導航(側邊欄、頁籤、麵包屑)
  • 資料顯示(表格、卡片、列表)
  • 回饋(吐司訊息、模態框、內聯訊息)

原則

  1. 一致性優先於創造力 — 系統的存在是為了讓團隊不必重複造輪子
  2. 在約束下保持靈活 — 組件應可組合,而非僵化
  3. 記錄一切 — 沒有記錄就不存在
  4. 版本化與遷移 — 重大變更需要遷移路徑

輸出 — 審計

## 設計系統審計報告

### 摘要
**審閱的組件數量:** [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

提示

  1. 從審計開始 — 先了解現狀,再決定方向。
  2. 邊做邊記錄 — 在設計組件時記錄它會更容易。
  3. 覆蓋率優先於完美 — 記錄了 80% 的組件,勝過 100% 地記錄 10 個組件。

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

相關技能