网页体验与可访问性检查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_55e286a5/cn-web-design-guidelines。
技能介绍
为什么需要自动化的规范审查
在多人协作的前端项目中,UI 规范往往散落在各种文档或 Confluence 页面里。人工 Code Review 时,很容易遗漏诸如“间距必须为 8px 的倍数”或“按钮在 :focus 状态下必须有可见轮廓”这类细节。这就导致线上页面在不同设备或浏览器上出现体验割裂。我们急需一种能将抽象规则直接映射到源码行的工具。
工作原理与核心步骤
这个技能通过动态拉取指南来解决规则过期的问题。当你提供文件路径或匹配模式时,它的工作流非常直接:
- 动态获取规则:利用
WebFetch从源 URL 拉取最新的网页界面指南,确保审查标准不是陈旧的快照。 - 定位目标代码:读取你指定的
<file_path>或匹配<pattern>的源文件。如果未指定,技能会主动询问。 - 逐条比对:将指南中的每一条规则应用到代码中,不放过任何命名规范或结构层级的定义。
- 结构化输出:最终以
file:line的格式给出结果,让你可以直接跳转到问题所在的代码行。
适用边界与注意事项
需要注意的是,该技能的核心依赖在于源 URL 的可达性。如果目标指南站点无法访问,或者规则本身存在歧义,检查可能会中断或产生误报。此外,它主要进行静态文本层面的审查,无法替代在真实浏览器中的渲染验证或真机上的交互测试。建议将其作为 CI/CD 流程中的补充环节,而非唯一的质量防线。
使用场景
- 在 PR 提交前检查新组件是否符合 A11y 标准,阻止不合规代码合入主干
- 团队更新网页设计规范后,批量审查历史页面是否同步了新的间距和颜色规则
- 编写表单组件时,对照指南检查标签关联和错误提示文案是否符合规范
- 前端模块重构阶段,检查旧页面的结构是否符合最新交互规范,避免返工
适合人员
- 前端工程师,想在提交代码前自动验证组件是否符合团队最新网页界面指南
- 关注可访问性的工程师,需要确保网页满足 A11y 规范以适配屏幕阅读器等辅助技术
- 负责维护设计系统的开发者,想在指南更新后快速排查存量页面是否同步规则
- 编写表单和交互组件的开发者,希望获得关于命名规范和结构层级的逐条审查反馈