SuperAPI AI 工具集

design-review

设计与创作

查看项目

更新于 10-17 16:13

技能介绍

设计评审(design-review)是一个用于对已渲染 UI 进行书面批评的工具。它不修复设计或重写文案。评审标准位于 references/review-criteria.md,发现设计、证据和探测方法位于 references/sources.md。

使用方式:从请求中给出的任何信息开始。“发布前检查这个屏幕”就足够。默认设置包括:设计范围(调用者指定,否则分支中更改的屏幕,否则顶部路由);目的(推断并在记录顶部标记为假设);视口(提供图像的宽度,否则应用支持的最窄和最宽宽度,默认 390 和 1280 像素)。

主要能力:

  1. 查找设计:在每个视口捕获每个屏幕,并在那里运行无障碍扫描。完成条件为记录列出源、工具、视口、扫描和今天的日期。
  2. 探测对话框和表单:仅在本地构建上进行,每个探测需有测量结果或未运行的原因。
  3. 修正目的:如果目的不可读或与屏幕矛盾、两个版本到达且没有标记当前版本、或标准与 AGENTS.md 或 CLAUDE.md 矛盾且没有规则说明谁赢,则停止。
  4. 遍历标准:在每个视口检查每个标准。
  5. 排序:将重复项合并为一个发现并计数;当一个发现的恢复落入另一个时,在两者中都说明并一起排序;品味放入“左外”;有意偏离或无标准覆盖的问题放入“供人决定”。
  6. 排序无障碍观察:对比度、目标大小和键盘问题被排序;树变更遵循 ../build-design-system/references/traps.md(仅添加的无障碍变更)。
  7. 按标准文件的严重程度排名,每组按影响位置数量排序。
  8. 遍历边缘情况,标记每个显示或未显示,以及屏幕上组件的每个规范的 States 行。
  9. 最后写 verdict 和摘要。

输出:任何 Blocking 发现使 verdict 为 no;推断的发现为 no, pending <the one check that settles it>。仅 Should fix 使 verdict 为 yes, with fixes;仅 Notes 为 yes。第一行以平实语言回答请求,不包含标准编号或技能名称。ship 行遵循相同的 verdict,用一句话说明原因,并列出供人决定的无障碍问题数量。部分运行的 verdict 仅覆盖已评审内容。然后六个部分:评审记录、摘要、按严重程度分组的发现、未显示的边缘情况、供人决定、左外。

限制:每个发现必须基于所用文件中的标准,绝不基于品味;评审渲染结果,描述、DOM 文本或源代码仅支持发现;语义变更的无障碍修复和产品决策由人决定,发现保持。