Communitygithub.com

/design-system - 设计系统管理

审计、记录或扩展你的设计系统。用于检查组件的命名不一致或硬编码值,编写组件变体、状态和无障碍说明文档,或设计符合现有系统的新模式。

design-system - 设计系统管理 是什么?

此技能旨在帮助开发者和设计人员系统化管理设计系统。它支持三种核心操作:审计(Audit)用于全面检查设计令牌(颜色、间距、版式等)的使用一致性,识别硬编码值和不一致的命名;文档(Document)用于为现有组件生成规范文档,涵盖变体、状态、属性、无障碍和代码示例;扩展(Extend)用于设计新组件或模式,确保其与现有设计令牌和模式保持一致。该技能适用于任何使用设计系统的团队,尤其适合与 Figma 连接后直接审计图层和令牌使用情况,或与知识库连接后搜索和发布文档。输出格式为结构化的 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]         # 设计新组件或新模式

设计系统的组成部分

设计令牌

定义视觉语言的原子值:

  • 颜色(品牌色、语义色、中性色)
  • 版式(字体等级、字重、行高)
  • 间距(等级、组件内边距)
  • 边框(圆角、宽度)
  • 阴影(阴影层级)
  • 动效(持续时间、缓动函数)

组件

可复用的 UI 元素,具有定义的:

  • 变体(主要、次要、幽灵)
  • 状态(默认、悬停、激活、禁用、加载中、错误)
  • 尺寸(小、中、大)
  • 行为(交互、动画)
  • 无障碍(ARIA、键盘)

模式

结合组件的常见 UI 解决方案:

  • 表单(输入组、验证、提交)
  • 导航(侧边栏、标签页、面包屑)
  • 数据展示(表格、卡片、列表)
  • 反馈(通知提示、模态框、内联消息)

原则

  1. 一致性优于创造性 — 系统存在的目的就是让团队不再重复造轮子
  2. 约束内灵活 — 组件应可组合,而非僵化
  3. 记录一切 — 如果没有文档,它就不存在
  4. 版本化与迁移 — 破坏性变更需要有迁移路径

输出 — 审计

## 设计系统审计

### 摘要
**已审查组件数:**[X] | **发现的问题数:**[X] | **评分:**[X/100]

### 命名一致性
| 问题 | 相关组件 | 建议 |
|------|----------|------|
| [命名不一致] | [列表] | [采用标准] |

### 令牌覆盖率
| 类别 | 已定义 | 发现的硬编码值 |
|------|--------|----------------|
| 颜色 | [X] | [X] 处硬编码十六进制 |
| 间距 | [X] | [X] 处任意值 |
| 版式 | [X] | [X] 处自定义字体/字号 |

### 组件完整度
| 组件 | 状态 | 变体 | 文档 | 评分 |
|------|------|------|------|------|
| 按钮 | ✅ | ✅ | ⚠️ | 8/10 |
| 输入框 | ✅ | ⚠️ | ❌ | 5/10 |

### 优先行动项
1. [最有影响力的改进]
2. [第二优先级]
3. [第三优先级]

输出 — 文档

## 组件:[名称]

### 描述
[该组件是什么以及何时使用]

### 变体
| 变体 | 使用场景 |
|------|----------|
| [主要] | [主要操作] |
| [次要] | [辅助操作] |

### 属性
| 属性 | 类型 | 默认值 | 描述 |
|------|------|--------|------|
| [prop] | [type] | [default] | [描述] |

### 状态
| 状态 | 视觉效果 | 行为 |
|------|----------|------|
| 默认 | [描述] | — |
| 悬停 | [描述] | [交互] |
| 激活 | [描述] | [交互] |
| 禁用 | [描述] | 不可交互 |
| 加载中 | [描述] | [动画] |

### 无障碍
- **角色**:[ARIA 角色]
- **键盘**:[Tab、Enter、Escape 行为]
- **屏幕阅读器**:[朗读为……]

### 注意事项
| ✅ 应该做 | ❌ 不应做 |
|----------|----------|
| [最佳实践] | [反模式] |

### 代码示例
[框架相关的代码片段]

输出 — 扩展

## 新组件:[名称]

### 问题
[该组件解决的用户需求或功能空白]

### 现有模式
| 相关组件 | 相似之处 | 为什么不够 |
|----------|----------|------------|
| [组件] | [共同的点] | [缺少的点] |

### 设计提案

#### API / 属性
| 属性 | 类型 | 默认值 | 描述 |
|------|------|--------|------|
| [prop] | [type] | [default] | [描述] |

#### 变体
| 变体 | 使用场景 | 视觉效果 |
|------|----------|----------|
| [变体] | [场景] | [描述] |

#### 状态
| 状态 | 行为 | 备注 |
|------|------|------|
| 默认 | [描述] | — |
| 悬停 | [描述] | [交互] |
| 禁用 | [描述] | 不可交互 |
| 加载中 | [描述] | [动画] |

#### 使用的令牌
- 颜色:[哪些令牌]
- 间距:[哪些令牌]
- 版式:[哪些令牌]

### 无障碍
- **角色**:[ARIA 角色]
- **键盘**:[期望的交互]
- **屏幕阅读器**:[朗读为……]

### 待定问题
- [需要设计评审的决策]
- [需要解决的边界情况]

若连接了工具

如果连接了 ~~设计工具:

  • 直接在 Figma 中审计组件 — 检查命名、变体和令牌使用情况
  • 提取组件属性和图层结构用于文档

如果连接了 ~~知识库:

  • 搜索现有的组件文档和使用指南
  • 将更新后的文档发布到你的维基

提示

  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

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.

相关技能