技能 Quality

前端 UI

前端 UI 检查清单 — CSS 优先级、深色/浅色主题、视觉测试、移动端响应式、i18n 一致性。在编辑 HTML/CSS 时应用。

概述

前端 UI 是一份质量检查清单,只要任务修改了 HTML、CSS、模板或视觉组件就会被加载。它能捕获那些通过了 HTTP/语法检查却破坏视觉体验的常见 UI 缺陷——深色模式下的浅色泄漏、移动端布局错乱、缺失无障碍标签,以及错误的社交预览。

CSS 深色/浅色模式

浅色模式是默认值,.dark 类为覆盖项。该技能严格禁止使用 :not(.dark) 选择器,这是一种常见的反模式,会导致浅色颜色泄漏到深色模式中,因为 :not(.dark) 会匹配任何没有该类的祖先元素,包括 <body> 和 <section>。

视觉验证

对于 UI 任务,HTTP 200 + 有效 HTML 是不够的。必需的检查包括深色和浅色两种模式下的截图、移动端视口(320px、375px)、平板(768px)、桌面(1280px+),以及即时切换主题而不闪烁错误主题。动画抽屉和对话框仅在其稳定状态下捕获,并将相关内容边界与视口进行比对 — 而不是在任意 sleep 之后,也不在禁用被测过渡的情况下进行。

检查清单领域

  • i18n UI 一致性 — 各语言间翻译键完全一致、语言切换器可用、支持 URL 前缀、文本长度处理(俄语文本比英语长 20-30%)
  • 移动端响应式 — 汉堡导航、44x44px 点击目标、无内容溢出、图片缩放、基础字号最小 14px
  • 无障碍基线 — WCAG AA 颜色对比度、可访问的按钮标签、可见的焦点状态、跳转到内容链接、支持减少动态效果
  • 性能卫生 — 首屏以下图片懒加载、font-display swap、延迟脚本、无无界 CSS 动画
  • SEO 与社交预览 — 唯一的标题和描述、Open Graph 和 Twitter Card 标签、og:image 文件存在、规范 URL、站点地图中的 hreflang

组件数量的唯一事实来源

在生成用于内容或文档的框架组件列表(agents、skills、commands)之前,务必查询文件系统 — 绝不要依赖之前会话中缓存的数字。过时的计数曾在生产站点上导致错误(例如,实际为 16/22 时却显示“15 agents / 18 skills”)。

使用时机

在 /dr-do 期间,对任何修改 .html、.php、.css、.vue 或 .tsx 文件的任务应用。tester agent 在 Web UI 测试模式下包含此检查清单,reviewer agent 在 /dr-qa 期间验证合规性,其中自动化 Playwright 流程(参见 playwright-qa)会为 UI 变更捕获浏览器证据。