SuperAPI AI 工具集

vgv-accessibility

测试与质量

查看项目

更新于 10-16 04:06

技能介绍

用途

vgv-accessibility 用于对 Flutter 组件进行无障碍审计与修复,依据 WCAG 2.2 的 A、AA、AAA 合规等级,覆盖 iOS、Android、Web、macOS、Windows 和 Linux 六个平台。

主要能力

技能将工作流与按需加载的参考文件分离:

  • references/audit-templates.md:严重程度指南、报告模板、A / AA / AA + 选定 AAA / AAA 各等级通过检查清单,以及跨平台严重程度调整表。
  • references/examples.md:按类别扩展的 Flutter 代码,包含 WCAG 2.2 模式(焦点不被遮挡、拖拽替代、Cupertino 语义包装、MergeSemantics 正确用法)。
  • references/platforms/ios.md、android.md、web.md、macos.md、windows.md、linux.md:分平台的 WCAG 2.2 检查,仅加载与所选平台匹配的文件。

核心标准涵盖:合规等级选择、平台选择、图像语义(1.1.1)、手势检测器(2.1.1)、目标尺寸(2.5.8)、拖拽替代(2.5.7)、焦点不被遮挡(2.4.11)、颜色区分(1.4.1)、动画与动效(2.3.3)、图标按钮(4.1.2)、排除语义(1.1.1)、文本容器(1.4.4)、对比度(1.4.3)、Cupertino 语义(4.1.2)、自动填充提示(1.3.5)、异步公告(4.1.3)。

使用方式

工作流分四个阶段,不可跳过第一阶段和第二阶段:

  1. 合规等级选择:通过 AskUserQuestion 询问目标等级(A、AA、AA + 选定 AAA、AAA),若选“AA + 选定 AAA”则进一步询问具体 AAA 标准 ID。
  2. 平台选择:通过 AskUserQuestion 多选目标平台,并加载对应平台参考文件。
  3. 等级适配、平台感知的审计:按七个类别依次审计——语义与屏幕阅读器、触控目标与拖拽替代、焦点与键盘导航、颜色对比度、文字缩放、动画与动效、表单与认证与帮助。每条发现记录文件路径与大致行号、WCAG 标准 ID + 名称 + 版本、受影响平台、严重程度(CRITICAL / MAJOR / MINOR)、当前行为、预期行为、Flutter 修复的前后对比 diff。完成后按模板生成审计报告。
  4. 修复范围选择:通过 AskUserQuestion 询问修复范围(全部问题、仅严重 + 主要、仅严重、指定发现编号),应用所选修复后确认“已修复 [N] 项发现([严重程度])。[N] 项仍待处理。”

适用场景

适用于需要对 Flutter 应用进行 WCAG 2.2 无障碍合规审计或修复的团队,尤其是跨多平台发布、需要明确合规等级并生成可操作修复建议的项目。

限制

技能要求先确定合规等级与目标平台,不假设 AA。审计与修复仅应用所选等级(及其以下等级)和选定 AAA 标准的规则。参考文件按需加载,不应加载未选平台的文件。具体功能、收费、价格、平台支持范围等以官方资料为准,本介绍未提供的信息暂未提供。