技能 wcag-audit-patterns
📦

wcag-audit-patterns

安全

审计网站是否符合 WCAG 2.2 无障碍标准

也可从以下获取: wshobson

在没有结构化指导的情况下,手动无障碍审计既缓慢又容易出错。此技能提供系统化的 WCAG 2.2 检查清单、自动化测试集成以及经过验证的修复模式。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“wcag-audit-patterns”。 审计我的导航菜单是否存在无障碍问题

预期结果:

发现 4 个 WCAG 违规:缺少跳过链接 (2.4.1 A)、下拉菜单中存在键盘陷阱 (2.1.2 A)、缺少 aria-expanded 状态 (4.1.2 A) 以及焦点指示器对比度不足 (2.4.7 AA)。修复后的导航代码包含跳过链接、正确的焦点陷阱、ARIA 状态以及对比度为 4.5:1 的 3px 实线焦点轮廓。

正在使用“wcag-audit-patterns”。 修复登录表单上的颜色对比度错误

预期结果:

原始灰色文本 (#888888) 在白色背景上的对比度为 2.8:1。已更新为 #595959 以达到 4.5:1 AA 合规。错误状态现在使用红色 (#D32F2F) 并配合图标和文本消息,而非仅使用颜色。焦点指示器已更改为 3px 蓝色轮廓,在 4.6:1 对比度下可见。

安全审计

安全
v1 • 2/25/2026

Static analyzer flagged 76 patterns but all are false positives. The skill contains Markdown documentation with code examples, not executable code. Detected backticks are markdown fences, URLs are reference links, and no actual shell execution, network calls, or credential access exists.

2
已扫描文件
586
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

电商无障碍审计

在产品发布前审计在线商店是否符合 WCAG 2.2 AA 标准。对关键页面运行自动扫描,对结账流程执行手动键盘测试,并修复关键障碍,如缺失的表单标签和键盘陷阱。

政府网站合规

审查公共部门网站是否符合 Section 508 和 ADA 标准。记录所有违规项,按用户影响优先级排序,并提供符合联邦无障碍标准的修复代码。

无障碍诉讼修复

通过审计被引用的页面、识别所有 WCAG 违规项并实施修复,同时��法律抗辩提供文档证据,来回应无障碍要求信。

试试这些提示

快速无障碍扫描
审计我网站首页的 WCAG 2.2 A 级违规。列出发现的所有问题,解释每个问题为何违反 WCAG,并为每个问题提供修复后的代码示例。
组件无障碍审查
审查我的自定义下拉菜单组件是否存在无障碍问题。检查键盘导航、焦点管理、ARIA 属性和屏幕阅读器兼容性。提供通过 WCAG 2.2 AA 标准的修正代码。
全站 WCAG 2.2 AA ��计
对我的电商网站进行完整的 WCAG 2.2 AA 审计。包括使用 axe-core 的自动化测试设置、键盘和屏幕阅读器流程的手动测试清单,以及针对所有违规的优先修复计划和代码修复。
颜色对比度和视觉无障碍
分析我的设计系统颜色是否符合 WCAG 2.2 对比度标准。测试常规和大型文本的所有文本-背景组合,检查 UI 组件对比度,并建议在保持品牌标识的同时符合无障碍要求的颜色替代方案。

最佳实践

  • 在设计阶段而非开发之后开始无障碍测试
  • 在添加 ARIA 属性之前优先使用语义化 HTML 元素
  • 在发布前使用仅键盘模式和至少一种屏幕阅读器进行测试

避免

  • 仅依赖自动化测试工具而不进行手动验证
  • 为视觉设计偏好隐藏焦点轮廓
  • 仅使用颜色作为错误或必填字段的唯一指示符

常见问题

我的网站应该达到什么 WCAG 级别?
大多数法规要求符合 WCAG 2.2 AA 级,包括 ADA 诉讼、Section 508 和欧盟无障碍法律。AAA 级建议针对特定受众,但 AA 级是大多数组织的法律基准。
自动化工具能捕获所有无障碍问题吗?
不能。自动化工具只能检测 30-50% 的无障碍问题。键盘导航、焦点顺序、屏幕阅读器流程和认知无障碍的手动测试需要人工评估。
我需要让整个网站无障碍,还是只需要关键页面?
所有面向公众的页面都应无障碍。法院已拒绝部分合规的抗辩。优先考虑高流量页面和用户旅程(如结账),但规划全站修复。
我应该多久重新审计网站的无障碍性?
每次主要版本发布后、添加新组件时,对于活跃网站至少每季度一次。无障碍回归通常在常规更新和功能添加期间发生。
ARIA 和语义化 HTML 有什么区别?
语义化 HTML 使用 button、nav 和 main 等具有内置无障碍功能的原生元素。ARIA 为自定义元素添加无障碍元数据。始终优先使用语义化 HTML,仅当原生元素无法实现所需行为时才使用 ARIA。
即使我正在修复无障碍违规,我仍然可以被起诉吗?
可以。持续的修复不是法律抗辩。但是,记录的善意努力和公开的无障碍声明可以减少损害。优先阻止任务完成的关键障碍。