用途 该技能是一个面向 UI 代码的质量审查工具,核心目标是针对 WCAG 2.2 无障碍规范、Core Web Vitals 性能模式以及现代 Web 设计最佳实践,找出有证据支撑的问题并给出改进优先级。它属于“代码质量”类别,而非用于构建界面。
主要能力 审查范围按优先级排列:无障碍(语义化 HTML、ARIA、标签关联、alt 文本、颜色对比度、焦点指示);键盘导航(Tab 顺序、模态焦点陷阱、Esc 处理);表单(标签、校验、错误展示、自动填充、不阻止粘贴);异步状态与反馈(加载指示、可重试的可见错误、空状态、提交禁用防重复提交,统一 Default/Loading/Disabled/Error/Empty/Success 状态词汇);操作与注意力(每视图一个填充文字按钮、图标可访问名称与提示、列表行整行可点、破坏性操作需确认或撤销等);动画(尊重 prefers-reduced-motion、避免 transition: all、仅 GPU 安全属性);性能(图片尺寸、懒加载、大列表虚拟化);触控移动(触控目标不小于 44px、touch-action、安全区);响应式布局(320/768/1024px 断点测试,优先流式重排,无法重排时允许固定宽度加滚动);内容(长文本溢出、行宽);暗色模式与国际化的颜色方案、逻辑属性、Intl 格式化;源码在范围内时另做组件架构与复用检查。
此外还包含一轮九维度的 UI/UX 设计原则检查:视觉层级与布局、排版、颜色与对比、间距与网格、交互与反馈、导航与信息架构、表单与输入、移动与触控、速度与感知速度,每个维度配有对应思考提示。
使用方式
- 确定目标:提供文件或匹配模式;未提供则询问要审查的组件。
- 扫描文件:用读取与检索工具查找违规模式。
- 按优先级检查类别,再逐个维度执行九项重点检查。
- 通过验证步骤确认发现后,按“文件:行”格式、按文件分组输出简洁问题清单与汇总。 审查模式:单独使用默认只读报告;启用修复循环后可执行“审查→验证→获授权修复→重新审查”,默认最多三轮;也可由调用方持有修复与复审。所有结论需提供证据与置信度,超过 80% 置信度才采取行动。
适用场景 发布前的 UI 无障碍合规审查;组件或页面的 WCAG 违规审计;代码中 Core Web Vitals 性能模式检查;响应式与移动友好性验证;提交 PR 前的 UI 质量门禁。
限制 不用于构建 UI、创建设计规范或替代项目自身的 UI 审查门;项目已配置的样式指南与设计系统文档优先级高于其条款。截屏或无源码的界面无法验证组件基座与复用情况,会标记为不可验证。需先阅读其参考指南再扫描。平台与项目约定需先解析,WCAG 2.2 AA 作为 Web 基线;不适用的条款可跳过。
兼容与前置说明 文档说明在 Codex 中通过加载注册的 .agents/skills/<name>/SKILL.md 调用,无需单独 Skill 工具或模式切换;工作流步骤保持既定顺序,偏离需用户批准;需要提问时使用原生提问工具;所提到的任务追踪、子代理授权和外部工具名称映射按文档约定处理。