SuperAPI AI 工具集

ux-audit

设计与创作

查看项目

更新于 10-16 02:10

技能介绍

用途

ux-audit 用于对屏幕界面进行 UX 问题审查,依据 Nielsen 十大可用性启发式原则以及现代移动端 UX 最佳实践。目标对象由 $ARGUMENTS 指定。

适用场景:当你需要审查界面是否存在可用性问题时使用。

不适用场景:

  • 仅涉及无障碍问题时,使用 /ss-a11y。
  • 涉及设计系统令牌/黄金规则合规时,使用 /ss-review。
  • 涉及文案/微文案质量时,使用 /ss-copy。
  • 针对尚不存在的新界面时,先使用 /ss-page 或 /ss-flow 进行设计。

主要能力

审查框架包含 Nielsen 十大可用性启发式原则,每项均列出具体检查点:

  1. 系统状态可见性:加载状态(骨架屏而非旋转器)、操作后的成功/错误反馈(toast 通知)、多步骤流程的进度指示、导航项的活动状态清晰显示、实时数据带有时间戳以表明新鲜度。
  2. 系统与真实世界的匹配:标签使用用户语言而非技术术语、图标通用可识别(Lucide 标准集)、数字格式符合用户预期(逗号分隔符、货币符号)、日期格式符合地区习惯。
  3. 用户控制与自由:所有非根屏幕提供返回导航、破坏性操作有确认对话框、可逆操作提供撤销(带撤销的 toast)、底部面板/模态框可关闭(点击背景、下滑、X 按钮)、无暗黑模式(无强制操作,始终有办法关闭)。
  4. 一致性与标准:相同操作在各处外观一致、颜色含义一致(绿=成功,红=错误,品牌色=活动)、文本层级遵循 5 级灰度系统、所有卡片使用相同阴影/圆角/内边距、间距遵循 6px 网格系统。
  5. 错误预防:破坏性按钮视觉上明显区分(破坏性变体)、表单验证在失焦时进行(而非输入时)、危险操作需要明确确认、输入约束在错误发生前可见(字符限制、格式提示)。
  6. 识别优于回忆:所有图标带标签(尤其是底部导航)、当前状态无需记忆即可见(活动标签高亮)、显示最近/常用项以便快速访问、占位符文本显示预期格式。
  7. 灵活性与效率:关键操作从首页起 3 次点击内可达、数据屏幕支持下拉刷新、触控目标 ≥ 44x44px(无过小点击区域)、常用操作位于易于触及的区域(屏幕底部)。
  8. 美学与极简设计:每个屏幕聚焦一个主要任务、无无目的的装饰元素、遵循信息金字塔(最重要=最大)、卡片密度遵循最多 4 项规则、无相互竞争的视觉元素(每页一个主指标)。
  9. 帮助用户从错误中恢复:错误消息用通俗语言解释出错原因、错误消息建议如何修复、部分失败不破坏整个页面(一个卡片失败,其他照常加载)、网络错误显示重试按钮、表单错误高亮具体字段。
  10. 帮助与文档:空状态引导用户采取行动、首次使用功能有引导(如适用)、复杂指标有工具提示(如适用)。

额外的移动端专项检查:

  • 触控与手势:触控目标最小 44x44px、相邻触控目标间至少 8px、无依赖悬停的交互(移动端无悬停)、滑动手势有可见提示(轮播指示器)。
  • 性能感知:骨架屏在 300ms 内出现、用户操作采用乐观更新、首屏内容优先加载、内容加载后无布局偏移。
  • 安全区域:内容不被刘海/灵动岛遮挡、底部内容不被 Home 指示条遮挡、底部导航有 pb-safe 内边距。
  • 防暗黑模式:进入时无强制底部面板、无阻止退出的对话框、每个屏幕都有返回/关闭方式、CTA 标签清晰描述操作、无操纵性图形(乞求、紧迫感)。

使用方式

该技能通过传入目标参数($ARGUMENTS)对指定屏幕进行审查,按上述框架逐项检查并生成报告。

输出格式

  • 评分:A+ 至 F 评级及分项说明。
  • 关键问题:必须修复(阻碍可用性)。
  • 主要问题:应该修复(降低体验)。
  • 次要问题:可以修复(打磨)。
  • 建议:针对每个问题给出具体代码修改。

限制

仅当任务明确匹配其上游来源和本地项目上下文时使用此技能。在应用更改前,需验证命令、生成的代码、依赖项、凭据和外部服务行为。不要将示例视为环境特定测试、安全审查或针对破坏性/高成本操作的用户批准的替代品。

暂未提供的信息

该技能的官方文本(official_text)为空,因此未提供更多官方说明;除上述资料外,具体评分算法、示例输出细节、依赖环境等信息暂未提供。