mcpField
S
severity-mapping

severity-mapping

github.com/community-access测试与质量42977 次安装今天更新
代码仓库

关于 severity-mapping

severity-mapping 是用于网页、文档和 Markdown 审计的统一严重性标准,供无障碍审计与报告整理使用。它定义跨领域等级、扣分规则及网页置信度修正方式。

主要功能

  1. 01四级严重性定义
  2. 02网页、文档与 Markdown 等级映射
  3. 03按发现项计算扣分
  4. 04页面或文件级评分汇总
  5. 05网页审计置信度修正

适用场景

  1. 01统一不同审计领域的严重性报告
  2. 02按一致规则计算页面或文件分数
  3. 03合并网页扫描结果并去重
  4. 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
Criticalcritical(axe-core)缺少文档标题;PDF 未加标签;缺少标题结构锚点链接失效,导致导航无法使用
Seriousserious(axe-core)信息性图片缺少替代文本;表格没有表头链接文本含义不明确(例如“点击此处”);图片缺少替代文本
Moderatemoderate(axe-core)合并的表格单元格;仅用颜色编码数据跳过标题级别;缺少表格说明
Minorminor(axe-core)装饰性图片包含非空替代文本;冗余书签标题中使用表情符号;使用 em 短横线作为列表分隔符

分数影响规则

上述分数影响按每项发现累加。同一问题在多个元素中重复出现时:

  • 首次出现 — 扣除全部分值
  • 相同问题类型,位于同一页面/文件 — 不再额外扣分(根据每项问题只计一次的规则,该问题已计入)
  • 相同问题类型,位于不同页面/文件 — 对新页面/文件的分数再次扣除全部分值

转换规则(规范化跨领域报告)

生成合并 Web、文档和 Markdown 发现的统一报告时:

  1. 使用上表将每项发现映射到通用严重程度级别。
  2. 根据通用级别应用分数影响,而不是采用特定领域工具的内部评分。
  3. 对于汇总分数(组合或项目级别),分别计算每个页面/文件的分数,然后取平均值。
  4. 如果某项发现同时出现在 axe-core 扫描和 Playwright 行为扫描中,请勿重复计数——按规则 ID 和元素位置去重。

置信度修正系数(Web 领域)

对于 Web 审计,置信度会影响基础扣分:

置信度倍数来源信号
已确认1.2xaxe-core + Agent 代码审查 + Playwright 行为测试
高(两个来源)1.0x上述三个来源中的任意两个
高(一个来源)1.0x(降低基础扣分)单个自动化工具,规则可靠性高
中0.7x单一来源,规则可靠性中等
低0.3x单一来源,规则可靠性较低或基于启发式方法

文档和 Markdown 审计不使用置信度倍数——仅使用基础分数影响。

评论

支持 Markdown