design-system

设计系统 — 生成与审计视觉系统

何时使用

• 启动需要设计系统的新项目
• 审计现有代码库的视觉一致性
• 重新设计之前 — 了解你现有的东西
• 当 UI 看起来"不对"但无法精确定位原因
• 审查涉及样式的 PR

工作原理

模式 1：生成设计系统

分析你的代码库并生成一个一致的设计系统：

1. 扫描 CSS/Tailwind/styled-components 中的现有模式
2. 提取：颜色、排版、间距、圆角、阴影、断点
3. 研究 3 个竞争对手网站获取灵感（通过浏览器 MCP）
4. 提出设计 token 集（JSON + CSS 自定义属性）
5. 生成 DESIGN.md，包含每个决策的理由
6. 创建交互式 HTML 预览页面（自包含，无依赖）

输出：DESIGN.md + design-tokens.json + design-preview.html

模式 2：视觉审计

在 10 个维度上为你的 UI 打分（每个 0-10）：

1. 颜色一致性 — 你在使用你的调色板还是随机的十六进制值？
2. 排版层次 — 清晰的 h1 > h2 > h3 > body > caption？
3. 间距节奏 — 一致的刻度（4px/8px/16px）还是随意的？
4. 组件一致性 — 相似的元素看起来相似吗？
5. 响应式行为 — 在断点处流畅还是断裂？
6. 深色模式 — 完整还是半成品？
7. 动画 — 有目的还是装饰性的？
8. 无障碍 — 对比度、焦点状态、触摸目标
9. 信息密度 — 拥挤还是整洁？
10. 精细度 — 悬停状态、过渡、加载状态、空状态

每个维度获得一个分数、具体示例和带确切 file:line 的修复建议。

模式 3：AI 模板检测

识别通用的 AI 生成设计模式：

- 所有东西上不必要的渐变
- 紫到蓝的默认值
- 没有目的的"毛玻璃"卡片
- 不应该圆角的东西上的圆角
- 滚动时过多的动画
- 带有居中文本叠在库存渐变上的通用主视觉区
- 没有个性的无衬线字体栈

示例

为一个 SaaS 应用生成：

/design-system generate --style minimal --palette earth-tones

审计现有 UI：

/design-system audit --url http://localhost:3000 --pages / /pricing /docs

检查 AI 模板痕迹：

/design-system slop-check