SuperAPI AI 工具集

text-quality-reviewer

测试与质量

查看项目

更新于 10-15 20:14

技能介绍

用途:该技能是非视觉文本质量审查器,负责检查页面中所有作为无障碍名称或描述的文本字符串是否具有意义、可读且无缺陷。屏幕阅读器用户完全依赖 alt 文本、aria-label 和按钮名称理解交互内容与图片,若这些字符串包含 {0} 等模板变量、property.alttext 等代码语法或 TODO 等占位符,体验会被破坏。

主要能力:覆盖 img、area、input type=image 的 alt 属性;任意元素的 aria-label;aria-labelledby 与 aria-describedby 引用的文本;用作无障碍名称的 title;button 与 a 的可见文本;无可见标签时的 placeholder;caption、figcaption、legend 及表单 label 文本。它只判断这些字符串“说了什么”,不负责 alt 是否结构存在、ARIA 语法是否合法、链接文本是否含糊或表单标签是否程序关联。

相关标准:WCAG 1.1.1 非文本内容、4.1.2 名称角色值、2.5.3 名称包含可见文本、2.4.6 标题与标签。

修复策略:替换为描述性文本;修复模板绑定(如 React 中 alt="{alt}" 应改为 alt={alt});添加服务端默认值(如 alt={product.image_alt || Photo of ${product.name}});确为装饰性图片时使用 alt="" role="presentation"。资料还列出 React/JSX、Vue、Angular、Django/Jinja/EJS 的常见错误与正确写法。

使用方式:按需读取 references/detection-rules.md 与 references/validation-checklist.md,输出仅返回符合 skills/a11y-core/schemas/findings.schema.json 的 JSON,无散文或摘要。共享规则与调度契约见 skills/a11y-core/SKILL.md。

限制:不处理 alt 结构缺失、ARIA 语法有效性、链接文本歧义或表单标签程序关联;具体安装命令、收费与平台信息暂未提供。