Communitygithub.com

UI/UX 设计

根据命名的视觉风格设计和构建界面——提取具体的样式令牌和组件规范,然后根据质量标准审查结果。在构建或重新设计页面、选择外观、匹配品牌美学(液态玻璃、极简主义、编辑风格、Bento、赛博朋克等数十种)时使用,或者当 UI 看起来过于通用、需要一种明确的视觉观点时使用。

UX 设计 是什么?

UI/UX 设计技能是一个基于规范的界面设计工作流,它将设计决策从模糊的形容词转变为精确的令牌和组件配方。它通过五个注册工具引导设计师和 AI 代理:`uiux_styles` 用于根据情绪词和领域浏览样式目录,`uiux_spec` 用于获取完整规格(令牌、组件、可访问性等),`uiux_mix` 用于创建两种样式的加权混合,`uiux_platform_guide` 用于咨询 Chrome 现代 Web 指南以确保交互正确,以及 `uiux_motion` 用于获取动画配方(优先使用原生 API)。该技能支持 MD、CSS、Tailwind v4 和 JSON 输出格式,并包含一个用于预览的样式画廊和选项卡。其核心哲学是“一种方向,完全承诺”:必须始终如一地应用光谱仪的颜色、间距、半径和排版,偏差必须明确说明原因;否则,结果仅仅是一个颜色交换,未能提供独特的视觉标识。该技能拥有完整的和简短的规格层级:完整规格包括经过验证的对比度对和反模式,而简短规格则提供调色板和几何形状,让 AI 自行做出组件和可访问性决策。它包括一个六步工作流程(筛选 → 提交 → 构建 → 检查平台 → 动画 → 审查),并以强制执行统一规范的规则结束——例如永不反转颜色、尊重 `prefers-reduced-motion` 以及优先考虑内容而非装饰。该技能在 Claude Code、Cursor、Codex 和类似的 AI 编码工具上运行,并利用项目目录中的 `references/` 文件夹来存储样式索引、质量检查清单和上游数据源。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/humphrey-de-conqueror/dsh-uiux/tree/main/skills/uiux

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

UX 设计 是做什么的?

此技能通过本插件注册的五个工具以及旁边的参考文件来引导设计工作。这些样式是经过编写的规范,而非形容词:每种样式都包含颜色角色、字体比例、间距、圆角、高度、动效以及组件配方,你可以直接复制使用,而无需自己发明数值。

工作流程

  1. 筛选。 使用用户的情绪词、领域以及他们提到的任何样式名称调用 uiux_styles。阅读单行描述和最适合列。挑选两到三个适合内容(而非名字最漂亮)的候选样式。

  2. 提交。 使用所选样式的 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 命令。
  3. 构建。 对所有颜色、圆角、间距、阴影和持续时间使用样式的令牌。先根据 components 部分构建组件,然后再发明新的组件。规范中的每个值都有其存在的理由;如果偏离,请说明是哪个值以及为什么这样偏离。

    规范中的 composition 行是样式的一部分,而非装饰:poster 意味着网格中的规则和大号字体,glass 意味着悬浮在渐变背景上的半透明面板,terminal 意味着带框屏幕中的等宽行,bento 意味着不等大小的瓷砖,soft 意味着带有配对阴影的表面,toy 意味着粗边框和硬偏移。将一种样式倒入通用的卡片网格就是一种颜色交换,而这正是本插件旨在阻止的失败模式。

  4. 检查平台。 在实现交互(对话框、标签页、轮播、粘性头部、深色模式、表单、动画、图像优先级)之前,使用 op: "search" 和你正在实现的行为调用 uiux_platform_guide,然后使用 op: "retrieve" 获取值得阅读的 ID。这些是 Chrome 的现代 Web 指南规则——遵循它们,而不是你自己的习惯。

  5. 从平台开始逐层添加动画。 在添加任何动画库之前,使用接口需要的内容(“表格加载时的骨架屏”、“进入详情页面的共享元素”)调用 uiux_motion。配方优先使用原生 API——用于菜单的 popover、用于共享元素的 startViewTransition、用于滚动显示的 animation-timeline: view()、用于骨架屏和加载器的 CSS 关键帧——并且每个配方都包含 prefers-reduced-motion 分支。当配方需要项目缺少的依赖项(例如 spring-entrance 需要 motion 库)时,使用 op: "probe" 和 dir 进行检查,然后停止,安装它,再继续;不要手动实现配方已经解决的问题。

  6. 审查。 在断言工作完成之前,先仔细阅读 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 - 样式数据的来源、许可证以及当上游发布新样式时如何刷新它。

相关技能