网页设计规范
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/asyrafhussin-agent-skills-web-design-guidelines。
技能介绍
要解决什么问题
前端界面在「能跑」和「多数人能用」之间还有一层:WCAG、键盘可达性、表单与读屏兼容性往往要在上线前或整改期才逐项对照,缺乏一份可执行的检查清单与规则前缀(a11y-、form-、motion-、perf-),容易漏项或只在某类栈上有效。
技能如何工作
本技能把 23 条规则 归在四类优先级里(无障碍 CRITICAL、表单 HIGH、动效 CRITICAL、性能与 UX MEDIUM),同时提供两种用法:
- 编码参考:按语义 HTML、焦点管理、
aria-*、对比度、表单label/aria-describedby、动效prefers-reduced-motion等条目落地实现。 - 审计模式:当用户要求 audit accessibility / 检查 WCAG 时,按步骤确定范围 → 根据
.tsx、.vue、.blade.php、.html识别栈 → 对清单逐项输出 PASS / FAIL / N/A(FAIL 需含文件路径与修复建议)→ 汇总。
清单覆盖标题层级、skip link、模态焦点陷阱、图标按钮 aria-label、错误态 role="alert"、图片 alt、仅颜色传达信息等典型 WCAG 审查点。
适用边界
它是 Web 界面无障碍与设计规范 导向,不是通用视觉品牌手册;复杂业务逻辑的正确性、后端安全、全站性能 profiling 需结合其它工具。审计默认面向 UI 组件与页面;若只审部分文件,应在对话中明确 ARGUMENTS 范围。
使用场景
- 新组件上线前,要对 React/Vue 页面跑一遍 WCAG 清单并拿到带文件位置的 FAIL 列表
- 接手遗留站点的无障碍整改,需要按语义 HTML、键盘焦点、ARIA 逐项核对而非泛泛建议
- 设计多步表单与校验提示,要确认 label、aria-required、aria-describedby 与错误朗读方式一致
- 产品要求支持减少动效偏好时,检查动画与自动播放媒体是否符合 prefers-reduced-motion 规则
适合人员
- 负责合规或客户审计答复的前端,需要把界面问题映射到可追踪的 WCAG 检查项
- 维护设计系统组件库的工程团队,希望新组件默认满足键盘导航与读屏约定
- 做无障碍专项 refactor 的全栈开发者,要在 Blade/静态 HTML 与 SPA 栈里统一审计口径
- 编写产品内表单与错误反馈的 UX 工程师,需要可引用的表单与对比度规则前缀