mcpField
W
web-design-guidelines

web-design-guidelines

github.com/tech-leads-club设计与 UI7.1k254 次安装今天更新
代码仓库

关于 web-design-guidelines

用于按界面规范检查 Web 文件的技能,覆盖无障碍、交互、内容、性能等方面,并以简洁的文件与行号格式报告问题。

主要功能

  1. 01无障碍与语义 HTML 检查
  2. 02键盘操作与焦点审查
  3. 03表单、动画和排版检查
  4. 04导航、本地化与主题审查
  5. 05简洁的文件:行号问题报告

适用场景

  1. 01发布 Web 界面前审查文件
  2. 02查找无障碍和键盘操作问题
  3. 03检查页面布局与内容边界情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tech-leads-club/agent-skills --skill web-design-guidelines

安装后在 Claude Code 中输入/web-design-guidelines确认已加载。

附带文件references/guideline.md

详细介绍

Web 界面指南

检查文件是否符合 Web 界面指南。

工作原理

  1. 从 #[[file:references/guideline.md]] 读取指南
  2. 读取指定的文件(或提示用户提供文件/模式)
  3. 对照指南中的所有规则进行检查
  4. 以简洁的 file:line 格式输出检查结果

指南参考

所有规则和输出格式说明均在:

#[[file:references/guideline.md]]

指南涵盖:

  • 无障碍(ARIA、语义化 HTML、键盘导航)
  • 焦点状态和键盘交互
  • 表单(自动补全、验证、标签)
  • 动画(减少动态效果、性能)
  • 排版(正确的字符、数字格式)
  • 内容处理(溢出、空状态)
  • 图片(尺寸、延迟加载)
  • 性能(虚拟化、DOM 读取)
  • 导航和状态(URL 同步、深层链接)
  • 触摸和交互(点击延迟、安全区域)
  • 暗黑模式和主题
  • 区域设置和国际化
  • 水合安全性
  • 需要标记的常见反模式

用法

用户提供文件或模式参数时:

  1. 从 references/guideline.md 读取指南
  2. 读取指定的文件
  3. 应用指南中的所有规则
  4. 按指南指定的格式输出检查结果

如果未指定文件,请询问用户要检查哪些文件。

输出格式

遵循指南中的格式:

  • 按文件分组列出检查结果
  • 使用 file:line 格式(可在 VS Code 中点击)
  • 简洁明了,尽量减少无关内容
  • 指出问题及其位置
  • 除非修复方式不明显,否则不作解释

评论

支持 Markdown