mcpField
A
accessibility-testing

accessibility-testing

github.com/naodeng测试与质量29188 次安装1 天前更新
代码仓库

关于 accessibility-testing

面向需要执行、评审或跟进无障碍测试的项目团队,提供可操作的检查与结果组织方法。它要求结合 WCAG 目标、辅助技术和证据记录,并区分未执行、失败与扫描未发现问题。

主要功能

  1. 01记录 WCAG 版本、等级与范围
  2. 02覆盖键盘、读屏和人工视觉检查
  3. 03按成功标准整理证据与结果
  4. 04区分 FAIL、NOT_RUN 与扫描结果
  5. 05按风险和业务影响排序

适用场景

  1. 01检查键盘导航与焦点行为
  2. 02验证读屏语义和动态更新
  3. 03整理无障碍测试证据与缺口

安装

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

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill accessibility-testing

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

output-formats.md
quick-start.md
README.md
agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-success.yaml
domain-method-regression.yaml
edge-domain-boundary.yaml
edge-incomplete-input.yaml
evals/fixtures/
check_domain_decisions.py
check-domain-decisions.sh
domain-oracle.json
examples/axe-playwright/
.gitignore
package.json
playwright.config.ts
README.md
tsconfig.json
examples/axe-playwright/tests/
forms.spec.ts
homepage.spec.ts
login.spec.ts
modal.spec.ts
navigation.spec.ts
examples/axe-playwright/utils/
axe-helper.ts
output-templates/
template-csv.csv
template-excel.tsv
template-json.json
template-markdown.md
template-word.md
template-xmind.md
prompts/
accessibility-testing.md

详细介绍

原文在翻译后有更新,译文可能不是最新。

无障碍测试(英文)

中文版: 请参阅对应的中文技能。

适用场景

  • 需要在真实项目情境中获得无障碍测试方面的帮助。
  • 需要可直接用于执行、评审或后续跟进的输出。

工作流

  1. 阅读并遵循渐进式披露部分列出的主提示词(覆盖范围、结构、质量标准)。
  2. 只补充会影响结果的项目背景:范围、环境、约束、风险、依赖项、预期交付物。
  3. 如果输入不完整,先提供可用的初稿,并明确标记假设和信息缺口。
  4. 默认使用 Markdown;只有用户提出要求时才切换格式。

领域执行要点

  1. 记录项目指定的 WCAG 版本/级别、范围和成功准则 ID。缺少的目标保持未确定状态;切勿默认选择级别或声称符合标准。
  2. 建立“准则 ID | 用户任务/状态 | 输入方式/辅助技术/版本 | 步骤 | 证据类型 | 结果”表。自动化扫描、键盘、屏幕阅读器和人工视觉证据应分别记录。
  3. 测试键盘导航、打开、操作、关闭和焦点恢复。检查屏幕阅读器的名称/角色/状态及动态播报。根据用户影响优先处理无法访问的关键操作。
  4. 扫描结果为零只能证明已扫描部分的结果。保留人工测试的 FAIL 和未执行的 NOT_RUN;按准则汇总证据,但不得将部分扫描结果提升为符合标准的结论。

核心约束

  • 按风险/业务影响确定优先级,不要一视同仁。
  • 将已确认事实与当前假设分开。
  • 不要编造用户未提供的端点、字段、环境或根本原因。
  • 确保输出可执行:场景具体、优先级明确、后续步骤清晰。

渐进式披露

  • 校准领域结果、有效控件或证据缺口时,请阅读 references/domain-decision-example.md,了解脱敏输入、逐项判断基准和可复现的计算。

  • 生成输出前,请阅读并遵循 prompts/accessibility-testing.md(最低覆盖范围、输出结构、质量标准)。

  • 用户要求 Excel/CSV/JSON/Word 时:请阅读 output-formats.md 并遵循对应格式。

  • 有合适的现成模板时:使用 output-templates/ 下匹配的文件。

  • 对于深入的框架/故障排查/架构说明:只阅读 references/ 下相关文件,不要加载整个目录。

  • 对于格式转换或辅助检查:优先使用现有的 scripts/,不要重复造轮子。

  • 对此技能进行评估/回归测试:使用 skill-up 配合 evals/。

交付前检查清单

  • 遵循了主提示词的输出结构
  • 最低覆盖重点:范围和目标用户、键盘访问、焦点顺序和可见焦点、屏幕阅读器语义和标签、标题和地标、表单错误和验证反馈、颜色对比度和非颜色提示、图像、图标和替代文本……(详见主提示词)
  • 覆盖了最低检查清单,或说明了未覆盖项
  • 高风险项目有明确的优先级
  • 未编造用户未提供的细节
  • 已标记假设和信息缺口

常见陷阱

  • 范围/背景缺失时,不要假装内容完整。
  • 不要将所有项目视为同等重要。
  • 不要忽略假设和信息缺口。
  • 不要堆砌与当前工具链无关的通用理论。

评论

支持 Markdown