Skip to content
cccskills
FreePublished on GitHub

ui-ux-pro-max

专业级 UI/UX 设计规范,需要高质量界面设计时手动触发或描述"设计感/专业UI"时自动触发。覆盖视觉层次、配色体系、排版节奏、交互微动效、响应式适配等。日常前端开发由 frontend-dev skill 覆盖。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md9.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

UI/UX Pro Max — 专业级界面设计规范

目标:生成有设计感、可直接交付的前端界面,告别 AI 模板风。


设计哲学

克制 > 堆砌          — 少即是多,每个元素都有存在理由
层次 > 装饰          — 用空间和对比建立信息层次,而非边框和分割线
一致 > 创意          — 系统化的设计语言优于零散的创意点缀
功能 > 形式          — 美观服务于可用性,永远不反过来

反 AI 风格清单

严格禁止

类别禁止项
配色蓝紫霓虹渐变、大面积线性渐变背景、荧光色强调
效果玻璃拟态(glassmorphism)、发光描边、霓虹阴影、粒子背景
布局居中大卡片+圆角过度、无限堆叠的 card-in-card
装饰无意义几何图形、装饰性网格线、浮动气泡
图标纯装饰性 emoji、图标代替文字说明
文案"Powered by AI"、营销式夸张用语

识别 AI 模板风的信号

  • 所有卡片等宽等高、间距完全一致 → 缺乏视觉节奏
  • 主色只有一个蓝/紫 → 缺乏色彩层次
  • 阴影千篇一律 shadow-lg → 没有深度层次
  • 按钮全是渐变填充 → 缺乏操作层级

配色体系

构建方法

1. 确定品牌主色(1 个)
2. 派生 5 级明暗梯度(50/100/300/500/700)
3. 选择 1 个功能强调色(CTA / 重要操作)
4. 语义色:success/warning/error/info 各 1 个
5. 中性色:gray 7 级梯度(50~900)

CSS 变量模板

:root {
  /* 主色梯度 */
  --color-primary-50: #f0f7ff;
  --color-primary-100: #e0efff;
  --color-primary-300: #7cb8ff;
  --color-primary-500: #2b7de9;
  --color-primary-700: #1a56a8;

  /* 中性色 */
  --color-gray-50: #fafafa;
  --color-gray-100: #f5f5f5;
  --color-gray-200: #e8e8e8;
  --color-gray-300: #d4d4d4;
  --color-gray-500: #737373;
  --color-gray-700: #404040;
  --color-gray-900: #171717;

  /* 语义色 */
  --color-success: #22c55e;
  --color-warning: #f59e0b;
  --color-error: #ef4444;
  --color-info: #3b82f6;

  /* 文字 */
  --text-primary: var(--color-gray-900);
  --text-secondary: var(--color-gray-500);
  --text-disabled: var(--color-gray-300);

  /* 背景 */
  --bg-page: var(--color-gray-50);
  --bg-card: #ffffff;
  --bg-hover: var(--color-gray-100);

  /* 边框 */
  --border-default: var(--color-gray-200);
  --border-strong: var(--color-gray-300);
}

暗色模式

[data-theme="dark"] {
  --text-primary: #f5f5f5;
  --text-secondary: #a3a3a3;
  --bg-page: #0a0a0a;
  --bg-card: #171717;
  --bg-hover: #262626;
  --border-default: #2e2e2e;
  --border-strong: #404040;
}

排版系统

字号梯度(rem)

TokenSize用途
--text-xs0.75rem辅助说明、标签
--text-sm0.875rem次要文字、表格内容
--text-base1rem正文
--text-lg1.125rem小标题、强调
--text-xl1.25rem区块标题
--text-2xl1.5rem页面标题
--text-3xl1.875rem大标题 / Hero

行高

场景line-height
标题1.2 ~ 1.3
正文1.5 ~ 1.6
紧凑(标签/按钮)1 ~ 1.2

字重

Regular (400) — 正文
Medium (500)  — 次标题、强调
Semibold (600) — 标题
Bold (700)    — 仅用于极少数 Hero 场景

间距系统

8px 基准网格

:root {
  --space-1: 0.25rem;   /* 4px */
  --space-2: 0.5rem;    /* 8px */
  --space-3: 0.75rem;   /* 12px */
  --space-4: 1rem;      /* 16px */
  --space-5: 1.25rem;   /* 20px */
  --space-6: 1.5rem;    /* 24px */
  --space-8: 2rem;      /* 32px */
  --space-10: 2.5rem;   /* 40px */
  --space-12: 3rem;     /* 48px */
  --space-16: 4rem;     /* 64px */
}

间距使用原则

关系间距
同组元素(label + input)space-1 ~ space-2
相关元素(表单字段之间)space-3 ~ space-4
区块内填充space-4 ~ space-6
区块之间space-8 ~ space-12
页面级留白space-12 ~ space-16

视觉层次

建立层次的 5 种手段(按优先级)

