Communitygithub.com

21 Grams UX

审核并修复由AI构建的产品的流程和可用性,使其按照人们的预期工作,而不仅仅是看起来完成,使用项目自身的组件和模式。当用户要求“21 grams UX”、希望审核流程或屏幕的可用性,或要求修复返回和关闭行为、滚动恢复、无限信息流、乐观点赞和收藏、草稿保存、权限提示、底部弹出面板、深度链接、导航、表单、空状态、加载状态和错误状态、反馈、新用户引导(问卷、注册、试用、付费墙、权限请求、向导)、破坏性操作、无障碍和键盘使用、现有前端中的任务长度或选择过载、AI提议和接受/拒绝流程、上下文工具栏、删除范围、键盘快捷键、协作在线状态、筛选器和底部弹出面板、缺失数据和N/A、文本截断、基于角色的视图、移动端和桌面端一致性、阅读宽度,或询问主流产品如何处理某个问题时使用。

21 Grams UX 是什么?

21 Grams UX 是 21 Grams 系列中的专注用户体验的智能体技能,专门用于审核和修复由AI构建的现有产品流程的可用性问题。与21 Grams UI(负责视觉外观)不同,21 Grams UX 不重新设计产品或添加新的UI套件,而是严格使用项目已有的组件和模式来修复流程中的断点、缺失状态、静默失败和不可恢复的操作等常见问题。 该技能遵循**核心原则**:使用项目自身的组件(规则零)、进行详尽的研究(包括分析当前产品和行业领先案例)、运用一系列编号UX规则和领域规则(如导航、表单、状态、反馈、新用户引导等),并强制执行一系列不可协商的体验标准(如模态框关闭行为、滚动恢复、乐观更新、自动保存草稿等)。 工作流程包括:盘点项目资产、研究、映射流程、在浏览器中走查、审计、向用户展示审计结果、应用修复、验证并报告。它可以与21 Grams UI技能配合使用(应先运行UX),并随每次审核会话积累新的领域规则。该技能可用于Claude Code、Cursor、Codex等AI编程代理,帮助开发者确保产品不仅看起来完成,而且真正可用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/main/skills/ux

在你喜欢的 AI 中提问

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

文档

21 Grams UX 是做什么的?

对现有流程进行审核。21 Grams UX(21 Grams 系列的用户体验包)不重新设计产品,也不添加 UI 套件。它会遍历真实的流程,找出AI构建的产品在使用过程中出现的断裂点(死胡同、缺失状态、静默失败、不可恢复的操作、与用户对抗的表单),并通过项目已有的组件和模式修复它们。

21 Grams UI 负责外观。21 Grams UX 负责功能。当两者都安装时,先运行 UX:打磨一个本不该存在的步骤没有任何意义。

规则零:使用项目自身的组件

所有更改都通过项目已有的内容进行。21 Grams UX 从不构建一套并行的组件或并行的流程。

  1. 在改动任何东西之前进行盘点。 记录路由器和路由映射、组件库、表单库和验证方法、弹窗、对话框和空状态组件、数据获取层(加载和错误状态的来源)以及分析或事件层(如果有)。
  2. 在原始位置修复问题。 缺失的错误状态应放入共享数据或空状态组件,而不是单个界面。确认模式应使用项目自己的对话框,而不是临时的。
  3. 如果已有适合的组件或依赖,绝不添加新的。 不会为了获得 21 Grams UX 效果而引入新的表单库、toast 库或引导库。
  4. 当确实缺少某个部分时(没有空状态组件,没有撤销功能),则使用项目现有的基本元素,按照其文件布局和命名规范来构建,并在报告中说明。
  5. 产品决策仍由产品方决定。 21 Grams UX 不会改变产品功能、目标用户或业务规则。它只改变现有任务的执行方式。任何会改变范围的内容都会作为问题(而非修复)记录在报告中。

优先级顺序: 用户的说法 > 项目的既定模式和产品规则 > 21 Grams UX 内部规则。

包含的内容

  1. UX 研究步骤。 在设计或重新设计流程之前,使用像 Mobbin 这样的模式库(如已连接)逐个分析当前产品和三到五个行业领先案例。完整流程见 references/research.md。
  2. UX 法则。 规则的来源知识,见 references/laws.md,按 A1、A2… 节引用。A 节是核心法则:希克定律、费茨定律、雅各布定律、米勒定律、多尔蒂阈值、特斯拉定律和波斯特尔定律。当没有规则覆盖某个案例时,从这些法则推理。
  3. UX 规则。 references/rules.md 中的编号规则,每条规则包含规则内容、如何应用、需要标记什么,以及快速审核清单。以移动端优先编写,也适用于网页(桌面端用“底部标签”表示主导航,用“弹出面板”表示“底部弹出面板”)。
  4. 领域规则。 从 AI 构建产品的实际审核会议和主流产品的 UX 研究中学习的规则,见 references/field-rules.md,以 F1、F2… 引用。该文件在每次审核后都会增长(参见“扩展领域规则”)。
  5. 按领域的内部规则 位于 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)

工作流程

  1. 进行盘点(规则零)。
  2. 研究(references/research.md)。对于新流程、重新设计或新用户引导,从这里开始:了解设计内容和目标用户,分析当前流程,推荐三到五个行业领先案例,并在更改任何内容之前与用户逐一浏览。仅对现有流程的小修小改可以跳过此步。
  3. 映射流程。 列出用户主要任务,以及每个任务在产品中的路径:入口点、每一步、每个分支、结束状态。记录每一步的数据来源。
  4. 在浏览器中走查每个流程,而不仅仅是看代码。先走顺境路径,然后测试边缘情况:尚无数据、慢网络、请求失败、无效输入、返回操作、中间刷新、仅使用键盘、窄屏幕。
  5. 在更改之前进行审计。 逐项检查 references/rules.md、references/laws.md 和 references/field-rules.md 末尾的清单,以及各领域文件。按领域、规则编号和法则对发现进行分组。每条发现记录流程和步骤、文件和行号、对用户造成的问题、修复方法以及该修复应放入哪个现有组件或模式。按严重程度排序:阻碍任务、减慢任务、粗糙边缘。
  6. 向用户展示审计结果,作为简短列表,并在应用大规模更改前征求同意。在请求范围内的微小、明显的修复可以直接进行。
  7. 按以下顺序应用修复: 共享组件和模式 → 流程 → 单个界面。保持差异范围可控,并遵循项目自身的约定。
  8. 通过再次在浏览器中走查流程进行验证,包括步骤3中的边缘情况。为每个更改的步骤捕获前后对比。
  9. 报告 每个流程和领域哪些内容发生了变化、修改了哪些组件,以及属于产品决策的未解决问题。

扩展领域规则

21 Grams UX 从实际工作中学习。当作者完成对 AI 构建的产品的审核会议并请求添加时:

  1. 阅读该会议的对话,列出作者要求或接受的所有更改。
  2. 保留 UX 更改(流程、结构、位置、状态、反馈、引导用户的文案、无障碍路径)。视觉更改(圆角、颜色、字体、图标、动效)属于 21 Grams UI。
  3. 将每个更改编写为通用规则:规则内容、如何通过项目自身的组件应用,以及需要标记什么。不包含客户名称、产品名称或私人内容。
  4. 如果某条规则是对现有规则的细化,则更新该规则而非添加新规则。
  5. 将新规则添加到 references/field-rules.md 中,带有会话标题,继续 F 编号,并在相应的领域文件中列出它们。

Individual skills in this repo

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

相关技能