用途
ss-audit 是一个用于审查界面 UX 问题的工作流技能,依据 Nielsen 十大可用性启发式原则以及现代移动端 UX 最佳实践对目标界面进行评估。其审查目标由参数 $ARGUMENTS 指定。
主要能力
该技能围绕 Nielsen 十大可用性启发式原则展开审查:
- 系统状态可见性:检查加载状态(骨架屏而非旋转指示器)、操作后的成功/错误反馈(toast 通知)、多步骤流程的进度指示、导航项的激活状态、实时数据的时间戳新鲜度。
- 系统与现实世界匹配:标签使用用户语言而非技术术语、图标通用可识别(Lucide 标准集)、数字格式符合预期(千分位、货币符号)、日期格式符合区域设置。
- 用户控制与自由:所有非根界面提供返回导航、破坏性操作有确认对话框、可逆操作提供撤销(带撤销的 toast)、底部弹层/模态可关闭(点击背景、下滑、X 按钮)、无暗黑模式(无强制操作,始终有退出方式)。
- 一致性与标准:相同操作外观一致、颜色含义一致(绿=成功、红=错误、品牌色=激活)、文本层级遵循 5 级灰度系统、表面处理遵循已解析的语法与品牌配方、间距遵循已解析的 token 尺度与适配器约束。
- 错误预防:破坏性按钮视觉上可区分(破坏性变体)、表单验证在失焦时进行(而非输入时)、危险操作需要显式确认、输入约束在错误发生前可见(字符限制、格式提示)。
- 识别优于回忆:图标控件有可访问标签,导航标签遵循所选适配器、当前状态无需记忆即可见(激活标签高亮)、显示最近/常用项以便快速访问、占位符文本展示预期格式。
- 灵活性与效率:关键操作可通过适当的产品特定路径到达、刷新行为遵循平台适配器与产品数据语义、触控命中区域 >= 44x44px,指针优先控件遵循已解析的契约(已批准的 36–40px 控件不算触控失败)、常用操作按已解析的导航适配器放置。
- 美学与极简设计:每个界面聚焦一个主要任务、无无目的的装饰元素、尊重信息金字塔(最重要=最大)、卡片与集合密度遵循已解析的语法与任务复杂度、无竞争性视觉元素(每页一个主指标)。
- 帮助用户从错误中恢复:错误消息用平实语言解释出错原因、错误消息建议如何修复、部分失败不破坏整个页面(一张卡片失败,其他仍加载)、网络错误显示重试按钮、表单错误高亮具体字段。
- 帮助与文档:空状态引导用户采取行动、首次使用功能的引导(如适用)、复杂指标的提示(如适用)。
移动端专项检查包括:
- 触控与手势:触控表面命中区域最小 44x44px,为每种输入模式保留适用的无障碍底线;相邻触控目标之间最小 8px;无依赖悬停的交互(移动端无悬停);滑动手势有可见提示(轮播指示器)。
- 性能感知:骨架屏在 300ms 内出现、用户操作采用乐观更新、首屏内容优先加载、内容加载后无布局偏移。
- 安全区域:内容不被刘海/灵动岛遮挡、底部内容不被 home 指示器遮挡、导航表面在适用时遵循平台安全区域契约。
- 暗黑模式防范:进入时无强制底部弹层、无退出阻止对话框、每个界面都有返回/关闭方式、CTA 标签清晰描述操作、无操纵性图形(乞求、紧迫感)。
使用方式
该技能以工作流形式运行,审查目标通过参数 $ARGUMENTS 传入。在使用前需遵循每会话一次的更新预检。
关于产物边界,采用注册表优先原则:当 .styleseed/project.json 与 .styleseed/artifacts/index.json 存在时,先解析请求的 artifact ID,然后只读取 .styleseed/bundles/<artifact-id>.md 与 .styleseed/manifests/<artifact-id>.json。对于注册表项目,绝不回退到全局遗留 bundle。遗留项目仅在没有注册表时使用 .styleseed/effective-rules.md。
输出格式包含:评分(A+ 到 F 评级及分解)、关键问题(必须修复,阻碍可用性)、主要问题(应当修复,降低体验)、次要问题(可选修复,打磨)、建议(针对每个问题的具体代码修改)。
适用场景
适用于对已有界面进行 UX 审查,识别可用性问题并获取具体修复建议。
限制
该技能有明确的不适用场景:仅处理无障碍问题应使用 /ss-a11y;设计系统 token 与黄金规则合规应使用 /ss-review;文案/微文案质量应使用 /ss-copy;尚不存在的新界面应先通过 /ss-page 或 /ss-flow 进行设计。