用途 21st-ui-review 用于审查现有 UI，将其与项目的设计上下文、无障碍预期、响应式行为、交互质量以及高置信度的生产要求进行对照。该技能的核心原则是“用证据审查”，强调把可确定的缺陷与主观设计建议严格区分开，避免把偏好当作缺陷。
主要能力
- 读取设计上下文与源码：读取 .21st/design.json、项目说明以及相关源码。
- 运行确定性审查：可执行 21st review <path>，或使用 21st review <path> --json 获取 JSON 输出。
- 检查实际实现：检查实际的组件组合与运行时状态，并依据代码而非名称来验证结论，避免从命名推断行为。
- 分组归类发现：将发现分为确定性缺陷、设计系统漂移、无障碍与交互缺陷、响应式风险、主观产品/设计建议。
- 排序与定位：按用户影响排定优先级，并包含精确的文件与行号归属。
- 受控修复：仅对确定性、低歧义的修复使用 21st review <path> --fix。
- 验证闭环：修复后运行相关项目测试并重跑审查，以证明问题已解决。
审查优先级
- 语义控件与可访问名称；
- 键盘访问、焦点可见性，以及对话框/菜单行为；
- 图像替代方案与有意义的标签；
- 触控目标尺寸与禁用/加载状态；
- 响应式溢出与固定宽度假设；
- 减少动态效果的处理；
- 与项目令牌冲突的硬编码视觉值；
- 使用重复的原语而非现有组件；
- 字体、圆角、间距、阴影与图标不一致；
- 假数据、占位文案，或缺少空/错误状态。
使用方式 工作流为：先读取 .21st/design.json、项目说明和相关源码；运行确定性审查（21st review <path> 或 21st review <path> --json）；检查实际组件组合与运行时状态，依据代码验证结论；将发现分组归类；按用户影响排序并给出文件与行号定位；仅对确定性、低歧义问题使用 --fix 修复；修复后运行相关项目测试并重跑审查以证明已解决。
适用场景 适用于希望对现有 UI 做基于证据的审查，区分确定性缺陷与主观建议，并按用户影响优先处理修复的场景；也适用于需要以文件/行号精确定位问题、并在修复后验证结果的工程流程。
限制
- 不得静默重新设计、更改品牌标识或改变产品行为。
- --fix 仅用于确定性、低歧义的修复。
- 主观建议必须清晰标注。
- 若没有可证明的问题，应说明这一点，并列出已检查的内容。
- 关于分类、收费、价格、平台或效果等信息，资料未提供。