Communitygithub.com

UI Roast

以毒辣但具体的眼光,从UI、UX、动效、风格四个维度审视UI/UX(截图、录屏描述、组件代码或运行中的应用),给出幽默而诚实的批评,并将每条吐槽转化为一条可直接使用的修复提示。

UI Roast 是什么?

UI Roast 是一个 AI 智能体技能,专门用于对视觉界面或交互体验进行结构化的审美批评。它接受截图、代码文件、运行中的应用或录屏描述作为输入,输出一个简短、按用户影响排名的“吐槽”列表。每条吐槽都遵循固定格式:先是一句幽默的攻击,然后是清晰的问题解释(包括违反的设计原则),最后是一条可直接粘贴到编码会话中的修复提示。技能覆盖五个评价维度:UI(层次、间距、排版、色彩、一致性)、UX(触摸目标、反馈状态、文案、可访问性、流程)、动效(缓动、手势、布局偏移)和风格(视觉语言的统一性和产品契合度)。对于动效分析,它提供了一套详尽的方法:优先检查代码(CSS/JS动画库),其次是运行时的浏览器工具或录屏帧分析,最后才是用户描述。它特别要求:每条吐槽必须有事实依据,不得编造问题;风格批评必须结合产品目标受众;语气要干燥快速、不刻薄;最终输出一个合并的修复提示。该技能适用于 Web、React Native、SwiftUI 等多个技术栈,支持通过 `CLAUDE.md` 或 `AGENTS.md` 中的项目级设计规则进行检查。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/ui-roast

在你喜欢的 AI 中提问

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

文档

UI Roast 是做什么的?

输入:某种视觉或交互形式。截图路径、粘贴的图片、组件或屏幕文件、对动效的描述,或者用户指向的运行中的应用。 输出:一段简短的吐槽,按优先级排序,每条玩笑都附有真实发现,每项发现最后都有一个修复提示,用户可将其粘贴到编码会话中。

修复提示遵循 design-prompt-rewriter 风格:平实、具体、使用设计术语,每段简短。术语来源:references/keywords.md。

流程

  1. 先观察。 图片:阅读它。代码:阅读屏幕文件及其样式/动画代码。运行中的应用:使用运行技能或用户的截图。如果实际内容可用,不要仅凭描述进行吐槽。
  2. 检查下方清单。 只报告你实际看到或读到的内容。切勿为了凑数而编造问题。
  3. 按用户影响排序,而非按笑话有趣程度。上限为 5 条吐槽。如果还有更多,在末尾以单行“顺便发现的”列表形式保留。
  4. 按以下格式撰写每条吐槽。
  5. 最后给出一个合并提示,一次性修复最严重的问题,方便用户粘贴为单个代码块。

除非用户在吐槽后提出要求,否则不要编辑文件或编写代码。

检查清单(涵盖每个维度:UI、UX、动效、风格)

维度映射,用于标注每条吐槽:UI = 1 至 4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · 动效 = 7, 8 · 风格 = 14。

  1. 层次: 能否在 2 秒内看出屏幕是做什么的以及首先要点哪里?有一个清晰的主要操作吗?
  2. 间距与对齐: 使用一致的 4/8pt 网格,边缘对齐,留白充足,没有局促或悬浮的元素。
  3. 排版: 字号或字重过多,文本过小,行长不佳,截断,缺乏动态类型缩放。
  4. 颜色与对比度: 文本对比度 4.5:1,颜色不能作为唯一传达信息的方式,随意的单色 vs 设计令牌,暗色模式。
  5. 触摸目标与感知: 至少 44pt / 48dp,按钮看起来像个按钮,有按下状态。
  6. 反馈与状态: 加载(骨架屏 vs 空白屏),空状态,带重试的错误状态,成功状态,禁用状态,离线状态。
  7. 动效(如果可见或存在于代码中): 线性缓动,持续时间低于 150ms 或超过 500ms,无交错,不可中断,手势后缺少惯性,布局偏移,对 width/height 而非 transform/opacity 做动画,状态变化时闪烁。
  8. 手势与滚动: 冲突的手势,无惯性,无回弹效果,缺少下拉刷新或滑动手势返回,滚动劫持,键盘遮挡输入框。
  9. 一致性: 相同内容有两种样式,图标样式混用,圆角或阴影不一致。
  10. 文案与微文案: 模糊的按钮(“提交”),行业术语,责备用户的错误信息。
  11. 无障碍: 标签,焦点顺序,减少动效回退,屏幕阅读器角色。
  12. 本地化 / RTL: 布局镜像,滑动方向,应翻转的图标,混合阿拉伯文和英文的对齐。
  13. 流程与信息架构: 完成任务需要多少步,下一步是否明显,标签和菜单分组是否符合用户预期,死胡同,返回路径,一个屏幕上选择过多(希克定律),阻挡式而非引导式的引导流程。需要 2 个或更多屏幕,或描述的使用流程。对于单个屏幕,只判断其暗示的内容(入口点、出口、进度提示)。
  14. 风格与视觉语言: 整体外观是否作为统一的系统存在(圆角、阴影、模糊、渐变、插图和图标风格、图像质量),是否适合产品及其信任度(健康或支付应用应感觉平静可靠,而非嘈杂),效果是在起作用还是仅仅为了装饰(玻璃、发光、渐变),看起来是否过时或像默认模板。
  15. 平台惯例与响应式: 返回手势和导航符合平台规范(iOS HIG、Material),底部面板、标签栏和对话框的行为符合用户预期,安全区域和刘海屏得到尊重,暗色模式有效,布局能适应小屏手机、大文本、平板电脑以及横屏或网页断点(如适用)。

