Communitygithub.com

设计系统管理(/design-system)

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

design-system) 是什么?

该技能为 AI 代理(如 Claude Code、Cursor 等)提供了一套完整的设计系统管理工具。它允许开发者和设计师通过简单的命令对设计系统进行审计、记录组件以及设计新模式。技能的核心价值在于确保设计的一致性、灵活性和文档完备性。它通过结构化的输出模板(Markdown 格式)生成审计报告(涵盖命名一致性、令牌覆盖率、组件完整性)、组件文档(包含描述、变体、属性、状态、无障碍访问及最佳实践)以及新模式设计方案(从问题定义、现有模式分析到最终 API 设计)。该技能支持与 Figma 等设计工具和知识库集成,以实现更高效的自动化审计和文档发布。

兼容平台~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 的新对话。

文档

/design-system

如果您看到不熟悉的占位符或需要检查已连接了哪些工具,请参阅 CONNECTORS.md。

管理您的设计系统——审计一致性、记录组件或设计新模式。

用法

/design-system audit                    # 完整系统审计
/design-system document [组件名]        # 记录一个组件
/design-system extend [模式名]          # 设计新组件或新模式

设计系统的组成部分

设计令牌

定义视觉语言的基础值:

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

组件

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

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

模式

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

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

原则

  1. 一致性胜于创造性——系统的存在是为了让团队不必重复造轮子
  2. 约束下的灵活性——组件应可组合,而非僵化
  3. 记录一切——没有被记录的东西就不存在
  4. 版本化与迁移——破坏性变更需要有迁移路径

输出——审计

## 设计系统审计

### 总结
**检查的组件数:** [X] | **发现的问题数:** [X] | **评分:** [X/100]

### 命名一致性
| 问题 | 影响组件 | 建议 |
|------|----------|------|
| [命名不一致的描述] | [列表] | [采用的标准] |

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

### 组件完整性
| 组件 | 状态 | 变体 | 文档 | 得分 |
|------|------|------|------|------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |

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

输出——文档

## 组件:[名称]

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

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

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

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

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

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

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

输出——扩展

## 新组件:[名称]

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

### 现有模式
| 相关组件 | 相似点 | 为何不够 |
|----------|--------|----------|
| [组件] | [共有的内容] | [缺失的内容] |

### 提议的设计

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

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

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

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

### 无障碍
- **角色**:[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

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.

相关技能