跳转到使用指南
Accessibility Audit作者 Alireza Rezvani

Accessibility Audit Skill.

将每项无障碍问题与受影响的元素、建议的修复方案和验证结果关联起来。

  • 无障碍
  • 设计审查
  • 前端
源代码审查 · Accessibility AuditSKILL.md
任务 无障碍 产出内容 • 按严重程度排序的无障碍问题报告 • 适合项目所用框架的修复前后代码 • 与初始问题的对比,以及仍需人工检查的项目清单 开始之前 需要用于运行随附工具的 Python、源代码访问权限,以及用于情境验证的浏览器或辅助技术环境。
编辑摘要 · 已审查源代码 2026-10-07 · 非生成示例

01 功能说明

将无障碍问题转化为可验证的修复

一种包含 Python 实用工具、框架参考资料和报告模板的无障碍扫描、修复与验证工作流。

基于源代码的工作流并非执行基准测试结果

工作方法

A11y Audit 将无障碍工作分为扫描、修复和验证阶段。源代码包含 Python 扫描器与对比度检查器接口、严重程度分类,以及针对不同框架的修复参考资料。它可以帮助将笼统的无障碍改进请求转化为范围明确的元素清单和代码变更。

源代码描述了广泛的 WCAG 覆盖范围,但不应将代码扫描表述为完整的合规认证。键盘操作流程、屏幕阅读器行为、动态内容以及替代文本是否实用,仍需结合具体情境进行审查。其实际价值在于可追溯性:保留初始问题,应用适当的原生语义或样式变更,然后重新运行检查并测试实际交互。

预期交付物

  • 按严重程度排序的无障碍问题报告
  • 适合项目所用框架的修复前后代码
  • 与初始问题的对比,以及仍需人工检查的项目清单
查看示例任务简述

从任务简述到审查

  1. 01
    扫描明确的范围

    确定所用框架及相关源代码路径。记录元素级问题,并区分扫描器检测结果与人工观察结果。

  2. 02
    修复底层交互

    优先使用原生控件、有意义的标签和清晰可见的焦点,而不是不加区分地添加 ARIA 属性。

  3. 03
    在实际情境中验证

    与基线进行比较,在渲染状态下检查对比度,并实际测试静态分析无法确认的键盘和辅助技术操作路径。

02 适用场景

适用场景

需要用于运行随附工具的 Python、源代码访问权限,以及用于情境验证的浏览器或辅助技术环境。

适合的用途

  • 修复规划适合将一系列源代码层面的问题转化为经过排序、可供审查的代码变更。
  • 回归检查适合需要在现有测试流程中加入可重复无障碍检查的项目。

需要核查的限制

  • 不提供合规证书通过随附工具的检查,并不能证明整个产品满足所有适用的无障碍要求。
  • 严重程度需结合情境判断源代码中的严重程度标签是分类处置的辅助依据。对真实用户的影响取决于具体元素、任务和可用的替代方式。

请提供这些输入

  • 审查范围说明要审查的页面、组件或源代码目录,以及相应的用户操作流程。
  • 渲染状态提供对表单、错误、对话框以及简单静态页面中不会出现的其他状态的访问方式。
  • 现有基线提供以往的问题记录或测试结果,以便区分已解决的问题和回归问题。

03 关键决策

关键决策

  1. 确保修复可追溯

    修复前后示例会将问题与具体实现关联起来,而不是只留下标准条款引用。

  2. 自动化有其边界

    一份实用的报告应明确说明扫描了哪些内容、人工测试了哪些内容,以及哪些内容仍未验证。

04 示例任务

尝试聚焦的任务简述

以下示例任务简述尚未经过测试。使用前请检查该技能的配置要求。

审查配置

保留这些脚本和参考模式。将扫描器结果用作发布门禁前,请先审查其覆盖范围。

上游源文件
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md

需要用于运行随附工具的 Python、源代码访问权限,以及用于情境验证的浏览器或辅助技术环境。

从一项交付物开始

运行该技能前,请根据需要调整这份任务简述的范围、源材料和约束条件。

示例任务简述
使用 a11y-audit 审查我们的结账表单和模态框。先生成一份只读的问题报告,其中包括受影响的元素及严重程度判定依据。检查标签、原生控件、焦点可见性和对比度,然后列出需要人工执行的键盘和屏幕阅读器检查。不要仅根据扫描器结果宣称该页面符合 WCAG,也不要在我批准前应用修复。

检查结果

根据以下可观察的标准检查实际输出。

  • 每项问题都应指明真实元素和可执行的修正措施。
  • 已解决的问题应依据原始基线重新检查。
  • 未经测试的键盘、屏幕阅读器和动态状态行为仍应明确标记为未验证。

OpenDesign 为编码智能体提供本地设计工作区。此页面列出该技能,并不表示它已被捆绑提供,也不表示其中包含其外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定源代码修订版本。上游行为和要求可能会发生变化。

来源所有者
Alireza Rezvani
许可证
MIT
已审查的快照
2026-10-07 · 19392f7a0826
编辑来源摘要
一种包含 Python 实用工具、框架参考资料和报告模板的无障碍扫描、修复与验证工作流。

由 OpenDesign 根据所链接的源代码撰写的原创摘要。代码仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前的问题

扫描器能否证明符合 WCAG?

不能。该技能可以辅助审查,但自动化源代码检查无法覆盖所有需要结合情境或交互判断的要求。

它是否只支持 React?

源代码包含适用于多种 Web 框架和原生 HTML 的模式。请核实实际扫描器和参考资料是否支持项目使用的版本。

是否应该为每个可点击元素添加 ARIA 角色?

不应自动这样做。源代码通常优先采用原生语义控件,因为它们提供的行为并非仅添加 ARIA 角色就能实现。

OpenDesign

为下一轮设计迭代留出空间。

将任务简述、源材料和设计工作集中保存在本地工作区中。将该技能加入工作流前,请先检查其自身的配置要求。

上游源文件
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md