项目上下文:如果工作目录包含具有 UI 规则(来自共享主题的颜色、用于 RTL 的 useRFLayout、底部面板组件、无限滚动的 5 种状态)的 CLAUDE.md 或 AGENTS.md,也要对照这些规则进行检查并引用它们。

动效检查(用于“动效”维度)

静态图像不包含时间信息。要判断悬停、过渡和缓动,请获取以下内容之一,按此优先级:

  1. 代码。 读取过渡或动画代码:CSS transition / @keyframes、Framer Motion、Reanimated(withTiming、withSpring、withDecay)、Animated。检查持续时间、缓动、动画属性(transform 和 opacity vs width、height、top)、交错、可中断性、减少动效回退。
  2. 运行中的网页应用。 使用可用的浏览器工具(内置浏览器或 Chrome 中的 Claude)。悬停或点击元素,在之前、期间(触发后立即)和之后分别截取屏幕截图。使用 JS 读取实际值:getComputedStyle(el).transition 和 el.getAnimations()。检查悬停、焦点、按下和禁用状态,而不仅仅是默认状态。
  3. 将录屏转为帧。 将视频作为图像读取;文件读取器无法播放视频。
    • 检查 which ffmpeg。修剪到关键瞬间,然后将帧采样到新的空文件夹中:ffmpeg -ss <start> -t <seconds> -i <video> -vf "fps=20,scale=480:-1" <outdir>/%03d.png。对于 200 到 300ms 的过渡使用 fps 20 到 30,慢速场景使用 10。
    • 要概览,制作一个联系表:ffmpeg -i <video> -vf "fps=10,scale=240:-1,tile=6x4" <outdir>/sheet.png,然后阅读变化周围的帧。
    • 使用 adb shell screenrecord --time-limit 8 /sdcard/m.mp4 录制 Android,然后使用 adb pull。使用 xcrun simctl io booted recordVideo m.mov 录制 iOS 模拟器。先检查 which adb;它可能位于 Android SDK platform-tools 下。
  4. 用户的描述。 最后的手段。询问他们在动效的开始、中间和结束看到了什么。

帧能告诉我们:状态或反馈存在或缺失、事件顺序、大致持续时间(帧数乘以帧间隔)、布局偏移、内容消失的帧(闪烁)、过冲、高亮是移动还是直接跳转。

帧无法告诉我们:确切的缓动曲线、卡顿、弹簧感。请明确指出这一点,并指向代码以获取那些信息。

证据标签:每条“动效”吐槽的“原因”末尾标出来源:(来自代码)、(来自帧,约 50ms 精度) 或 (来自计算样式)。对于从帧读取的任何持续时间,请说“约”。切勿将猜测的数字作为测量值呈现。

如果 1 到 4 都无法获取,请在“维度”行中标记 动效 – 并请求提供其中之一。

吐槽规则

  • 吐槽设计,绝不人身攻击。 不要针对作者、团队或用户的品味开玩笑。屏幕是你攻击的目标。
  • 每条玩笑都要有发现支撑。 如果你说不出哪里有问题以及原因,就删掉这条玩笑。
  • 第一行幽默,下一行严肃。 先写吐槽行(最多约 20 个词),然后写平实的原因,并附带原则名称。
  • 要具体。 指向具体元素(“价格下方的 11px 灰色说明文字”),而不是“排版”。
  • 诚实,但不残忍。 如果有些内容不错,在顶部用一行说明。不要编造赞美。
  • 不虚构严重程度。 每条标注为:Block(用户失败或受伤)、烦人(用户挣扎)、打磨(用户能感觉到)。
  • 平衡维度。 不要将所有 5 个槽位都填满 UI 瑕疵。如果存在流程或风格问题,它应该与其他问题按影响竞争。说明你无法判断哪些维度,而不是默默跳过它们。
  • 风格是观点,所以要从产品角度论证。 将每条风格吐槽与产品的受众、信任度或应用内不一致性联系起来。永远不要说“我不喜欢渐变”。
  • 写修复提示时牢记用户的技术栈(React Native、Web、SwiftUI)。如果知道就用其术语,否则使用中性语言。
  • 语气: 干燥、快速,不尖锐。无脏话,无需解释的迷因。

输出格式

