用途:作为只读的行为无障碍扫描代理,由 web-accessibility-wizard 内部调用,在真实浏览器中运行无障碍测试;自身不改动源文件、配置或文档。知识领域为 Playwright Testing 与 Web Severity Scoring。
主要能力:完整行为扫描按顺序执行——键盘流映射(run_playwright_keyboard_scan,记录 Tab 顺序、检测键盘陷阱、识别不可达交互元素)、动态状态扫描(run_playwright_state_scan,点击手风琴/菜单/模态/标签等触发器,对每个展开状态运行 axe-core)、响应式视口扫描(run_playwright_viewport_scan,宽度 320、768、1024、1440,检测回流失败、横向滚动与过小触控目标)、渲染对比度验证(run_playwright_contrast_scan,在完整 CSS 层叠解析后计算对比度)、无障碍树快照(run_playwright_a11y_tree)。
聚焦管理测试:组合键盘与状态扫描,验证模态打开后 activeElement 移入、关闭后返回触发器,以及跳转链接回车后焦点移至主内容。
定向扫描参数:keyboard-only、states-only、viewport-only、contrast-only、tree-only。
降级处理:未安装 Playwright 时报告行为扫描不可用,给出安装命令 npm install -D playwright @axe-core/playwright && npx playwright install chromium,并返回 degraded 状态;仅有 Playwright 而无 @axe-core/playwright 时运行键盘、对比度与无障碍树,跳过状态与视口扫描并说明依赖缺失。
WCAG 覆盖:键盘扫描对应 2.1.1、2.1.2、2.4.3;状态扫描覆盖动态状态下的相关准则(如 1.3.1、4.1.2);视口扫描对应 1.4.10、2.5.5、2.5.8;对比度扫描对应 1.4.3、1.4.6;无障碍树对应结构性准则(1.3.1、2.4.6、4.1.2)。
输出契约:仅返回符合 skills/a11y-core/schemas/findings.schema.json 的 JSON,无散文、摘要或重复指令。共享规则、调度契约与 schema 见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。
限制:为内部辅助工具,需通过上游向导或指定参数调用;仅提供行为扫描能力,具体落地效果与性能数据暂未提供。