用途:audit-ux-laws 是一个自包含的 UX 法则参考技能,基于 Jon Yablonski 的 lawsofux.com 整理 30 条 UX 法则,供 AI 代理在构建或审查 UI 时查找相关法则、应用到真实代码,并按严重程度标记违规。所有法则内容打包在 references/ 中,运行时不联网抓取。
主要能力:承担两类工作——主动设计(构建 UI 时选用合适法则)与审查(审查界面并以 CRITICAL / MINOR 报告违规及具体修复)。仅针对 UI:组件、布局、导航、表单、交互、感知性能;不做视觉/CSS 正确性检查,也不重新设计品牌或内容。代理只需判断哪些法则与当前对象相关,其余(要点、代码模式、严重度阈值)都在对应参考文件中。
使用方式:先按症状路由到法则,例如选项过多对应 Hick's Law、Choice Overload(references/heuristics.md);触控目标过小对应 Fitts's Law;信息过密对应 Miller's Law、Cognitive Load、Chunking(references/cognitive.md);分组与间距对应 Gestalt 法则(references/gestalt.md);响应时间对应 Doherty Threshold(references/principles.md)。设计时阅读法则的 Key Takeaways 与 Frontend Code Implications 并据此构建;审查时走 Review Criteria,分类违规并给出修复。严重度:CRITICAL 指破坏可用性、可访问性或信任(如移动端触控目标小于 44×44px、超过 7 个未分组选项、主 CTA 与次 CTA 难以区分、超过 400ms 无加载反馈、要求跨屏记忆);MINOR 指打磨优化(如颜色超过 6 种、间距不一致、缺少智能默认值、无进度指示、CTA 位置欠佳)。每条发现需连接心理原理并给出具体可执行修复,不能只说“改进 UX”。必要时可沿 Related 链接继续查阅。
适用场景:判断“这个 UX 好吗”、审查界面、构建或编辑组件/页面/布局/导航/菜单/下拉/表单、选项过多、触控目标尺寸、加载状态与感知性能、以及任何具名法则(Fitts、Hick、Miller、Jakob、Doherty、Gestalt、Von Restorff、Tesler、Postel、Pareto、Occam、Zeigarnik、peak-end、goal-gradient、serial position 等)。
限制:不适用于无用户界面的后端/API/数据层;纯视觉打磨(精确颜色、阴影、品牌)应交给 CSS/设计系统;需要带保存发现的全量角色化可用性审查用 audit-ux-and-save-files;需要跨页面截图视觉 UI bug 审查用 audit-ui-and-save-files。不要每次加载全部四个分类文件,先路由再应用;不要自造阈值,使用参考文件中的数字;严重度数字是可用性启发式,不能替代 WCAG 可访问性测试。