SuperAPI AI 工具集

a11y-knowledge

测试与质量

查看项目

更新于 10-20 14:38

技能介绍

用途

本知识库按 WCAG 2.2 成功标准逐条整理“判断依据”,供无障碍实施、审查和审计技能在需要时读取对应文件。它不自行执行工作,也不复述 WCAG 成功标准的定义或 ARIA 规范内容(假定智能体已知晓这些内容)。

主要能力

每个成功标准文件包含四个部分:

  • Rationale(理由):说明理解文档中哪些部分需要保留,包括术语定义、意图、例外来源等判断所依赖的关键点及相关链接。
  • Judgment lines(判断线):说明如何解读该成功标准,包括不适用情形、例外、常见误判。每条标注为 [Understanding](基于理解文档)或 [Our interpretation](操作性解释)。
  • When building(构建时):说明如何构建以满足判断线,以及应避免什么。
  • When checking(检查时):说明自动化检查能判定什么、还剩什么、哪些不能断言(需保留为“需审查”的条件)。

使用方式

  • 已知成功标准编号时,读取 references/criteria/<编号>.md(例如 references/criteria/1.1.1.md),列表见 references/index-by-criterion.md。
  • 按组件类型查找(编写或审查代码时),使用 references/index-by-component.md,从组件(按钮、链接、图片、对话框等)找到适用的成功标准,再逐个读取文件。
  • 阅读自动化检查结果(axe、@a11y-skills/audit)时,使用 references/checks-axe.md 和 references/checks-audit.md 确认哪些结果已确定、哪些需审查,再读取各成功标准文件中的“When checking”部分。
  • 涉及多页比较的成功标准(3.2.3 / 3.2.4 / 3.2.6,以及 2.4.2 的比较),先阅读 references/cross-page.md 中的共享判断规则。
  • 不要一次性读取全部内容,只读取被询问的成功标准。

使用规则

  • [Our interpretation] 判断线并非 WCAG 的唯一解读方式,项目可自行决定覆盖;若覆盖,需在项目侧记录原因。
  • 不要重新判定自动化检查已确定的结果,只判断尚未确定(需审查)的部分。
  • 无法决定时保留为“需审查”,不要猜测判定为不符合或符合,并写下需要确认什么才能决定。
  • 先写理由,再附上符合理由的结论;不要只写结论再补理由。

内容收录规则

  • 只收录“判断依据”,不复制成功标准原文或完整理解文档。
  • 理解文档的关键点仅限判断所依赖的部分(术语定义、意图、例外来源)。
  • 判断线分开写为基于理解文档([Understanding])和操作性解释([Our interpretation])两类。
  • 记录从测量中学到的误判模式,但不记录测量数字。

适用场景

适用于无障碍实施、代码审查、自动化检查结果解读和审计等场景,帮助智能体在需要时按成功标准编号或组件类型定位判断依据。

限制

该技能自身不执行实施、审查或审计工作,仅作为参考知识库供其他技能读取。它不替代 WCAG 标准原文或 ARIA 规范。资料未提供具体支持的成功标准总数、文件格式细节或与其他工具的集成方式。