SuperAPI AI 工具集

21st-ui-review

设计与创作

查看项目

更新于 10-15 07:42

技能介绍

21st-ui-review 是一个面向现有 UI 的审查技能,旨在基于项目自身的设计上下文、无障碍预期、响应式行为、交互质量以及高置信度的生产问题进行评估。其核心原则是“以证据审查 UI”,并将确定性的缺陷与主观的设计建议明确区分开。

用途 该技能用于对已有界面进行系统性审查,帮助发现可验证的问题,而不是仅凭组件名称或主观印象推断行为。它适用于需要确保 UI 符合项目设计规范、无障碍标准、响应式要求和交互质量的生产环境。

主要能力 审查覆盖多个维度:语义控件与可访问名称;键盘访问、焦点可见性以及对话框/菜单行为;图像替代文本与有意义的标签;触摸目标尺寸与禁用/加载状态;响应式溢出与固定宽度假设;减少动态效果的处理;与项目令牌冲突的硬编码视觉值;重复的基础组件而非复用现有组件;不一致的排版、圆角、间距、阴影和图标;以及虚假数据、占位文案或缺失的空/错误状态。

使用方式 工作流程如下:首先读取 .21st/design.json、项目说明和相关源码;然后运行确定性审查,命令为 21st review <path> 或 21st review <path> --json;接着检查实际的组件构成和运行时状态,并对照代码验证结论,而不是从名称推断行为。审查发现按以下类别分组:确定性缺陷、设计系统漂移、无障碍与交互缺陷、响应式风险、主观产品/设计建议。按用户影响排序,并包含精确的文件和行号归属。仅对确定性、低歧义的修复使用 21st review <path> --fix。该技能明确要求:绝不静默重新设计、更改品牌标识或改变产品行为。修复后需运行相关项目测试,并重新运行审查以证明问题已解决。

适用场景 适用于对现有 UI 进行基于证据的审查,尤其是在需要区分客观缺陷与主观建议、需要精确归因、需要遵循项目设计系统和无障碍标准的开发流程中。

限制 该技能不会静默重新设计、更改品牌标识或改变产品行为。--fix 仅用于确定性、低歧义的修复。如果未证明存在问题,应说明并列出已检查的内容。关于收费、价格、平台支持等具体信息,资料中暂未提供。