SuperAPI AI 工具集

check-accessibility

设计与创作

查看项目

更新于 10-16 01:14

技能介绍

用途:这是一个面向 Azure 技术文档的图片无障碍检查器,用于按 Microsoft Learn 标准审查文档中的图片标记,适合在需要复核图片替代文本(alt text)、灯箱(lightbox)路径或复杂图片标记时使用。

主要能力(按优先级):一是检查通用替代文本,替代文本应描述图片内容而非仅写类型,如 alt-text="Diagram"、"Screenshot"、"Image" 属于不合格,而 alt-text="Diagram that shows the network topology for Azure Arc." 合格;需注意以图片类型开头本身是正确风格(如 "Diagram that shows..."、"Screenshot of..."),仅当类型标签后没有任何描述时才标记问题。二是检查替代文本标点,必须以句号结尾。三是检查灯箱路径不匹配,存在 lightbox 时其路径必须与 source 路径一致,如 source="./media/arch.png" lightbox="./media/arch.png" 合格,lightbox="./media/other.png" 不合格。四是复杂图片,含多个流向的架构图、决策树或数据流图应使用 type="complex" 并在 :::image 与 :::image-end::: 标签之间提供长描述;仅当替代文本试图把多句描述塞进 alt-text 属性时才标记。

图片格式:标准为 :::image type="content" source="path" alt-text="Description." lightbox="path" border="false":::;复杂为 :::image type="complex" source="path" alt-text="Brief summary."::: Detailed description. :::image-end:::。

限制与使用约束:无法查看图片,只能评估文本属性;不要凭空编造描述,若替代文本过于通用(如 "Screenshot")可从周围段落和标题上下文推导描述,无上下文则跳过;不要标记已合规的图片;每份文档最多报告 8 处修复,按最严重者优先。需忽略:YAML 元数据块、URL、文件路径、代码块、反引号内容、Markdown 图片语法(,仅检查三冒号语法)以及 type="icon" 图片(其替代文本有意保持极简)。