Communitygithub.com

界面质感

用于让应用或网站感觉更精致、更快或更高端,审计并修复UI动效、动画、过渡或交互质量,或为Web/移动项目应用UX定律、动画原则与UI技巧(菲茨定律、希克定律、多尔蒂定律、乐观更新、骨架屏、命令菜单、撤销提示、触摸扩展、安全三角区、视图过渡)。

界面质感 是什么?

界面质感是一个全面的AI助手技能,用于审计和优化Web或移动应用的交互与动效品质。它基于一份包含40个检查项(12个动画原则、8个UX法则、20个UI技术)及运动系统的清单,对现有应用进行审计,生成报告,并根据每个项目的修复模式逐一修复。该技能通过代码普查(census.sh)和实时页面探测(probe.js)进行定量评估,同时强调手动驱动的交互测试(如双重点击、网络限速、手势冲突)来发现脚本无法覆盖的问题。它支持Claude Code、Cursor、Codex等平台,工作原理是先审计不修改,再按清单修复,最后验证。结果分为“构建”(不改变外观的行为调整)和“挑选”(需要产品决策的外观变化),并始终尊重项目自身的设计系统和运动令牌。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

在你喜欢的 AI 中提问

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

文档

界面质感 是做什么的?

界面如何移动和响应的主控通杀。它根据40项检查(12个动画原则、8个UX法则、20个UI技术)和运动系统,审计应用当前的表现,编写报告,然后按照每个项目的模式进行修复。大多数应用已经拥有一半的清单项;审计会如实指出,而非重复添加。速度、点击目标和信任始终适用;装饰性处理在工作工具中保持克制。

项目自身的设计系统、运动令牌和规则优先于此处任何内容。性能预算(LCP、INP、包体积)、无障碍和文案应作为独立的通行证与此并存。

此技能包含的文件

文件用途
reference.md40个检查项:如何检查、修复模式、何时跳过、真实审计发现
motion.md运动系统:令牌、十二条规则、CSS模式、如何审计动效
audit/census.sh代码普查:统计每个检查项背后的模式,附带文件:行 定位
audit/probe.js实时页面探测:真实点击目标尺寸、时长、缓动、数字、标题、代码字段、占位符
report-template.md审计报告模板:每个检查项一行结论、工作顺序、未检查项

第一阶段:审计(不修改任何内容)

  1. 首先阅读项目的设计系统、运动令牌和UI规则。
  2. 在项目根目录运行代码普查:bash <此技能路径>/audit/census.sh . --show 5。它仅读取已上线的表面内容(排除依赖、构建产物、副本、测试、基准测试、生成文件和注释行;可通过 CENSUS_EXCLUDE="dir1,dir2" 添加更多排除)。安装 ripgrep 可加速运行;否则脚本将回退到 perl。计数是定位线索,而非最终结论。
  3. 运行应用。在每个关键页面运行 audit/probe.js(粘贴到控制台,或在浏览器工具的JavaScript运行器中 await 它),分别在1440px和375px宽度下,以及应用的每个主题中运行。它会逐屏滚动整个页面并恢复滚动位置。隐藏的标签页没有宽度且不渲染帧:请先显示它。解读输出时需判断:标记为 spaced 的目标(与下一个控件的间距达到下限)严重性较低;数字仅在变化时才需要 tabular-nums;将装饰性模拟窗口标记为 aria-hidden 或忽略其行。
  4. 手动驱动脚本无法看见的交互,需使用真实的指针事件(浏览器工具的点击,而非合成的 .click()):对每个付费或不可逆操作快速双击,统计服务器端效果;将网络和写入操作限速至600ms后再点击;快速打开和关闭每个层并中途重新打开,采样其不透明度(参见 motion.md 中的 "Measuring a reopen");在关闭的菜单内部点击;输入带重音和不同大小写的查询;沿着对角线移向悬停子菜单;在层打开时按下Android返回键;滑动手机弹窗。
  5. 根据 report-template.md 编写报告:全部40行,每行标记为 存在、缺失、错误 或 跳过,并附理由、证据(文件:行或数值),以及 构建 或 挑选。在修复前展示报告。

第二阶段:按清单修复

  1. 信任优先:第39项及任何可能导致双重收费或数据丢失的问题,需在修复前编写能测试失败的测试用例。
  2. 构建项:改变行为但不改变外观(触摸扩展、安全三角区、返回手势、重音折叠、快捷键、命令菜单条目、乐观写入、骨架屏、动效令牌、可逆过渡)。根据 reference.md 和 motion.md 中的模式,通过项目自身的组件和令牌进行修复,并为所有逻辑添加测试。
  3. 挑选项:改变外观或产品特性(圆角、模糊占位符、用撤销替代确认、错误提示、新的动效节奏、视图过渡)。分别在两个主题下,按1倍比例对每项进行前后对比基准测试,编号且可分离;仅构建产品负责人挑选的项目。
  4. 切勿用移除的装饰来替换新的装饰。

