1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | accessibility-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI(原 LambdaTest) |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/accessibility-skill |
| 许可证 | MIT(数据来自 GitHub API) |
| GitHub Stars | 352(数据来自 GitHub API;为整个合集仓库总量,不代表本技能自身热度) |
| Forks | 69(数据来自 GitHub API,同为合集整体口径) |
| 最新版本 | 1.0(SKILL.md front matter 自述) |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
这是一个把 WCAG 无障碍扫描能力接入已有自动化测试套件 的技能:不需要额外装一个独立的无障碍工具,只需在现有 Selenium、Playwright、Cypress 或 Appium 驱动上打开一个 capability 开关,测试运行时就能对渲染后的页面做扫描,结果汇总到云端 Dashboard。
- 框架无关,一次覆盖四类自动化:Selenium、Playwright、Cypress(Web)与 Appium(原生移动 App)各有一套对应的接入代码,浏览器扫描依赖内置 Chrome 扩展(需 Chrome/Edge 90+),移动端走 driver 脚本钩子。
- 诚实标注自身局限:文档明确写出“自动化扫描只能覆盖 WCAG 成功准则中的三分之一到一半”,把结果分为 violations(违规)、passes(通过)、incomplete(需人工复核)三类,并列出一张“可自动判定 vs 需人工/屏幕阅读器验证”的对照清单——不会把“0 issues”包装成“完全无障碍”。
- 规则到修复的完整映射:附一张 15 条常见规则对 WCAG 条款、严重度、具体修复方式的速查表(如对比度、焦点顺序、ARIA 命名等),扫描发现问题后能直接对照着改代码。
- 承认关键短板并给出解法:默认的自动化路径没有结果 API、没有退出码,无法直接拿来做 CI 门禁;文档如实指出这一点,并给出配套的 Accessibility MCP Server(
getAccessibilityReport等三个工具)作为可编程读取结果的路径。 - 纯参考文档形态:子目录内只有 SKILL.md 与一份
reference/playbook.md,不含任何可执行脚本或模板文件。 - 本子目录 2026-07-24 才加入仓库,是同仓库 72 个测试技能中最新提交的几个之一。
3. 适用场景
所属分类:工程效率与代码质量
典型场景是团队已经有一套跑在 Selenium/Playwright/Cypress/Appium 上的自动化测试,想把无障碍合规检查纳入日常测试执行与 CI 回归,而不是另开一条人工审计流程;也适用于移动 App 团队想为原生页面加一层自动化的 WCAG 覆盖检测。受益人群是负责维护自动化测试套件、需要对无障碍合规负责的 QA 工程师与 SDET。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式(YAML front matter + 指令正文),仓库 README 给出配套的官方安装工具。
- Codex:❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, Copilot, Cursor, Gemini CLI”,未点名 OpenAI Codex,暂无更多官方材料可确认。
- OpenClaw:❓ 未验证——已抓取材料未提及。
- Hermes Agent:❓ 未验证——已抓取材料未提及。
5. 推荐理由
给已经在跑自动化测试的团队一条低成本接入无障碍检测的路径:不用额外选型、部署一套新工具,只是在现有测试代码里打开一个 capability 开关。技能本身诚实标注了自动化扫描的覆盖边界与“无结果 API”的限制,并给出配套的 MCP Server 路径应对 CI 门禁场景,比含糊宣称“全自动无障碍合规”的方案更可信。子目录本身不含任何脚本,安全面干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI(原 LambdaTest)是一线云测试平台,累计融资 1.08 亿美元(含 2026 年由 Avataar Ventures 领投、Qualcomm Ventures 参投的 3800 万美元一轮,TechCrunch 有报道),服务 15,000+ 企业客户、230 万+ 用户;无障碍测试是其官网列出的核心产品线之一。合集仓库整体 352 stars,该数字属整个合集,不代表本技能自身热度,也未查到本技能自身的独立第三方讨论 |
| 可用性 | 8 | 接入步骤清晰(开关 + 可选精细化参数),单份 playbook 含完整能力表、严重度体系、规则修复速查表;子目录 2026-07-24 才加入仓库,明显新于同仓库内多数在 2026-02 批量导入的姊妹技能。使用前需要一个 TestMu AI 账号(含免费额度)取得 LT_USERNAME/LT_ACCESS_KEY,云端 HyperExecute 路径的无障碍能力还需联系支持开通,未达到零配置即用 |
| 安全性 | 9 | 子目录内不含任何脚本或可执行文件,仅 SKILL.md 与一份 Markdown 参考文档;凭据通过标准环境变量传递,未见硬编码;Playwright 路径会加载一个具名 Chrome 扩展 ID 用于扫描,行为在文档中公开说明,无隐藏或混淆指令;License(MIT)明确 |
安全检查清单:
① Shell 命令执行——无,子目录不含 scripts/ 或 templates/,没有可执行文件;
② 联网外发数据——扫描结果回传至用户自己的 TestMu AI Dashboard 账号,属技能声明用途内的预期行为,未见其他外发;
③ API key/凭据——需要 LT_USERNAME/LT_ACCESS_KEY,文档要求以环境变量方式设置,存储方式清晰;
④ 可疑指令——未发现,内容为标准 Markdown 表格、代码示例与能力说明,无隐藏指令或混淆代码;
⑤ 作者/组织信誉——TestMu AI(原 LambdaTest),累计融资 1.08 亿美元、获 TechCrunch 报道、15,000+ 企业客户,信誉良好;
⑥ License——MIT,明确;
⑦ 最近维护——本子目录 2026-07-24 有最后一次提交,为同仓库内维护最新的技能之一,未见归档迹象。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| accessibility-addyosmani-web-quality-skills | 对照 WCAG 逐条给出前端源码(HTML/ARIA/CSS)修复代码,纯静态审查 | 面向“写代码时”的源码级审查,不接入测试执行链路,不产出可回归的自动化检测结果 |
| accessibility-audit-webflow-webflow-skills | Webflow 官方无障碍审计,headless 连接 Webflow MCP 扫描站点结构 | 局限于 Webflow 平台构建的站点,服务对象是 Webflow 用户而非通用自动化测试套件 |
| better-accessibility-jakubkrehel-skills | 编码习惯层面的无障碍检查清单,覆盖键盘/ARIA/表单等七大主题 | 面向开发者手动走查交互流程,不接入任何自动化测试执行或 CI 回归 |
上述三者共同点是都在“写代码 / 审代码”阶段介入,帮开发者在提交前发现并修复无障碍问题;本技能介入的阶段不同——它把 WCAG 扫描做成测试执行时的一个步骤,接在已有的 Selenium/Playwright/Cypress/Appium 自动化之后,对渲染完成的真实页面做运行时检测,产出可以在每次 CI 跑测试时重复触发的回归结果。两类工具解决的是无障碍工程流水线里不同的环节,可以搭配使用而非互相替代。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
- 支持语言:JavaScript、TypeScript、Java(覆盖 Selenium/Playwright/Cypress/Appium 各自的主流语言绑定)。
- 无障碍评分采用官方公开的加权公式(按 Critical/Serious/Moderate/Minor 四档严重度加权计算 0–100 分),评分逻辑在文档中完整披露,非黑箱。
- 移动端(原生 App)补充了 Android(
contentDescription、TalkBack)与 iOS(accessibilityLabel、VoiceOver)专属的检测点与触控目标尺寸标准(Android 48dp / iOS 44pt)。
10. 安装使用方式
方式一:官方 CLI(仓库推荐)
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill accessibility-skill
方式二:手动复制(本技能不含任何脚本,直接复制目录即可,无需安装依赖)
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/accessibility-skill ~/.claude/skills/
安装后注意事项:使用前需在 TestMu AI 官网注册账号(提供免费额度),从 Profile 页面取得 LT_USERNAME 与 LT_ACCESS_KEY 并设为环境变量。技能本身只是参考文档,复制到位后 Agent 会在识别到 “accessibility”、“a11y”、“WCAG” 等触发词时自动读取,无需重启。若需要把扫描结果程序化读回(例如做 CI 门禁),需额外配置 Accessibility MCP Server,这部分不是本技能自带能力,需按 §8 说明单独接入。
11. 注意事项
- 默认的驱动 capability 路径没有结果 API、退出码或门禁标志,扫不出“通过/失败”,只能写入 Dashboard;要程序化读取结果需额外接入 MCP Server。
- 自动化扫描只覆盖 WCAG 成功准则的一部分(文档估计三分之一到一半),键盘可操作性、有意义的替代文本、状态消息等仍需人工或屏幕阅读器验证,不能把“扫描 0 问题”当作“完全合规”。
- Playwright 路径要求使用 Chrome(不支持 Chromium)且需要额外加载一个内置扫描扩展;HyperExecute 云执行环境下的无障碍能力是需联系支持单独开通的功能,并非默认可用。