关于 severity-mapping
severity-mapping 是用于网页、文档和 Markdown 审计的统一严重性标准,供无障碍审计与报告整理使用。它定义跨领域等级、扣分规则及网页置信度修正方式。
主要功能
- 01四级严重性定义
- 02网页、文档与 Markdown 等级映射
- 03按发现项计算扣分
- 04页面或文件级评分汇总
- 05网页审计置信度修正
适用场景
- 01统一不同审计领域的严重性报告
- 02按一致规则计算页面或文件分数
- 03合并网页扫描结果并去重
- 04根据网页审计置信度调整扣分
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ community-access/ accessibility-agents --skill severity-mapping安装后在 Claude Code 中输入/severity-mapping确认已加载。
详细介绍
严重程度映射
适用于 Web、文档和 Markdown 审计领域的通用严重程度定义。
通用严重程度级别
| 级别 | 定义 | WCAG 一致性 | 分数影响 |
|---|---|---|---|
| Critical | 完全阻碍一个或多个用户群体访问,且没有可行的替代方案。 | 不符合 A 级 | -15 至 -22 分 |
| Serious | 严重影响访问;可能存在替代方案,但并不合理。 | 不符合 A 级或 AA 级 | -5 至 -10 分 |
| Moderate | 造成阻碍或困惑;大多数用户仍能完成任务。 | 不符合 AA 级(建议项) | -2 至 -4 分 |
| Minor | 润色问题;对大多数用户不会造成实质性障碍。 | 技术偏差 | -1 分 |
跨领域对应关系
| 通用级别 | Web(axe-core / Playwright) | 文档(Office/PDF) | Markdown |
|---|---|---|---|
| Critical | critical(axe-core) | 缺少文档标题;PDF 未加标签;缺少标题结构 | 锚点链接失效,导致导航无法使用 |
| Serious | serious(axe-core) | 信息性图片缺少替代文本;表格没有表头 | 链接文本含义不明确(例如“点击此处”);图片缺少替代文本 |
| Moderate | moderate(axe-core) | 合并的表格单元格;仅用颜色编码数据 | 跳过标题级别;缺少表格说明 |
| Minor | minor(axe-core) | 装饰性图片包含非空替代文本;冗余书签 | 标题中使用表情符号;使用 em 短横线作为列表分隔符 |
分数影响规则
上述分数影响按每项发现累加。同一问题在多个元素中重复出现时:
- 首次出现 — 扣除全部分值
- 相同问题类型,位于同一页面/文件 — 不再额外扣分(根据每项问题只计一次的规则,该问题已计入)
- 相同问题类型,位于不同页面/文件 — 对新页面/文件的分数再次扣除全部分值
转换规则(规范化跨领域报告)
生成合并 Web、文档和 Markdown 发现的统一报告时:
- 使用上表将每项发现映射到通用严重程度级别。
- 根据通用级别应用分数影响,而不是采用特定领域工具的内部评分。
- 对于汇总分数(组合或项目级别),分别计算每个页面/文件的分数,然后取平均值。
- 如果某项发现同时出现在 axe-core 扫描和 Playwright 行为扫描中,请勿重复计数——按规则 ID 和元素位置去重。
置信度修正系数(Web 领域)
对于 Web 审计,置信度会影响基础扣分:
| 置信度 | 倍数 | 来源信号 |
|---|---|---|
| 已确认 | 1.2x | axe-core + Agent 代码审查 + Playwright 行为测试 |
| 高(两个来源) | 1.0x | 上述三个来源中的任意两个 |
| 高(一个来源) | 1.0x(降低基础扣分) | 单个自动化工具,规则可靠性高 |
| 中 | 0.7x | 单一来源,规则可靠性中等 |
| 低 | 0.3x | 单一来源,规则可靠性较低或基于启发式方法 |
文档和 Markdown 审计不使用置信度倍数——仅使用基础分数影响。
评论
支持 Markdown