1. 大小对比    — 标题 vs 正文字号差 ≥ 1.5 倍
2. 色彩权重    — 深色 = 重要,浅色 = 辅助
3. 空白分隔    — 用留白代替分割线
4. 位置关系    — 重要信息靠上靠左(LTR 布局)
5. 视觉修饰    — 最后手段:边框、背景色、图标

信息密度控制

场景策略
后台表格/列表紧凑模式,行高 40~48px,减少留白
详情页/表单舒适模式,合理分组+留白
营销/落地页宽松模式,大量留白突出核心信息
仪表盘混合模式,卡片紧凑 + 卡片间宽松

阴影系统

:root {
  --shadow-xs: 0 1px 2px rgba(0, 0, 0, 0.04);
  --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.06), 0 1px 2px rgba(0, 0, 0, 0.04);
  --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.05), 0 2px 4px rgba(0, 0, 0, 0.04);
  --shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.06), 0 4px 6px rgba(0, 0, 0, 0.04);
  --shadow-xl: 0 20px 25px rgba(0, 0, 0, 0.08), 0 8px 10px rgba(0, 0, 0, 0.04);
}
元素阴影说明
普通卡片shadow-xs 或 border平面感,不浮起
悬浮卡片hover: shadow-md交互反馈
下拉菜单/弹窗shadow-lg明确浮层关系
模态框shadow-xl最高层级

圆角系统

:root {
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;
  --radius-xl: 16px;
  --radius-full: 9999px;
}

同一页面圆角不超过 3 种尺寸。


交互微动效

原则

1. 有目的 — 每个动效都传达状态变化
2. 快速   — 200~300ms,不拖沓
3. 自然   — ease-out 为主,模拟物理惯性

常用 Timing

:root {
  --duration-fast: 150ms;
  --duration-normal: 250ms;
  --duration-slow: 350ms;

  --ease-default: cubic-bezier(0.4, 0, 0.2, 1);
  --ease-in: cubic-bezier(0.4, 0, 1, 1);
  --ease-out: cubic-bezier(0, 0, 0.2, 1);
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
}

禁止的动效

  • 超过 500ms 的动画
  • 旋转、弹跳、脉冲等花哨效果
  • 页面加载时的入场动画(除首屏 Hero)
  • 无限循环动画(除 loading 指示器)

响应式设计

断点

--bp-sm: 640px;
--bp-md: 768px;
--bp-lg: 1024px;
--bp-xl: 1280px;
--bp-2xl: 1536px;

适配策略

元素方案
布局Grid/Flex 自适应,避免固定宽度
字号clamp() 流式缩放
间距移动端减半或使用较小 token
导航lg 以下折叠为汉堡菜单
表格md 以下转为卡片列表
图片srcset + sizes,或 picture 元素

组件设计模式

按钮层级

Primary(主操作)   — 实心填充主色,每页最多 1~2 个
Secondary(次操作) — 描边/浅色背景
Tertiary(辅助)    — 纯文字按钮,无背景无边框
Danger(危险操作)  — 红色系,需二次确认

表单设计

规则说明
Label 始终可见不依赖 placeholder 传达字段含义
错误提示就近在输入框下方,红色小字
必填标记* 在 label 后,颜色 --color-error
分组相关字段用标题/间距分组,不用边框围起来
操作区主按钮靠右(或靠左,全站统一)

空状态 / 加载状态

空状态:简洁图标 + 一句话说明 + 行动按钮
加载态:骨架屏(首选)、Spinner(局部)、进度条(可量化)

无障碍基础

规则要求
颜色对比度正文 ≥ 4.5:1,大字 ≥ 3:1(WCAG AA)
焦点可见focus-visible 样式清晰可辨
键盘导航Tab 顺序合理,可键盘操作所有交互
语义化 HTML正确使用 heading 层级、landmark 元素
Alt 文本功能性图片必须有 alt

代码输出要求

生成页面/组件时必须:

  1. 使用 CSS 变量 — 不硬编码颜色/间距/字号
  2. 响应式 — 至少覆盖移动端 + 桌面端
  3. 交互状态完整 — hover / focus / active / disabled
  4. 语义化标签 — 不滥用 div
  5. 暗色模式 — 提供 [data-theme="dark"] 变量覆盖

设计评审检查清单

在生成 UI 代码后,自查以下项目:

  • 视觉层次清晰:标题、正文、辅助文字 3 级以上
  • 间距节奏感:不是所有间距都一样
  • 配色克制:主色点缀,不是大面积铺色
  • 没有 AI 模板风信号(见反 AI 风格清单)
  • 交互状态完整:hover、focus、disabled、loading、empty、error
  • 响应式基本可用
  • 对比度达标
  • 无多余装饰性元素

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

Bash 脚本与系统命令规范。禁止行尾注释,强制使用 tee/heredoc 写入,提升命令执行的可维护性。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

See all skills by doccker

Report a problem with this skill