第三阶段:验证

重新运行代码普查和实时探测,将数值与报告对比。以用户真实使用的方式,在两个主题下以及手机宽度下分别驱动每个已修复的交互。将已构建、已测试、已视觉批准和已部署作为独立事实报告,并说明哪些内容无法测量(无实体手机、无生产构建)。

清单

编号与 reference.md 及报告一致。

#检查项失败条件
A动画原则 (motion.md)
1挤压与拉伸着陆徽章、圆点或旋钮停止时僵硬
2预备动作按下后一帧内无状态变化(缩放约0.97,约100ms)
3呈现打开的层让主要内容不清晰
4姿态到姿态繁忙的按钮、标签或图标切换时宽度或内容跳跃
5跟随动作层的内容与容器同时到达,没有先后
6缓入缓出UI动效使用 linear 或默认 ease;超过三种缓动函数
7弧线某元素沿直线长距离移动
8次级动作完成的操作没有确认性的第二拍
9干脆的时机UI响应超过300ms;同一界面中存在不一致;退出时间未更短
10夸张反馈无效提交仅显示微动,无色彩变化
11立体绘画阴影和图层在光照和深度上不一致
12吸引力一个真实流程,按1倍比例分步播放,暴露接缝
BUX法则
13菲茨定律桌面端真实目标小于32px,或手机端小于44px
14更大的点击区域通过放大图片增大目标,或兄弟元素重叠
15希克定律单个菜单块中超过五个项目
16米勒定律超过约七个未分块的一级项目
17多尔蒂定律从按下到下一帧绘制超过400ms,且无任何首次响应
18波斯特尔定律查询的重音、大小写或间距变体找不到结果
19雅各布定律模式行为与平台不一致(悬停子菜单、返回关闭层)
20使用频率日常操作需要多于一步或一个命令才能完成
C速度与反馈
21骨架屏加载路由渲染空白或点击帧显示加载动画
22乐观更新便宜的、可逆的写入在服务器响应前无任何显示
23命令菜单某个目的地可通过点击到达,但无法通过键盘输入到达
24快捷键提示有快捷键的控件在工具提示中未显示该快捷键
25撤销提示可恢复的删除操作没有撤销选项(由产品负责人决定是否替代确认框)
26用旧数据立即刷新重新访问的页面等待而非立即显示上次数据
27预渲染可能的下一页未在意图明确时预取(在生产环境中判断)
28模糊占位符加载中的图片是灰色方框
29视图过渡网格到详情的打开没有共享元素变形效果
30滑动关闭手机弹窗或抽屉无法通过滑动关闭
31可中断动画在退出动画期间重新打开,从头播放
D平台与细节
32预测性返回Android返回键在层打开时离开当前页面
33触摸扩展小图标控件没有不可见的目标扩大区域
34安全区域边距底部浮动元素未使用 env(safe-area-inset-*) 且未设置 viewport-fit=cover
35一次性验证码自动填充验证码输入框缺少 autocomplete="one-time-code" 和 inputmode="numeric"
36等宽数字变化的数字抖动(未使用 tabular-nums)
37平衡标题短的多行标题出现孤行(未使用 text-wrap: balance)
38连续圆角未考虑方圆形圆角(外观决策:进行基准测试)
E信任
39幂等性键对付费或不可逆操作的两次快速点击导致两个服务器端效果
40安全三角区悬停子菜单在向它对角线移动时关闭

常见错误

  • 添加已存在的内容:骨架屏、缓存和动效令牌通常已经存在;结论应为存在。
  • 将客户端去重作为唯一的防护手段:两次点击发生在重新渲染禁用按钮之前。应在服务器端防护(条件更新、确定性键、锁),并在 ref 中保持按下状态。
  • 放大图片而非扩大目标区域;仅在桌面宽度下检查目标,而桌面规则可能压低了手机端的最小尺寸。
  • 使用关键帧实现打开和关闭动画:它们无法反向。应使用状态属性上的过渡,并将离开的层设为 inert。
  • 将撤销、圆角或错误提示音视为纯工程决策。它们属于产品负责人。
  • 在开发服务器或后台标签页中判断预取或计时。

相关技能