用途:对 Figma 节点树做 WCAG 2.2 无障碍与设计系统质量检查。它通过 use_figma 运行,适用于任意 Figma 方案,检查真实设计(真实颜色、自动布局、变体名称),而非生成代码。原生 Figma MCP 只读取设计用于生成代码,不做设计侧检查,此技能填补该空白,移植了 14 条 WCAG 2.2 规则加 6 条设计系统/布局规则。
主要能力:一次遍历报告无障碍与设计质量问题,结果按规则分组,每条带 severity(critical/warning/info)与 wcagLevel(a/aa/aaa/best-practice/design-system),并给出问题节点 node.id。规则可默认全开,也可缩小到 wcag、design-system、layout 组或具体规则 id(如 wcag-contrast)。
使用方式:先加载官方 figma-use 技能;脚本为普通 JS,支持顶层 await 与 return,输入以 const 内联在脚本顶部,颜色为 0–1 范围,文本操作前先加载字体,用 await figma.getNodeByIdAsync(...),脚本失败为原子性、不产生任何更改。取目标 NODE_ID(帧、组件集或屏幕),留空则检查当前整页;运行 scripts/lint-design.js,skillNames 为 lint-design-figma。按严重度分诊,优先处理 critical(对比度、目标尺寸、焦点、仅颜色)。修复后重跑同一范围,确认 summary.total 下降。
限制:背景通过向上查找最近实色填充推断,默认白色;半透明填充上的对比度会标记 approximate: true。MAX_DEPTH 默认 10,MAX_FINDINGS 默认 100,若 truncated 被设置需缩小范围或提高上限。部分规则(文字大小、行高、字距/段距)标为 best-practice 而非硬性 WCAG 失败。发现仅为描述性,不会自动修复,批量修改前需确认意图。组件级深度评分卡、代码侧 a11y、设计-代码漂移检查请分别使用 audit-accessibility-figma、scan-code-accessibility-figma、check-design-parity-figma。