关于 accessibility-debt-tracking
用于将已知无障碍问题作为债务记录和管理的技能,涵盖严重程度、负责人、期限与分级处理规则,适合需要安排修复优先级并防止回归的团队。
主要功能
- 01结构化记录无障碍问题
- 02按严重程度设定修复期限
- 03分级处理与升级规则
- 04预防新增债务的实践
- 05无障碍回归跟踪指引
适用场景
- 01记录审计后暂缓处理的问题
- 02按严重程度和受影响用户排列修复优先级
- 03分配负责人和修复期限
- 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%)
- 修改组件时顺便修复相关债务
- 按以下因素确定优先级:严重程度 × 受影响用户数量
- 庆祝债务减少,让成果清晰可见
跟踪回归问题
- 之前已修复的问题再次出现时,即为回归问题
- 默认应将回归问题视为严重问题
- 为每项修复添加自动化测试,防止问题再次出现
- 将回归率作为质量指标进行跟踪
评估问题
- 是否有记录在案的已知无障碍问题清单?
- 每个问题是否都有严重程度、负责人和期限?
- 每个冲刺是否都在偿还无障碍债务?
- 是否能发现回归问题并将其视为严重问题?
- 无障碍债务趋势是在改善还是在恶化?
评论
支持 Markdown