跳到正文
cccskills
免费在 GitHub 公开

fec-accessibility-check

用于审查或改进前端无障碍、语义结构、键盘支持、焦点管理、ARIA 标签、屏幕阅读器行为、WCAG 2.2 问题、触控无障碍或辅助技术回归;中文触发词包括 无障碍、accessibility、a11y、WCAG、屏幕阅读器。

中文简介正在准备中。当前显示原文说明。

实测评分 未实测

查看安装方法

包含的文件(3)

  • SKILL.md2.5 KB
  • references/report-template.md486 B
  • references/screen-reader-testing.md1.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

无障碍实现规范(WCAG 2.2 AA)

用途

确保前端 UI 对残障用户可访问,满足 WCAG 2.2 AA 的核心要求,并能被键盘、屏幕阅读器、触控和缩放用户稳定使用。

流程

  1. 检查语义结构:landmark、标题层级、表单 label、按钮/链接可访问名称、表格语义和图片 alt。
  2. 检查键盘路径:Tab 顺序、Enter/Space/Esc 行为、焦点可见、关闭后焦点恢复。
  3. 检查复杂组件:对话框、菜单、标签页、树、抽屉、表格和自定义控件的 ARIA 状态。
  4. 检查动态状态:loading、empty、error、toast 和异步更新需要被屏幕阅读器感知。
  5. 检查视觉与触控可读性:文本/背景对比、focus ring、缩放到 200%、减少动效偏好、触摸目标尺寸和移动端虚拟键盘行为。
  6. 用真实键盘路径复核关键流程,必要时补充屏幕阅读器或浏览器无障碍树观察;屏幕阅读器流程见 references/screen-reader-testing.md。
  7. 复核 WCAG 2.2 新增高频风险:可见焦点不被遮挡、拖拽操作有替代路径、目标尺寸过小、帮助入口和认证流程不依赖记忆负担。
  8. 输出分级报告;报告格式见 references/report-template.md。

详细参考

撰写无障碍审查报告时,加载 references/report-template.md。需要验证屏幕阅读器公告、焦点读法和动态区域时,加载 references/screen-reader-testing.md。

约束

  • 优先使用语义化 HTML,而不是 ARIA。
  • role 不应覆盖原生语义。
  • 交互元素必须可键盘访问。
  • 表单错误必须与字段关联。
  • 颜色对比度风险需要指出具体文本/背景组合。
  • 不用 ARIA 弥补可以用原生 HTML 解决的问题。
  • 不把浏览器自动可访问树当作最终结论;关键路径需要用键盘和至少一种辅助技术或等价检查验证。

预期输出

交互元素可键盘访问,语义和 ARIA 使用正确,焦点管理稳定;无障碍检查报告保存为 reports/accessibility-review-YYYY-MM-DD-HHmmss.md。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Use when reviewing or improving frontend accessibility, semantic structure, keyboard support, focus management, ARIA labels, screen reader behavior, WCAG 2.2 issues, touch accessibility, or assistive-technology regressions; Chinese triggers include accessibility, accessibility, a11y, WCAG, screen reader.

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

Use when absorbing ideas, capabilities, workflows, architecture, quality systems, ecosystem extensions, or engineering practices from any reference system into the current project through original, project-native redesign rather than copying.

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

用于从参考系统中吸收想法、能力、工作流、架构、质量体系、生态扩展或工程实践,并通过原创的项目内重设计转化为当前项目能力,而不是复制原实现。

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

Use when designing, implementing, or reviewing frontend-to-backend API integration, typed API clients, REST/tRPC/OpenAPI client choices, auth refresh, API error mapping, upload flows, SSE/WebSocket/polling choices, CORS-facing frontend behavior, or cross-boundary loading/error states. Do not use for backend-only service architecture or TanStack Query cache policy alone; Chinese triggers include API integration, front-end and back-end joint debugging, typed API client, Interface error handling, SSE, WebSocket.

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

用于设计、实现或审查前后端 API 集成、类型化 API client、REST/tRPC/OpenAPI 客户端选型、认证刷新、API 错误映射、上传流程、SSE/WebSocket/轮询选择、CORS 相关前端行为或跨边界 loading/error 状态。不要用于纯后端服务架构或仅 TanStack Query 缓存策略;中文触发词包括 API 集成、前后端联调、typed API client、接口错误处理、SSE、WebSocket。

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

Use when frontend work needs to communicate data, action, state, permission, validation, or business-rule needs to backend teams without dictating endpoint design, field names, database shape, or implementation details; Chinese triggers include front-end and back-end requirements handover, back-end requirements, API requirements clarification, data requirements description.

中文简介正在准备中。当前显示原文说明。

bovinphang/frontend-craft222026年9月26日 更新

查看 bovinphang 的全部技能

报告此技能的问题