mcpField
A
audit-stories

audit-stories

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

关于 audit-stories

用于审查现有用户故事中的无障碍缺项,并把具体验收标准补入原故事,而非另建无障碍工单。流程覆盖多种输入、感官与认知需求,并输出逐项审查报告。

主要功能

  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 audit-stories

安装后在 Claude Code 中输入/audit-stories确认已加载。

详细介绍

审查用户故事中的包容性

审查现有的用户故事,找出其中忽视残障人士和能力多样性的地方——然后补充缺失的验收标准,不要单独创建无障碍工单。

流程

步骤 1:收集用户故事

收集要审查的用户故事。可以是一个冲刺待办列表、某项功能的完整故事集,或一个史诗。

步骤 2:逐个检查故事

使用 inclusive-user-stories,检查每个故事的验收标准是否涵盖:

  • 键盘可操作性
  • 屏幕阅读器支持
  • 视觉无障碍(对比度、无需依赖颜色、缩放)
  • 运动无障碍(目标尺寸、时限、精确度)
  • 认知无障碍(通俗易懂的语言、错误恢复、撤销)

标记缺少上述一项或多项内容的故事。

步骤 3:检查假设偏见

使用 edge-case-identification,针对每个故事提出以下问题:

  • 该故事假设用户使用什么输入方式?
  • 该故事假设用户具备什么感官能力?
  • 该故事假设用户具备什么认知能力?
  • 该故事假设用户处于什么情境?
  • 有哪些被忽略的“边缘情况”,实际上是部分用户的日常现实?
步骤 4:补充缺失的验收标准

针对每个被标记的故事,写出需要补充的具体验收标准。不要创建单独的故事——直接添加到现有故事中。

输出

提交一份审查报告:

  1. 摘要——已审查的故事数量、存在缺漏的故事数量,以及最常见的缺漏类型
  2. 逐个故事的审查结果——列出每个故事及其缺失的验收标准
  3. 新增的验收标准——列出每个故事需要补充的具体验收标准,可直接粘贴到待办列表中
  4. 规律——指出表明存在系统性问题的反复缺漏(例如:“本次冲刺中没有任何故事提及键盘访问”)

评论

支持 Markdown