Communitygithub.com

检查用户体验

根据30条《用户心理法则》(lawsofux.com)对项目UI进行审计,并生成一份带有具体修复建议的优先级报告。仅报告问题,除非用户要求,否则不进行修复。

检查用户体验 是什么?

此技能用于审计用户界面是否符合30条《用户心理法则》(LawsofUX),这些法则涵盖了交互与努力、记忆与认知、感知(格式塔原理)、以及序列、动机与体验记忆等多个维度。它能够对代码库(支持Web、React、Vue、Svelte、Angular、React Native、Flutter、SwiftUI等)、在线URL或截图进行分析。该技能会生成一份详尽的报告,对每一条法则进行审查,列出通过项和未通过项,并根据严重程度(高、中、低)对问题进行分级。每个发现的问题都必须包含对应的法则、具体位置(文件:行号、URL或截图区域)以及一个具体的修复方案。它遵循严格的工作流程:首先收集界面信息(识别技术栈、读取标记和样式、或加载URL),然后逐一检查每条法则,最后输出结构化报告。报告完成后,技能会主动询问是否要对高优先级问题进行修复,如果发现涉及动效或反馈相关的问题(例如多赫蒂阈值、峰终定律、目标渐变效应),还会建议使用 `/animate-this-app` 命令。该技能设计为仅报告问题,除非用户明确要求修复,且修复方案应保持最小改动,不改变应用的整体风格。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

在你喜欢的 AI 中提问

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

文档

检查用户体验 是做什么的?

根据《用户心理法则》对界面进行审计,并生成一份包含实际问题和具体修复方案的优先级报告。仅报告,不修复,除非用户提出要求。

工作流程

1. 收集界面信息

  • 代码库: 检测技术栈,然后找到屏幕/路由、共享组件(按钮、输入框、表单、导航、模态框、列表、表格)、设计令牌以及加载/错误状态。读取实际的标记和样式,而不仅仅是文件名。
  • 在线URL / 本地构建: 在浏览器中打开,走通主要流程,截取桌面端和移动端宽度的截图,尽可能测量触控目标和响应时间。
  • 截图: 进行视觉判断;将仅代码检查标注为“无法验证”。
  • 识别3-5个主要用户任务(注册、搜索、结账、创建X)。对这些流程进行最严格的审计 —— 帕累托法则同样适用于审计本身。

2. 检查每一条法则

逐条检查下表。对于每条法则,寻找列出的信号。仅报告有具体定位的实际发现;绝不在报告中添加泛泛的建议。如果某条法则满足要求,则用一行列入“通过”列表。

3. 报告(格式见下方),然后主动提供修复高优先级问题的服务。

法则:需要关注的问题及修复方法

交互与努力

