用途:当用户要求检查无障碍、审计 a11y 或验证 WCAG 合规时,针对某个具体功能、页面或组件生成 WCAG 2.1 AA 合规审计,按 POUR 原则组织为可执行的检查清单。
主要能力:先读取 .chalk/docs/product/ 中的 PRD、.chalk/docs/engineering/ 中的组件架构与既有 a11y 指南,并阅读 UI 组件源码;从 $ARGUMENTS 解析审计目标,未指定时要求用户指明具体功能,避免一次性审计整个应用导致结果肤浅。随后按四类检查:可感知(图片 alt 文本、颜色非唯一信息载体、对比度 4.5:1 与 3:1、200% 缩放可读、媒体字幕或文字稿);可操作(键盘可达性、记录预期键盘导航路径、焦点顺序、无键盘陷阱、焦点指示可见、触控目标至少 44x44 CSS 像素);可理解(表单可见标签、错误信息定位与修复说明、导航与命名一致、页面语言设置);健壮(语义 HTML、ARIA 角色状态属性正确且必要、兼容 VoiceOver/NVDA/JAWS)。
使用方式:读取 .chalk/docs/engineering/ 中最大编号文件,下一编号为最大编号加一,将结果保存为 .chalk/docs/engineering/<n>a11y_audit<feature-slug>.md,首行为 # Accessibility Audit: <Feature Name>,格式为纯 Markdown,每项标记 pass/fail/needs-review 并附具体测试说明;最后告知文件路径并指出阻塞用户完成任务的最严重问题。
限制与注意:避免只写“检查颜色对比度”这类不可操作条目;避免 ARIA 过度使用,优先原生 HTML;键盘测试不能只用 Tab,需覆盖方向键、Escape、空格、Enter;需说明屏幕阅读器应播报的内容;并注明哪些检查可纳入 CI 自动化、哪些需每次发布手动测试。资料未提供具体安装命令、收费或平台信息。