Ui Ux Design Expert
Provides practical guidance for visual and interaction design, usability, design systems, WCAG 2.2 accessibility audits, ARIA patterns, and interface templates.
UI/UX 设计专家知识库
从「网站为什么好看」的根本原因出发的界面设计知识:法则(约束性)→ 最佳实践(建设性)→ 坑点(防御性) 三层结构。因果链排序:先人类感知/认知的底层硬约束(好看与可用的生理学根因),再设计系统层的构建纪律,最后流程与生成纪律。生成界面/代码前逐条自检全局法则(kb/laws.md Top 法则);写代码前查 kb/ai-mistakes.md 与「Top 坑点」。
知识库索引
| 文件 | 内容 | 何时读 |
|---|---|---|
| kb/laws.md | 全局宪法:跨子领域不可违背原则(LAW-1~28,分三组:感知与认知根因 / 设计系统纪律 / 流程与生成纪律) | 生成任何界面前必读,逐条自检 |
| kb/visual-perception.md | 法则(VP)、视觉感知根因:格式塔分组、CRAP 四原则与对齐轴线、视觉搜寻与扫读模式、Von Restorff 焦点、感知阈值、颜色感知 | 「为什么好看/不好看」归因、层级/分组/焦点设计问题 |
| kb/layout-composition.md | 法则(LC)、布局构图:间距刻度与垂直节奏、网格与视觉流编排、行长与行高、响应式断点、现代版式、响应式图片交付、图表选型与可视化信息设计、溢出防护与 CLS 防御 | 布局/间距/网格/视觉流、响应式、图片/图表选型、溢出/跳动问题 |
| kb/color-system.md | 法则(CS)、色彩系统:色彩空间与色阶生成(OKLCH)、60-30-10 配比、语义 token、深色模式重映射、对比度计算、数据可视化配色(categorical/sequential)、跨文化行业惯例 | 配色/色阶/主题/深色模式、图表配色、出海、对比度选色 |
| kb/typography.md | 法则(TY)、排版与字体:字体加载策略、字体栈与回退、中西文混排、行高/字距、流体排版(clamp 边界)、可变字体、数值排版(tabular-nums)、打印样式(@media print) | 字体选型/加载、中西文规则、流体排版/可变字体、排版细节、打印适配 |
| kb/style-design-system.md | 法则(SD)、风格与设计系统:token 三层架构、组件状态集、组件变体轴治理、玻璃拟态等风格实现降级、图标系统纪律、品牌一致性 | 设计系统搭建、组件状态/变体治理、风格落地 |
| kb/interaction-motion.md | 法则(IM)、交互与动效:微交互反馈时长(100ms/1s/10s 阈值)、转场与缓动方向、动效编排(stagger 纪律)、滚动体验(收口/位置恢复)、tooltip/popover 纪律、键盘快捷键体系、表单交互、动效性能纪律 | 动效编排、滚动体验、tooltip、快捷键、加载/表单/转场、动效性能 |
| kb/usability-accessibility.md | 法则(UA)、可用性与无障碍:WCAG 2.2 A/AA 全表(速查,spec 逐字锚定)、WAI-ARIA APG 30 模式速查表、键盘与焦点管理、读屏语义与 ARIA 纪律、i18n/RTL、错误处理与可行动错误信息 | 无障碍合规、键盘/读屏适配、WCAG 条款查询、自定义控件 APG 契约、RTL/多语言 |
| kb/wcag22-audit.md | 法则(WC)、WCAG 2.2 逐条审计检查表:A/AA 55 条逐条审计检查点+技法编号+失败模式(F)对照、80 项高频失败模式速查、AAA 31 条备查、4.1.1 废止处理、技法编号体系图例 | 无障碍审计/AA 验收逐条过检、失败模式定位、审计结论三字段输出、AAA 增强项 |
| kb/aria-patterns.md | 法则(AP)、WAI-ARIA APG 30 模式完整契约:逐模式键盘交互/ARIA 角色·状态·属性/易错点(accordion~window splitter),焦点管理双方案(roving tabindex vs aria-activedescendant),进行中模式警示(tooltip/window splitter) | 实现自定义控件前必读、修复 4.1.2/4.1.3 违反、复合控件键盘与 ARIA 契约 |
| kb/industry-themes.md | 法则(IND)、行业主题与配色图谱:128 行业主题基调+亮/暗配色起点方案(F01~F128:金融商业/内容媒体/生活消费/健康医疗/工具效率/垂直专业/娱乐兴趣/商业生产力/出行公共/生活垂直/学习知识/新兴专项/金融商业延伸/创作者内容/消费电商/公共社会十六大组)、字体气质、典型误区、跨文化出海注记 | 行业配色/主题气质/品类惯例色、出海配色核查、无品牌输入时的行业默认方案 |
| kb/app-templates.md | 法则(TPL)、应用类型模板库:128 个应用/页面类型模板(T01~T128:移动应用/Web 站点/后台桌面/专项模式主组+移动/Web/数据后台/流程事务/营销电商/特殊人群场景十扩展组),信息架构+布局骨架+关键页面+核心组件+三态+平台适配 | 「做一个 XX App/页面」类问题、信息架构/模板选型、页面结构起步 |
| kb/ai-mistakes.md | AI 生成界面代码的 38 条典型错误总集(AIM-N,按致命/严重/一般分级,含 6 大元根因) | 写代码前必读,生成后自查 |
| kb/gotchas.md | 跨子领域高频坑点 Top 65(G-N,一句话版:症状→根因→规避→法则引用) | 快速定位/排障入口,只有症状时先查这里 |
| kb/patterns.md | 跨子领域标准流程(P-N):界面美化走查、设计令牌建设、落地页构建、深色模式改造、无障碍走查、设计评审、表单设计、移动端、数据密集、详情页、导航系统、搜索体验、首次引导、错误与失效页面 | 端到端任务按流程操作 |
知识分层地图(L0~L4)
| 层 | 载体 | 职责 | 读取时机 |
|---|---|---|---|
| L0 入口 | SKILL.md | 索引/决策树/Top 法则/Top 坑点/回答规范 | 每次会话按需 |
| L1 宪法 | kb/laws.md | LAW-1~28 全局不可违背原则(感知认知/设计系统/流程生成三组) | 生成任何界面前逐条自检 |
| L2 领域 | kb/{visual-perception, layout-composition, color-system, typography, style-design-system, interaction-motion, usability-accessibility, industry-themes, app-templates, wcag22-audit, aria-patterns}.md | 各域法则(VP/LC/CS/TY/SD/IM/UA/IND/TPL/WC/AP-N)+ 场景实践 + 坑点 + 参数速查/图谱/模板库/审计检查表/模式契约 | 决策树定位到域后深读 |
| L3 跨域 | kb/patterns.md(P)、kb/gotchas.md(G)、kb/ai-mistakes.md(AIM) | 端到端流程 / 一句话坑点速查 / AI 错误总集 | 端到端任务、只有症状时、写代码前 |
| L4 语料 | corpus/ui-ux-design/**([官方文档] 白名单实抓 + [模型经验] 萃取) | 溯源层:R34 全量语料(lawsofux 30 法则、NN/g 2 篇、HIG 11 主题、WCAG 2.2 spec+quickref、APG 30 模式) | 条目溯源、回流验证时 |
读取顺序:L0 决策树定位 → L1 自检 → L2/L3 深读 →(需要时)L4 溯源。引用记法 LAW-N/VP-N/CS-N/G-N/AIM-N/P-N/IND-N/TPL-N/WC-N/AP-N 跨层可直接引用;每条带来源标注([官方文档]/[模型经验]),仅 [模型经验] 视为未经文档验证。
决策树(按问题类型找知识文件)
- 生成界面前通用约束 →
kb/laws.md(全局宪法,先自检) - 「为什么这界面好看/难看」归因 / 分组、层级、焦点、强调设计 →
kb/visual-perception.md - 页面布局 / 间距系统 / 网格 / 响应式断点 / 溢出与布局跳动 →
kb/layout-composition.md - 配色 / 色阶生成 / 主题与深色模式 / 对比度选色 / 强调色配比 →
kb/color-system.md - 字体选型与加载 / 字体栈 / 中西文混排 / 行高字距 / 数字排版 / 打印样式 →
kb/typography.md - 设计系统 / token 架构 / 组件状态集 / 风格(玻璃拟态等)实现 / 图标系统 →
kb/style-design-system.md - 动效时长与缓动 / 转场 / 加载体验 / 表单交互反馈 / 动效性能 →
kb/interaction-motion.md - 无障碍合规 / 键盘焦点 / 读屏语义 / WCAG 2.2 条款 / 错误信息设计 →
kb/usability-accessibility.md - 无障碍审计 / AA 验收 / WCAG 逐条过检 / 失败模式(F 编号)定位 / AAA 增强项 →
kb/wcag22-audit.md - 实现自定义控件 / APG 模式契约 / 复合控件键盘与 ARIA / 修复 4.1.2 违反 →
kb/aria-patterns.md - 行业配色 / 主题气质 / 品类惯例色 / 出海跨文化配色 →
kb/industry-themes.md - 「做一个 XX App/页面」/ 信息架构 / 应用类型模板选型 / 页面结构起步 →
kb/app-templates.md - 端到端任务:界面美化 / 建设计令牌 / 做落地页 / 深色模式改造 / 无障碍走查 / 设计评审 / 表单 / 移动端 / 数据密集 / 详情页 / 导航系统 / 搜索体验 / 首次引导 / 错误页面 →
kb/patterns.md - 不确定某坑是不是自己会犯的 →
kb/ai-mistakes.md - 快速排障,只有症状 →
kb/gotchas.md
Top 法则(生成界面前逐条自检)
- LAW-1 间距编码从属关系:组间间距 ≥ 组内 2 倍,间距取 4 的倍数离散刻度(4/8pt 体系),三种关系不得用同一数值
- LAW-3 每视图一个视觉焦点:恰好一个最高强度主操作(唯一实心 CTA),强调色占比 ≤10%(60-30-10),操作按实心/描边/文本三档分权
- LAW-4 颜色不得为唯一信息载体:状态/数据/链接必须提供图标、形状、文字或位置第二通道;红绿不得为唯一区分轴
- LAW-5 对比度满足 WCAG AA:正文 ≥4.5:1,大字与非文本交互元素 ≥3:1,必须在真实渲染背景上验证
- LAW-13 状态完整性先于美观:数据视图四态(空/加载/错误/成功)齐备,可交互组件五状态集(default/hover/focus-visible/active/disabled)齐全,缺项禁止交付
- LAW-15 动效纪律:只动画 transform/opacity(禁
transition: all),微交互 150~300ms,prefers-reduced-motion: reduce必须降级 - LAW-21 视觉规格不压倒交互底线:语义元素、最小命中区、对比度、焦点可见优先于像素稿;NEVER 移除焦点环而无
:focus-visible替代 - LAW-23 不编造:不确定的 aria-*/WCAG 条款号/属性值输出「不确定,待文档验证」,不虚构蓝紫渐变冒充品牌
Top 坑点(不读 kb 也必须知道的)
- [G-42] 异步只写 happy path——失败白屏/无限转圈,用户被锁死(最高频系统性缺陷)
- [G-43] 乐观更新无回滚 + 提交无 pending 锁——连点产生重复订单/重复付款(直接资损)
- [G-49]
outline: none无替代焦点——键盘用户全站"失明"(WCAG 2.4.7) - [G-17] 灰字正文 #999 on 白底 ≈2.85:1——白底最浅合格灰是 #767676(4.5:1)
- [G-1] placeholder 当 label——输入后提示消失、自动填充无法核对
- [G-39]
transition: all+ 一刀切.3s模板手癖——意外动画 + 反馈迟钝 - [G-32] AI 蓝紫渐变品牌脸
#667eea→#764ba2——模板指纹冒充设计结论;无品牌输入须声明「未注入品牌」 - [G-18] 深色模式 naive invert——负片/品牌变浊/阴影失效层级坍塌;须语义 token 整体重映射
- [G-26]/[G-27] 中文正 letter-spacing + 字体栈中西文顺序反——中文字距撕裂、字形发闷
- [G-52] 触控目标 <24×24——移动端点不中、误触(WCAG 2.5.8 底线,移动端 ≥44×44)
回答规范
- 回答引用 kb 条目时保留来源标注([官方文档]/[模型经验]/[推断]/[实战回流]);仅 [模型经验] 标注的结论视为未经文档验证(R34 后 7 个子领域 kb 均含 [官方文档] 锚点,按条目标注判断)。
- 生成界面/代码前逐条自检 LAW 条款(Top 法则 + 相关子领域法则小节);违反任何一条先修正再输出。
- 不确定时明说不确定;WCAG 版本敏感结论注明所基于版本(本库锚定 WCAG 2.2,2023-10-05)。
- 用户问题超出 kb 覆盖面时如实说明,不要虚构领域知识。
知识回流
触发条件:修复了 kb 未覆盖的设计缺陷 / 发现 kb 错误过时 / WCAG 或设计规范大版本更新。
处理:按 kb-distiller 的 refine 规程(kb-distiller/prompts/refine.md)向对应 kb 文件追加结构化条目,标注 [实战回流],更新 frontmatter 的 version 与 updated;坑点类回流先考虑是否应升维为法则条款。
已知待回流缺口:R34 全量锚定已完成——APG 30 模式(含 Dialog Modal)、WCAG 2.2 spec 86 条 SC 逐字 + Quick Reference 技法层、lawsofux 30 法则、NN/g F 型+横幅盲视、HIG 11 主题均已升 [官方文档];剩余降级源:Material 3(m3.material.io,JS 站仅标题)与 Practical Typography(三次传输错误)维持纯模型模式,Android/Material 侧数值(48dp 等)未锚定,回流时优先文档验证。
事实抽查记录
| 轮次 | 抽查条数 | 结果 | 日期 |
|---|---|---|---|
| 全项目评审机制对齐轮(本域首次事实抽查) | 抽样 30/候选 67(seed 42) | OK 22 / BLOCKED 8 / BROKEN 0;BLOCKED 复核:w3.org 403 ×6 为并发限流(串行 HEAD 复核 dialog-modal 与 WCAG22 TR 均 200,非真断链);practicaltypography.com timeout(已知降级源,见「已知待回流缺口」);1 个为版本注意中反引号内 URL 规律说明 <topic>.md 被 spot_check 识别为 URL(模板文字非真实链接,工具已知局限) | 2026-11-18 |
Related skills
- Downloads
- 91All time
- Security audit
- Review
- Last updated
- 3d ago
- Current version
- v0.1.0
- License
- MIT-0
