用途
web-design-guidelines 是一个用于审查 UI 代码是否符合 Web Interface Guidelines（Web 界面指南）的技能。它适用于被要求“review my UI”“check accessibility”“audit design”“review UX”或“check my site”等场景，即对界面代码进行设计、无障碍与体验层面的合规检查。
主要能力
该技能依据 references/guideline.md 中定义的规则集，对指定文件逐条检查，并输出发现的问题。指南覆盖的范围包括：
- 无障碍：ARIA、语义化 HTML、键盘导航
- 焦点状态与键盘交互
- 表单：自动填充、校验、标签
- 动画：减少动态效果、性能
- 排版：正确字符、数字格式
- 内容处理：溢出、空状态
- 图片：尺寸、懒加载
- 性能：虚拟化、DOM 读取
- 导航与状态：URL 同步、深度链接
- 触摸与交互：点击延迟、安全区域
- 深色模式与主题
- 语言与国际化
- 水合安全
- 需要标记的常见反模式
使用方式
当用户提供文件或匹配模式参数时：
- 从 references/guideline.md 读取指南
- 读取指定的文件
- 应用指南中的所有规则
- 使用指南中指定的格式输出发现的问题
如果未指定文件，则询问用户要审查哪些文件。
输出格式
遵循指南中的格式：
- 按文件分组列出发现的问题
- 使用 file:line 格式（在 VS Code 中可点击）
- 简洁、高信噪比
- 说明问题 + 位置
- 除非修复方式不明显，否则跳过解释
适用场景
适合在需要快速审查前端界面代码是否符合 Web 界面规范时使用，例如无障碍检查、设计审查、UX 审查以及站点合规检查。
限制
该技能的具体规则内容与输出格式细节均定义在 references/guideline.md 中，本资料未提供该文件的完整内容；除上述覆盖范围外，其他功能、收费、价格、平台或效果信息暂未提供。