Agent Skills
返回列表
💻

网页体验与可访问性检查

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_55e286a5/cn-web-design-guidelines。

技能介绍

为什么需要自动化的规范审查

在多人协作的前端项目中,UI 规范往往散落在各种文档或 Confluence 页面里。人工 Code Review 时,很容易遗漏诸如“间距必须为 8px 的倍数”或“按钮在 :focus 状态下必须有可见轮廓”这类细节。这就导致线上页面在不同设备或浏览器上出现体验割裂。我们急需一种能将抽象规则直接映射到源码行的工具。

工作原理与核心步骤

这个技能通过动态拉取指南来解决规则过期的问题。当你提供文件路径或匹配模式时,它的工作流非常直接:

  1. 动态获取规则:利用 WebFetch 从源 URL 拉取最新的网页界面指南,确保审查标准不是陈旧的快照。
  2. 定位目标代码:读取你指定的 <file_path> 或匹配 <pattern> 的源文件。如果未指定,技能会主动询问。
  3. 逐条比对:将指南中的每一条规则应用到代码中,不放过任何命名规范或结构层级的定义。
  4. 结构化输出:最终以 file:line 的格式给出结果,让你可以直接跳转到问题所在的代码行。

适用边界与注意事项

需要注意的是,该技能的核心依赖在于源 URL 的可达性。如果目标指南站点无法访问,或者规则本身存在歧义,检查可能会中断或产生误报。此外,它主要进行静态文本层面的审查,无法替代在真实浏览器中的渲染验证或真机上的交互测试。建议将其作为 CI/CD 流程中的补充环节,而非唯一的质量防线。

使用场景

  • 在 PR 提交前检查新组件是否符合 A11y 标准,阻止不合规代码合入主干
  • 团队更新网页设计规范后,批量审查历史页面是否同步了新的间距和颜色规则
  • 编写表单组件时,对照指南检查标签关联和错误提示文案是否符合规范
  • 前端模块重构阶段,检查旧页面的结构是否符合最新交互规范,避免返工

适合人员

  • 前端工程师,想在提交代码前自动验证组件是否符合团队最新网页界面指南
  • 关注可访问性的工程师,需要确保网页满足 A11y 规范以适配屏幕阅读器等辅助技术
  • 负责维护设计系统的开发者,想在指南更新后快速排查存量页面是否同步规则
  • 编写表单和交互组件的开发者,希望获得关于命名规范和结构层级的逐条审查反馈