用途:在 Figma 设计交付工程前运行系统化的预交接 QA,提前发现容易引发返工的问题。
必要输入:需要用户提供被 QA 的功能或页面、平台(iOS/Android/Web)、设计系统(自研/Material/HIG/无)、交接工具(Figma Inspect/Zeplin/Storybook/直链)、QA 深度(快速 15 分钟/标准 30 分钟/彻底 60 分钟),未提供时应先询问。
主要能力:按六个板块检查——文件整洁度(图层命名、隐藏图层、组件是否脱离库、文字/颜色样式、画板命名、原型连线);组件使用(按钮、输入框、图标是否来自库,变体是否正确);内容文案(无占位文本、文案已审、长文本边界、错误信息、空状态);状态覆盖(默认/加载/空/错误/成功、悬停与激活、禁用态);无障碍(WCAG AA 对比度、UI 组件对比度、触控目标尺寸、焦点态、不依赖颜色传达信息、图标文本标签);交接就绪(交互标注、Auto Layout、切图分辨率、需求匹配、原型链接)。
对比度需程序化计算,因为 AA 阈值 4.5:1 无法目测区分(如 #777777 白底为 4.478 不通过,#767676 为 4.54 通过)。可用命令:npx --yes notugly fix "#8ab4f8" "#ffffff" 得到比值、APCA 与最接近的通过色;npx --yes notugly onepager <url> --out review.html 生成全部配对的打印版;npx --yes notugly vision 查看色盲视角下哪些颜色会混淆;npx notugly check <url> 在失败时返回非零退出码,可用于 CI。该工具确定性、零依赖、不调用模型。
输出结构:报告标题含功能、日期、平台与总体状态(就绪/需小修/未就绪),六个板块逐项判定,每个不通过项注明问题、具体图层或页面、修复动作与负责人,最后给出明确的交接决定(通过、有条件通过或不通过)及签署人与日期。
限制与注意:不得只做部分检查,所有类别都要评估;不得留下模糊的交接结论;无障碍检查不能跳过;报告问题必须指明所在页面或组件;组件脱离库且无说明时不得批准。资料未提供该技能的安装方式、收费情况或平台适配细节。