UX 设计 是做什么的?
此技能通过本插件注册的五个工具以及旁边的参考文件来引导设计工作。这些样式是经过编写的规范,而非形容词:每种样式都包含颜色角色、字体比例、间距、圆角、高度、动效以及组件配方,你可以直接复制使用,而无需自己发明数值。
工作流程
-
筛选。 使用用户的情绪词、领域以及他们提到的任何样式名称调用
uiux_styles。阅读单行描述和最适合列。挑选两到三个适合内容(而非名字最漂亮)的候选样式。 -
提交。 使用所选样式的 slug 调用
uiux_spec。指定你需要的sections(tokens、type、components、motion、rules、a11y、platform)以及输出format:md- 阅读它,然后编写代码。css- 将自定义属性块原样粘贴到样式表中。tailwind- 粘贴@theme块(假设使用 Tailwind v4)。json- 提供给生成器或其他工具。 如果用户要求混合(“70% 编辑风格,30% Bento”、“编辑风格但更柔和”),请改用uiux_mix——它会返回一个加权后的单一规格,并以主导样式的结构为基础。在回复中说明你应用的样式或混合样式名称,以便用户请求另一种样式。右侧边栏中的“样式预览” 选项卡会渲染你最后获取的内容,因此当用户想在构建之前预览方向时,请将其指向那里。样式图库 选项卡以卡片形式展示每种样式;这两个选项卡也出现在编辑器的 + 菜单中,作为uiux-preview和uiux-gallery命令。
-
构建。 对所有颜色、圆角、间距、阴影和持续时间使用样式的令牌。先根据
components部分构建组件,然后再发明新的组件。规范中的每个值都有其存在的理由;如果偏离,请说明是哪个值以及为什么这样偏离。规范中的 composition 行是样式的一部分,而非装饰:
poster意味着网格中的规则和大号字体,glass意味着悬浮在渐变背景上的半透明面板,terminal意味着带框屏幕中的等宽行,bento意味着不等大小的瓷砖,soft意味着带有配对阴影的表面,toy意味着粗边框和硬偏移。将一种样式倒入通用的卡片网格就是一种颜色交换,而这正是本插件旨在阻止的失败模式。 -
检查平台。 在实现交互(对话框、标签页、轮播、粘性头部、深色模式、表单、动画、图像优先级)之前,使用
op: "search"和你正在实现的行为调用uiux_platform_guide,然后使用op: "retrieve"获取值得阅读的 ID。这些是 Chrome 的现代 Web 指南规则——遵循它们,而不是你自己的习惯。 -
从平台开始逐层添加动画。 在添加任何动画库之前,使用接口需要的内容(“表格加载时的骨架屏”、“进入详情页面的共享元素”)调用
uiux_motion。配方优先使用原生 API——用于菜单的popover、用于共享元素的startViewTransition、用于滚动显示的animation-timeline: view()、用于骨架屏和加载器的 CSS 关键帧——并且每个配方都包含prefers-reduced-motion分支。当配方需要项目缺少的依赖项(例如spring-entrance需要motion库)时,使用op: "probe"和dir进行检查,然后停止,安装它,再继续;不要手动实现配方已经解决的问题。 -
审查。 在断言工作完成之前,先仔细阅读
references/quality/web-interface-guidelines.md。修复它标记的问题;这是样式化页面与成品页面之间的区别。
适用于所有样式的规则
- 一种方向,完全承诺。 半心半意地应用一种样式看起来像是个意外。如果规范要求 0 圆角和细边框,那么页面上就不能出现 12px 圆角。
- 内容优先。 样式服务于界面的任务。永远不要为了满足构图而隐藏、缩小或伪造用户的真实数据。
- 使用令牌。 不要使用调色板中没有的原始十六进制值来重新设计组件;一致性是让一种样式看起来像系统的重要原因。
- 对比度不可选择。
a11y部分列出了经过验证的对。你引入的任何新对比度对(在抬高的表面上的柔和文本,在彩色按钮上的文本)都需要满足:正文文本 4.5:1,大文本或非文本指示器 3:1。 - 深色模式是声明的,而不是反转的。 使用规范的深色调色板。如果没有,则通过保留强调色并重新检查对比度来派生一个。
- 动效有预算。 尊重
prefers-reduced-motion,保持统一入场编排,并且永远不要在用户正在阅读的滚动驱动内容上对布局进行动画。 - 通用输出是失败的。 带有渐变英雄图和表情符号图标的可互换卡片网格是模型默认采用的形式。如果结果可能属于任何其他产品,则表明样式未被应用。
样式系列
目录比这个列表更大;uiux_styles 会搜索整个目录,包括别名。
| 意图 | 值得尝试的样式 |
|---|---|
| 平静、高级、产品导向 | premium-minimalism, swiss-international, japandi |
| 深度、半透明、营销 | liquid-glass, glassmorphism, aurora |
| 响亮、表现力、发布页面 | neo-brutalism, maximalist-pop, cyberpunk, vaporwave |
| 精制印刷和编辑风格 | editorial, paper-print, monochrome-architecture |
| 系统、工具、密集数据 | data-dashboard, material-you, terminal-crt |
| 可触摸、有趣、柔和 | claymorphism, neumorphism, bento-grid |
内容层级
规范可以是 full 或 brief。
full- 完整的令牌、组件配方、做/不做规则、反模式、经过验证的对比度对。将其用作真理源。brief- 仅包含调色板、字体、圆角和间距。上游的awesome-design-skills提供了样式名称;它们的调色板和字体在此处编写,因此简短样式是独特的,而不是重复 59 次的相同蓝底白字默认值。将简短样式视为一个起点方向:保留其调色板和几何形状,然后自行决定组件和可访问性决策。
文件
references/style-index.md- 每种样式及其单行描述,根据数据文件生成。当你想要完整目录时,可以扫描此文件,无需进行工具调用。references/quality/web-interface-guidelines.md- 审查清单。请务必阅读。references/quality/style-review.md- 对视觉方向本身的简短通过/失败审查。references/upstream.md- 样式数据的来源、许可证以及当上游发布新样式时如何刷新它。