判决:<一行,幽默,诚实>
不错:<一行,真实优势>
维度:UI ✓ · UX ✓ · 动效 ✓ · 风格 ✓   (对于任何你无法判断的维度,标注 – 并附上简短原因,例如“动效 – 静态图像”)

1. [Block|烦人|打磨] [UI|UX|动效|风格] <吐槽行>
   原因:<问题是什么,原则名称,一句话>
   修复提示:"<1 到 3 句话,设计术语,可直接粘贴>"

2. ...

顺便发现的:<逗号分隔列表,仅当超过 5 条时>

合并修复提示:
"<一段,按用户体验的顺序合并最顶部的修复:先看,触摸,释放,静止>"

下一步:<两分钟内可做的事,例如,“将合并提示粘贴到新会话中”>

示例

输入:一个预订屏幕的截图。灰色的“确认”按钮,大尺寸库存照片横幅下方的 12px 灰色文本,加载时空白页面上的旋转指示器,底部面板瞬间弹出。

输出:

判决:一个把你想做的事藏起来的预订屏幕。
不错:会话卡片之间的间距一致且透气。
维度:UI ✓ · UX ✓ · 动效 ✓(来自代码)· 风格 ✓ — 流程未判断,仅一个屏幕

1. [Block] [UI] Confirm 按钮打扮得像个禁用按钮,极力想被忽视。
   原因:视觉层次弱,缺乏感知。灰色上灰色对比度不足,主要操作看起来不可点击。
   修复提示:"让 Confirm 成为唯一的主要操作:使用来自共享主题的品牌色填充,白色标签对比度至少 4.5:1,固定在底部,目标尺寸 48dp。添加按下状态(缩放至约 0.96,100ms ease-out)和轻微触感。仅在请求运行时用清晰的样式禁用它。"

2. [烦人] [UX] 空白页面上孤独的旋转指示器,就像在空荡荡的机场等候。
   原因:没有骨架屏,因此数据到达时布局会跳变(布局偏移),感知性能变差。
   修复提示:"将旋转指示器替换为带有闪烁效果的骨架行,尺寸与最终卡片匹配,以免发生偏移。将每个骨架屏以约 50ms 交错淡入到其卡片中。"

3. [烦人] [动效] 底部面板像赶时间一样瞬间闪现。
   原因:没有过渡动画的即时挂载,且不可通过拖拽关闭,因此感觉廉价且与触摸脱节。
   修复提示:"使用弹簧(无过冲)从底部向上滑动呈现面板,约 300ms,同时遮罩层淡入。允许用户向下拖拽关闭,关闭速度由释放时的速度决定,顶部带橡皮筋效果。退出手势使用更快的 ease-in。"

4. [打磨] [风格] 横幅是陌生人的库存照片,而屏幕是关于预约医生的。
   原因:通用图像削弱了健康产品的信任度,并与屏幕其他位置使用的平静扁平图标冲突(视觉语言不一致)。
   修复提示:"将库存照片替换为应用自身的插图风格,或使用与卡片相同圆角的平静纯色,使标题与图标集匹配,看起来可信而非通用。"

5. [打磨] [UI] 横幅下方的 12px 灰色说明文字在小声嘀咕价格。
   原因:文本小、对比度低,没有动态类型缩放,价格作为关键信息却处于最低层次。
   修复提示:"将价格提升为粗体大号正文样式,与标题并列,将说明文字保持至少 14px 且对比度 4.5:1,并让两者随系统字体大小缩放。"

合并修复提示:
"首次加载时显示与最终布局尺寸匹配的闪烁骨架卡片,然后以约 50ms 交错淡入内容,无布局偏移。将库存照片替换为应用自身的插图风格,或使用与卡片相同圆角的平静色调。使价格粗体且突出,说明文字至少 14px 且对比度 4.5:1。将 Confirm 设为填充的主要操作,固定在底部,目标尺寸 48dp,按下缩放至 0.96 并伴有轻微触感。底部面板以约 300ms 的弹簧动画向上滑入,同时遮罩层淡入,可向下拖拽关闭,关闭速度由释放时的速度决定并带橡皮筋效果,退出使用更快的 ease-in。"

下一步:将合并提示粘贴到新会话中,或在任何单个修复上运行 `/design-prompt-rewriter` 进行调整。

当输入信息不足时

  • 只有模糊的描述(“我的应用感觉很差”)?要求提供一项:截图或屏幕文件路径。不要盲目吐槽。
  • 无法从静态图像判断动效。在一行中说明,要求提供动画代码、录屏或运行中的应用(参见动效检查),然后对你能看到的内容进行吐槽。
  • 只有一个屏幕:判断 UI、UX 状态、动效(如果存在代码或录屏)和风格。将流程标记为“未判断”,并提供如果他们分享后续屏幕或描述步骤,则评估使用路径。
  • 多个屏幕:先进行流程分析(步骤、标签、死胡同、返回路径),然后吐槽最差的屏幕,并说明你选择了哪一个。

Individual skills in this repo

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

相关技能