用途:ui-review 用于审查 UI 代码,检查设计系统合规性、可访问性(a11y)和最佳实践。调用方式为审查文件 $ARGUMENTS。
不适用场景:仅无障碍问题用 /ss-a11y;Nielsen UX 启发式用 /ss-audit;快速自动化检查用 /ss-lint;非 UI 代码(数据获取、业务规则)不适用。
主要核查项:设计令牌合规(颜色、间距、阴影、圆角不得硬编码);组件约定(data-slot、cn()、React.ComponentProps<>、className 覆盖、具名导出、不写只加 className 的包装组件);可访问性(触控目标 >=44x44px、focus-visible、aria-、WCAG AA 对比度、prefers-reduced-motion、alt 文本、表单标签);移动端(无横向溢出、触控间距、安全区、字号 >=12px、滚动容器 -webkit-overflow-scrolling: touch);性能(避免多余重渲染、懒加载图片、代码分割);排版(Pretendard/Inter 字体栈、14 步字号、字重 400/500/600/700、各级 leading/tracking 规则);间距一致性(6px 倍数、size- 简写、ms-/me- 逻辑属性、动效时长令牌);视觉一致性(单一圆角风格、单一强调色、不用 emoji 作图标、状态色表严重程度、单一阴影语言、统一图标族、嵌套圆角=外圆角−内边距、控件高度一致、错误状态不单靠颜色)。
输出格式:评分(Pass / Needs Improvement / Fail)、问题列表(含 file:line)、修复建议(具体代码改动)。
限制:仅在上游来源与本地项目上下文明确匹配时使用;应用改动前需验证命令、生成代码、依赖、凭据和外部服务行为;示例不能替代环境特定测试、安全审查或对破坏性/高成本操作的用户批准。