mcpField
A
accessibility-debt-tracking

accessibility-debt-tracking

github.com/owl-listener测试与质量10872 次安装20 周前更新
代码仓库

关于 accessibility-debt-tracking

用于将已知无障碍问题作为债务记录和管理的技能,涵盖严重程度、负责人、期限与分级处理规则,适合需要安排修复优先级并防止回归的团队。

主要功能

  1. 01结构化记录无障碍问题
  2. 02按严重程度设定修复期限
  3. 03分级处理与升级规则
  4. 04预防新增债务的实践
  5. 05无障碍回归跟踪指引

适用场景

  1. 01记录审计后暂缓处理的问题
  2. 02按严重程度和受影响用户排列修复优先级
  3. 03分配负责人和修复期限
  4. 04跟踪反复出现的无障碍回归

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/owl-listener/inclusive-design-skills --skill accessibility-debt-tracking

安装后在 Claude Code 中输入/accessibility-debt-tracking确认已加载。

详细介绍

无障碍债务跟踪

像跟踪技术债务一样跟踪无障碍债务——将其视为一种已知负担,其成本会随着时间推移不断增加。

什么是无障碍债务

无障碍债务是指产品中存在但尚未修复的所有已知无障碍问题,包括:

  • 审计中发现但被降低优先级的问题
  • 延后处理无障碍问题的取舍
  • 未充分考虑无障碍需求就发布的新功能
  • 更新或重新设计引入的回归问题
  • 已知的辅助技术支持缺口

为什么无障碍债务会不断增加

与只需等待处理的功能请求不同,无障碍债务会不断增加:

  • 在无法访问的基础上构建的每项新功能都会继承其无障碍缺陷
  • 残障用户会形成变通方法,而当你最终以不同于他们预期的方式修复问题时,这些方法就会失效
  • 随着时间推移和公众认知提高,法律风险会增加
  • 问题持续的时间越长,修复成本就越高(围绕它构建的代码越来越多)
  • 团队对问题存在原因的了解会逐渐淡化

债务记录格式

对于每个已知的无障碍问题,请跟踪以下信息:

问题: 对无障碍障碍的清晰描述 严重程度: 严重(阻碍任务)/ 重大(造成明显困难)/ 轻微(造成不便) 受影响人群: 具体的用户群体 位置: 页面、组件或流程 WCAG 标准: 违反了哪些成功标准 发现时间: 日期及发现方式(审计、用户报告、测试) 延期原因: 未立即修复的原因 变通方法: 为受影响用户提供的任何临时替代方案 预计修复工作量: 小 / 中 / 大 修复期限: 必须修复的时间 负责人: 负责修复的人

管理债务

分级规则
  • 严重(阻碍任务): 必须在当前冲刺中修复,不得例外
  • 重大(造成明显困难): 在 30 天内修复
  • 轻微(造成不便): 在 90 天内修复
  • 超过期限仍未解决的问题必须升级处理
防止新增债务
  • 为每个用户故事设定无障碍验收标准
  • 合并前进行无障碍检查(自动化 + 手动)
  • 对已修复的问题进行回归测试
  • 新功能不得带着严重无障碍债务上线
偿还债务
  • 每个冲刺划拨一定比例的时间用于减少债务(常见比例为 10–20%)
  • 修改组件时顺便修复相关债务
  • 按以下因素确定优先级:严重程度 × 受影响用户数量
  • 庆祝债务减少,让成果清晰可见
跟踪回归问题
  • 之前已修复的问题再次出现时,即为回归问题
  • 默认应将回归问题视为严重问题
  • 为每项修复添加自动化测试,防止问题再次出现
  • 将回归率作为质量指标进行跟踪

评估问题

  1. 是否有记录在案的已知无障碍问题清单?
  2. 每个问题是否都有严重程度、负责人和期限?
  3. 每个冲刺是否都在偿还无障碍债务?
  4. 是否能发现回归问题并将其视为严重问题?
  5. 无障碍债务趋势是在改善还是在恶化?

评论

支持 Markdown