21 Grams UX 是做什么的?
对现有流程进行审核。21 Grams UX(21 Grams 系列的用户体验包)不重新设计产品,也不添加 UI 套件。它会遍历真实的流程,找出AI构建的产品在使用过程中出现的断裂点(死胡同、缺失状态、静默失败、不可恢复的操作、与用户对抗的表单),并通过项目已有的组件和模式修复它们。
21 Grams UI 负责外观。21 Grams UX 负责功能。当两者都安装时,先运行 UX:打磨一个本不该存在的步骤没有任何意义。
规则零:使用项目自身的组件
所有更改都通过项目已有的内容进行。21 Grams UX 从不构建一套并行的组件或并行的流程。
- 在改动任何东西之前进行盘点。 记录路由器和路由映射、组件库、表单库和验证方法、弹窗、对话框和空状态组件、数据获取层(加载和错误状态的来源)以及分析或事件层(如果有)。
- 在原始位置修复问题。 缺失的错误状态应放入共享数据或空状态组件,而不是单个界面。确认模式应使用项目自己的对话框,而不是临时的。
- 如果已有适合的组件或依赖,绝不添加新的。 不会为了获得 21 Grams UX 效果而引入新的表单库、toast 库或引导库。
- 当确实缺少某个部分时(没有空状态组件,没有撤销功能),则使用项目现有的基本元素,按照其文件布局和命名规范来构建,并在报告中说明。
- 产品决策仍由产品方决定。 21 Grams UX 不会改变产品功能、目标用户或业务规则。它只改变现有任务的执行方式。任何会改变范围的内容都会作为问题(而非修复)记录在报告中。
优先级顺序: 用户的说法 > 项目的既定模式和产品规则 > 21 Grams UX 内部规则。
包含的内容
- UX 研究步骤。 在设计或重新设计流程之前,使用像 Mobbin 这样的模式库(如已连接)逐个分析当前产品和三到五个行业领先案例。完整流程见
references/research.md。 - UX 法则。 规则的来源知识,见
references/laws.md,按 A1、A2… 节引用。A 节是核心法则:希克定律、费茨定律、雅各布定律、米勒定律、多尔蒂阈值、特斯拉定律和波斯特尔定律。当没有规则覆盖某个案例时,从这些法则推理。 - UX 规则。
references/rules.md中的编号规则,每条规则包含规则内容、如何应用、需要标记什么,以及快速审核清单。以移动端优先编写,也适用于网页(桌面端用“底部标签”表示主导航,用“弹出面板”表示“底部弹出面板”)。 - 领域规则。 从 AI 构建产品的实际审核会议和主流产品的 UX 研究中学习的规则,见
references/field-rules.md,以 F1、F2… 引用。该文件在每次审核后都会增长(参见“扩展领域规则”)。 - 按领域的内部规则 位于
rules/,每个领域一个文件,列出属于该领域的法则、编号规则和领域规则:
| 文件 | 领域 |
|---|---|
navigation.md | 导航与寻路 |
forms.md | 表单与输入 |
states.md | 空状态、加载状态、错误状态和成功状态 |
feedback.md | 反馈与系统状态 |
onboarding.md | 新用户引导与首次使用 |
destructive.md | 破坏性操作与恢复 |
accessibility.md | 无障碍与键盘 |
flows.md | 流程与任务长度 |
choice.md | 选择与认知负荷 |
规则 #1–5 已保留,将在后续版本中添加。在某个领域拥有规则之前,请基于一般的可用性判断进行审核,并在报告中说明。
不可协商项
- X 关闭模态框或流程。左箭头返回上一屏。(#6)
- 加载时绝不出现空白屏幕:使用骨架屏、旋转指示器或进度条。(#7)
- 返回信息流时,恢复精确的滚动位置。(#8)
- 点击当前标签页返回顶部。(#9)
- 下一页在用户到达页面底部之前加载完成。(#10)
- 点赞、关注和收藏采用乐观更新,失败时回滚并显示消息。(#11)
- 草稿和未完成的输入自动保存。(#12)
- 权限在使用功能时请求,而非启动时。(#13)
- 快速操作在可向下滑动关闭的底部弹出面板中打开。(#14)
- 通知和共享链接打开精确内容。(#15)
- 每步少量选择,带推荐默认项;其余选项展开显示。(A1)
- 主要操作按钮大且易于触及;触摸目标为 44×44 像素。(A2)
- 常见任务使用标准模式。(A3)
- 信息分组;步骤之间无需记忆任何内容。(A4)
- 每次输入立即确认;较长等待显示进度。(A5)
- 产品承担复杂性,而非用户。(A6)
- 接受杂乱输入并以清晰形式回显,但绝不放松安全性或数据完整性。(A7)
- 每个任务只有一个控件。(F1)
- 屏幕操作集中在右上角,主要操作在角落,绝不与选择器混合。(F2)
- 次要详细信息按需显示,永不丢失;绝不移除唯一可访问的路径。(F3,F5)
- 每个信息只讲一次;屏幕上不显示版本号、设计说明或内部术语。(F6,F9)
- 当交互发生变化时,描述该交互的所有提示也同步更新。(F8)
- 新 UI 永远不声称超出产品声明的范围。(F10)
- 没有重复打开该步骤的选择步骤;仅有一个选项时直接执行。(F13,F17)
- 一个选择,一个上下文工具栏,点击其他地方则消失。(F16)
- 所有可添加的内容均可移除,删除操作会显示其影响范围。(F18,F19)
- 快捷键显示在工具提示中,且绝不使用浏览器保留键。(F20)
- AI 提议显示为暂定状态,使用统一的接受/拒绝模式,并即时接受。(F23)
- 新用户引导:两个对等的入口,每屏一个问题并显示进度,先展示价值再要求注册,可跳过的导览。(F28,F29,F32,F36)
- 付费信息诚实:提供真正的免费路径、带有日期的试用期以及在达到限制时升级。(F35)
- 阅读和选择在窄居中列中进行;只有当前步骤的上下文和操作保持固定。(F37,F38)
- 缺失数据显示 N/A,文本进行截断并对齐,所有列表使用真实数据量进行检查。(F43,F44,F45)
- 角色改变起点而非应用本身;移动端和桌面端共享相同模式。(F47,F50)
工作流程
- 进行盘点(规则零)。
- 研究(
references/research.md)。对于新流程、重新设计或新用户引导,从这里开始:了解设计内容和目标用户,分析当前流程,推荐三到五个行业领先案例,并在更改任何内容之前与用户逐一浏览。仅对现有流程的小修小改可以跳过此步。 - 映射流程。 列出用户主要任务,以及每个任务在产品中的路径:入口点、每一步、每个分支、结束状态。记录每一步的数据来源。
- 在浏览器中走查每个流程,而不仅仅是看代码。先走顺境路径,然后测试边缘情况:尚无数据、慢网络、请求失败、无效输入、返回操作、中间刷新、仅使用键盘、窄屏幕。
- 在更改之前进行审计。 逐项检查
references/rules.md、references/laws.md和references/field-rules.md末尾的清单,以及各领域文件。按领域、规则编号和法则对发现进行分组。每条发现记录流程和步骤、文件和行号、对用户造成的问题、修复方法以及该修复应放入哪个现有组件或模式。按严重程度排序:阻碍任务、减慢任务、粗糙边缘。 - 向用户展示审计结果,作为简短列表,并在应用大规模更改前征求同意。在请求范围内的微小、明显的修复可以直接进行。
- 按以下顺序应用修复: 共享组件和模式 → 流程 → 单个界面。保持差异范围可控,并遵循项目自身的约定。
- 通过再次在浏览器中走查流程进行验证,包括步骤3中的边缘情况。为每个更改的步骤捕获前后对比。
- 报告 每个流程和领域哪些内容发生了变化、修改了哪些组件,以及属于产品决策的未解决问题。
扩展领域规则
21 Grams UX 从实际工作中学习。当作者完成对 AI 构建的产品的审核会议并请求添加时:
- 阅读该会议的对话,列出作者要求或接受的所有更改。
- 保留 UX 更改(流程、结构、位置、状态、反馈、引导用户的文案、无障碍路径)。视觉更改(圆角、颜色、字体、图标、动效)属于 21 Grams UI。
- 将每个更改编写为通用规则:规则内容、如何通过项目自身的组件应用,以及需要标记什么。不包含客户名称、产品名称或私人内容。
- 如果某条规则是对现有规则的细化,则更新该规则而非添加新规则。
- 将新规则添加到
references/field-rules.md中,带有会话标题,继续 F 编号,并在相应的领域文件中列出它们。