SuperAPI AI 工具集

accessibility-annotations

设计与创作

查看项目

更新于 10-15 21:08

技能介绍

用途:在 Figma 屏幕上添加无障碍标注,让工程师明确每个元素的阅读顺序、Tab/焦点顺序、角色、标签和图片替代文本。工作以 Figma 为先,使用项目配置的标注库,禁止自造组件或手绘高亮形状。

主要能力:支持阅读顺序(灰色,仅文本)与 Tab 顺序(红色,含焦点)标注,单一连续编号;提供 Order、Button、Image、Role Value Label、More info 等标注组件;区分 Button(真实控件)与 Image(装饰/Logo,Alt=""),禁止同一控件同时使用 Button 与 Role;提供 A–I 屏幕模式选择器,覆盖简单内容、引导页、信息流、列表、卡片网格、详情页、整卡、加载骨架、筛选/搜索等场景;含筛选控件的 Role/Label/Value/Hint 配方。

使用方式:先解析项目配置(标注库、组件名、品牌字体、AX 区域、已签核模板),加载环境的 Figma 写入技能后再写入;读取项目交接文档,确认要标注的区块/屏幕,优先一次一屏,等待用户 QA 后再处理同级屏幕;从已签核模板克隆,按工作流逐步执行并截图验证,更新交接状态。

限制:Figma 写入必须串行,禁止并行写同一文件;切换页面仅用异步 page API,每次调用最多切换一次;脚本失败为原子操作,需诊断后重试,不可盲目重试;不依赖 toast 通知,需返回创建或修改节点的 ID;不依赖变量/品牌字体成功加载;无文档专用 More info 注释(Pattern H Shimmer 除外);单元素不添加顺序标记;不堆叠标注,不使用自制高亮矩形。具体收费、价格、平台与效果暂未提供。