法则发现问题时建议修复方案
菲茨定律 (Fitts's Law) —— 到达目标的时间取决于大小和距离触控目标 < 44×44 pt(iOS)/ 48×48 dp(Android)/ 24×24 CSS px 最小值(WCAG 2.5.8),理想值为44px;纯图标按钮且内边距极小;主要操作远离视线/拇指区域;破坏性操作和主要操作相邻且间距 < 8px增加内边距或添加 ::after { inset:-8px } 点击区域;将主要CTA放在其作用的内容附近,并在移动端置于拇指区域;分隔破坏性操作
希克定律 (Hick's Law) —— 决策时间随选项数量和复杂度增长导航项 > 7个顶级项;菜单/选择框包含长且未排序的列表;单个屏幕上存在多个同等权重的CTA分组、渐进式披露(“更多”)、为长列表添加搜索/筛选功能、提供合理的默认值、设置一个主要CTA
选择过载 (Choice Overload)定价/套餐页面选项 > 3-4个且无推荐;设置项堆积;一次性显示过多筛选条件突出推荐选项、折叠高级选项、使用对比表格
多赫蒂阈值 (Doherty Threshold) —— 响应时间 < 400 毫秒时效率最高异步操作没有加载/待定状态;按钮在提交时未禁用或显示进度;小负载使用全屏加载动画;无乐观更新;输入操作被阻塞的网络调用提供 < 100 毫秒的即时反馈、骨架屏、乐观UI、延迟加载动画(约300毫秒)、对搜索进行防抖处理
波斯特尔定律 (Postel's Law) —— 对自己接受的内容要宽容严格的输入格式(电话号码、日期、卡号拒绝空格/连字符);大小写敏感的邮箱;未进行trim操作;验证错误信息不说明如何修复;阻止粘贴标准化输入(trim、去除分隔符)、接受多种格式、设置 inputmode/autocomplete 属性、提供有帮助的错误信息
特斯勒定律 (Tesler's Law) —— 复杂性无法删除,只能转移用户被迫执行系统本可以完成的任务(重新输入已知数据、计算值、选择可推断的时区/国家)自动填充、智能默认值、推断、记住上次选择
主动用户悖论 (Paradox of the Active User) —— 用户不读手册功能仅通过文档/悬停提示才能发现;提供价值前有冗长的引导教程;空状态无任何引导在使用点提供内联提示、可操作的空状态、边做边学的引导
心流 (Flow)不必要的打断(对可撤销操作的模态框/确认框、强制重新认证);无针对高级路径的键盘快捷键;操作后失去焦点使用“撤销”代替“确认”、保持焦点/滚动位置、支持键盘操作、尽量减少上下文切换

记忆与认知

法则发现问题时建议修复方案
米勒定律 / 组块化 (Miller's Law / Chunking)长且未分段的表单;原始显示的长字符串(ID、电话号码、卡号未格式化);大段文字;导航项超过10个且平铺将表单分段为组/步骤、将数字格式化为块、使用标题和短段落
认知负荷 (Cognitive Load)充满竞争元素的密集屏幕;专业术语;相同事物的术语不一致;装饰性杂乱移除非必要元素、使用一致的标签、使用通俗语言
工作记忆 (Working Memory)用户必须记住前一个屏幕的信息(验证码、之前的选择);占位符作为唯一标签且输入时消失;跨页面比较保持上下文可见(摘要、持久标签、面包屑导航)、并排比较
心智模型 (Mental Model)控件行为与其外观不符(按钮样式的链接执行导航操作,反之亦然);不寻常的隐喻;保存模型不明确(自动保存 vs 手动保存)匹配用户期望;明确展示系统状态
雅各布定律 (Jakob's Law) —— 用户期望你的网站与其他网站工作方式相同非标准放置(logo不链接主页、购物车不在右上角、搜索隐藏);自定义控件替代原生控件但功能不对等;重新发明模式遵循平台约定(iOS HIG / Material / 网页标准);优先使用原生元素
奥卡姆剃刀 (Occam's Razor)冗余步骤、重复控件、主屏幕上无人流程需要的特性移除或移至次要界面
帕累托原则 (Pareto Principle)主要任务被埋没,而极少使用的特性占据黄金位置提升那20%使用频率占80%的功能的优先级
帕金森定律 (Parkinson's Law)表单/任务耗时比必要时间长;无自动填充;无设置预期的进度指示器自动补全、自动填充属性、显示预估时间/步骤
选择性注意 / 横幅盲视 (Selective Attention / Banner Blindness)关键信息设计得像广告,或放置在横幅/侧边栏中;重要的警告信息融入背景将关键信息内联放入任务路径中,使其醒目但不失身份
认知偏差 (Cognitive Bias)黑暗模式:预选勾选的opt-in、确认羞辱、隐藏费用、虚假紧迫感、误导性默认值移除黑暗模式;使用诚实的默认值。标记为高优先级(涉及伦理和法律风险)

感知(格式塔)

法则发现问题时建议修复方案
接近法则 (Law of Proximity)标签更靠近错误的输入框;不相关项和相关项之间间距相等;帮助文本远离其所属字段组内间距更紧密,组间间距更大(使用间距尺度)
相似法则 (Law of Similarity)外观相同的元素行为不同(可点击文本和静态文本看起来一样);相同操作级别的按钮样式不一致根据角色使用一致的视觉语言
共同区域法则 (Law of Common Region)相关控件未分组;无边界的卡片混合内容使用卡片、区域、背景区域对组进行划分
统一连接法则 (Law of Uniform Connectedness)步骤/相关项目未在视觉上连接使用线条、连接线、共享容器来展示步骤/时间线
简洁法则 / 普雷格南茨法则 (Law of Prägnanz)过度复杂的图标/插图、模糊的形状简化形式;使用带标签的可识别图标
审美可用性效应 (Aesthetic-Usability Effect)视觉不一致(混合圆角、随机颜色、未对齐的网格、不一致的字号体系)从而削弱信任感将间距/排版/颜色令牌化;对齐到网格

序列、动机与体验记忆

法则发现问题时建议修复方案
孤立效应 / 冯·雷斯托夫效应 (Von Restorff Effect)主要CTA在视觉上不突出;所有内容都被突出,导致无一突出;仅依赖颜色区分每个视图只保留一个强调的主要操作;同时使用形状/大小/图标(无障碍考虑)
序列位置效应 (Serial Position Effect)关键导航项位于长列表中间;最重要信息埋没在页面中部将关键项放在开头和结尾(例如,Tab栏中“首页”排第一,“个人中心/购物车”排最后)
峰终定律 (Peak-End Rule)弱或缺失的成功状态(表单提交后无任何显示或直接重定向);严苛的错误死胡同;流程突兀结束清晰、令人满意的确认信息;对错误提供有用的恢复路径;打磨最后一步
目标梯度效应 (Goal-Gradient Effect)多步骤流程无进度指示;进度从0开始使用步骤指示器/进度条,显示剩余步骤,给用户一个“先机”
蔡格尼克效应 (Zeigarnik Effect)未完成任务被遗忘(无草稿、导航时丢失表单数据、无个人资料完成度提醒)自动保存草稿、“从上次中断处继续”、完成度检查清单

严重程度

  • 高 (High) —— 阻碍或严重减慢主要任务,导致错误/数据丢失,无障碍失败,或存在黑暗模式。
  • 中 (Medium) —— 在常见路径上存在明显的摩擦或困惑。
  • 低 (Low) —— 打磨;次要屏幕。

报告格式

# UX 审计 — <应用/屏幕>
范围:<审计内容> · 方法:代码 / 在线 / 截图
得分:<通过的法则数>/30 · 高:n · 中:n · 低:n

## 优先修复的前3个问题
1. ...

## 发现的问题
### [高] 菲茨定律 — 图标按钮太小
位置:src/components/Toolbar.tsx:42 (同样见于 Header.tsx:18)
问题:20×20px 的图标按钮无内边距;移动端易误触。
修复:添加 `p-3`(达到44px目标)或使用 `::after` 扩展点击区域。
```(如果短则附上代码片段)```

(……每个发现一个块,按严重程度分组,高优先级在前……)

## 通过
- 雅各布定律 — 标准导航和logo-首页模式。
- ...

## 无法验证
- 多赫蒂阈值 — 需要一个运行中的应用来测量响应时间。

规则

  • 每个发现必须包含:法则、位置(file:line、URL + 元素、或截图区域)、观察到的问题、以及具体的修复方案。没有位置 → 不报告。
  • 合并重复项:每个根本原因只列一个发现,列出所有位置。
  • 修复方案不应改变应用的整体风格或个性;建议最小的改动以解决问题。
  • 在判断雅各布定律和目标大小时,请尊重平台约定(iOS HIG、Material、网页标准)。
  • 与可访问性(对比度、焦点、标签)的重叠是允许的 —— 在相关法则下注明即可,但不要将其变为一个完整的 WCAG 审计。
  • 报告完成后,询问是否要修复高优先级(或全部)的发现。如果发现存在动效/反馈相关问题(多赫蒂阈值、峰终定律、目标梯度效应),可提及 /animate-this-app 可以解决这些问题。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能