Communitygithub.com

設計系統管理員

稽核、記錄或擴展您的設計系統。用於檢查元件間命名不一致或硬編碼值、撰寫元件的變體、狀態和無障礙說明文件,或設計符合現有系統的新模式。

設計系統管理員 是什麼?

這個技能可以幫助開發者與設計師有效管理設計系統。它提供三個主要操作:稽核(audit)掃描整個系統,找出命名不一致與硬編碼值等問題;記錄(document)為特定元件生成結構化的文件,包含變體、狀態、無障礙(ARIA)說明;擴展(extend)則協助設計符合現有系統的新元件或模式,確保一致性與可組合性。支援設計工具與知識庫連接(例如 Figma 或 wiki)以自動化稽核與文件發布。輸出採用 Markdown 表格與清單,適合在 Claude Code、Cursor 等 AI 代理平台使用。

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

在你喜歡的 AI 中提問

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

說明文件

/設計系統

如果看到不熟悉的佔位符,或需要檢查已連接的工具,請參閱 CONNECTORS.md。

管理您的設計系統 — 稽核一致性、記錄元件,或設計新模式。

使用方式

/design-system audit                    # 完整系統稽核
/design-system document [元件]         # 記錄某個元件
/design-system extend [模式]           # 設計新元件或模式

設計系統的組成

設計 Token

定義視覺語言的原子值:

  • 色彩(品牌色、語意色、中性色)
  • 排版(字級、字重、行高)
  • 間距(縮放比例、元件內邊距)
  • 邊框(圓角、寬度)
  • 陰影(層級)
  • 動態(持續時間、緩動函數)

元件

可重複使用的 UI 元素,包含:

  • 變體(主要、次要、幽靈)
  • 狀態(預設、懸停、啟用、停用、載入、錯誤)
  • 尺寸(小、中、大)
  • 行為(互動、動畫)
  • 無障礙(ARIA、鍵盤)

模式

結合元件的常見 UI 解決方案:

  • 表單(輸入群組、驗證、提交)
  • 導覽(側邊欄、分頁標籤、麵包屑)
  • 資料顯示(表格、卡片、清單)
  • 回饋(提示訊息、模態框、內嵌訊息)

原則

  1. 一致性優先於創意 — 系統存在的目的是讓團隊不必重新發明輪子
  2. 在限制內保有彈性 — 元件應可組合,而非僵化
  3. 記錄一切 — 沒有文件就不存在
  4. 版本化與遷移 — 破壞性變更需要提供遷移路徑

輸出 — 稽核

## 設計系統稽核

### 摘要
**已審查元件數:** [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

提示

  1. 從稽核開始 — 先了解現狀,再決定方向。
  2. 邊建邊記錄 — 在設計元件的同時記錄,會比事後補寫更容易。
  3. 優先追求覆蓋率,而非完美 — 涵蓋 80% 元件的文件,勝過 10 個元件 100% 完整。

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

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

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

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.

相關技能