用途
ui-research 用于在开始设计或构建用户界面之前完成前置调研与规范制定。资料将其定位为：从零生成的界面往往带有随机间距、杂乱配色、所有区块居中、缺少空态与错误态等“生成感”，而专业模板与成熟设计系统已经沉淀了可用的布局、层级和状态。该技能负责找到这些参考、固定设计令牌，并在 godmode:ui-engineering 编写任何标记之前确定每个组件的模式，使每个屏幕都可追溯到参考，每个视觉值都可追溯到令牌。
主要能力
- 对界面进行分类：判断它属于营销页、数据密集型应用、电商、开发者工具、游戏还是 CLI，以及用户群体与行业，从而确定适用的模式族与令牌预设。
- 检查项目已有的设计系统、组件目录、令牌文件或主题，若存在则直接以其为参考，跳过外部模板调研。
- 调研版式：对新建站点或应用，从模板市场来源中选取至少两个合适层级来源，研究三到五个优秀案例，记录区块顺序、导航风格、配色思路与排版。
- 提炼同类产品的共享约定，区分哪些是行业惯例、哪些是留给用户做的设计选择。
- 以带名称的选项形式呈现三个方案（附链接）加一个推荐混合方案，并等待用户选择；版式选择始终由用户决定。
- 在写组件前固定令牌：颜色、字号阶梯、间距阶梯、圆角、阴影、断点、z-index 与动效，并当场检查文本与 UI 对比度。
- 为屏幕上每个组件命名其模式（来自模式库或项目设计系统），并定义所需状态。
- 通过组件校验清单交接给 ui-engineering，内容包括所选布局参考、令牌集、每个组件的模式与状态。
使用方式
资料给出的流程为：分类界面 → 判断项目是否已有设计系统（有则采用其令牌与组件；无则调研至少两个来源、三到五个案例）→ 呈现 A/B/C 加推荐混合方案并等待用户选择 → 固定令牌 → 逐组件确定模式与状态 → 运行校验清单 → 交给 godmode:ui-engineering。技能还列出了应当跳过的情形：项目设计系统中已存在的组件、界面不变的纯逻辑改动、不改变布局的文案修改。资料同时明确禁止：在令牌集与组件模式确定前写 UI 代码、替用户选择模板或版式方向、复制用户未获授权的付费模板代码或素材、在呈现的设计中使用占位文本、重建项目设计系统已提供的组件。
适用场景
资料列出的必需场景包括：任何新网站、落地页、营销站、作品集或店铺；任何新的应用界面、仪表盘、后台面板、设置页、引导流程或认证页；项目设计系统尚未提供的新组件；游戏界面（菜单、HUD、背包）以及供人阅读的 CLI 输出。
限制与质量要求
技能内置“业余 UI 特征”清单，涉及间距不规律、临时配色、字体过多、层级扁平、全部居中、占位内容、只有正常路径、缺少交互状态、圆角混用、装饰性效果、控件过大、对比度不足等问题，并给出对应替代做法。组件校验清单要求：模式已命名；所有颜色、尺寸、间距、圆角、阴影与时长均为令牌；定义默认、悬停、焦点可见、按下、禁用等状态，涉及数据时还包括空、加载、错误、部分与成功状态；至少规定移动端与桌面端行为；使用真实内容含最长最短值；文本对比度至少 4.5:1、大文本至少 3:1、UI 组件边界与状态至少 3:1；指针目标至少 24×24 CSS 像素或充分间隔（WCAG 2.2 SC 2.5.8）；定义键盘路径与焦点顺序，并为对话框、标签页、菜单、组合框等控件指明 WAI-ARIA 编写实践模式；信息不得仅靠颜色传达。任何一项无法满足，组件即未就绪。
与其他技能的衔接
godmode:intent-discovery 在涉及界面时调用本技能，所选布局与令牌进入设计文档；godmode:reference-first 将所有界面工作路由至此；godmode:ui-engineering 接收布局参考、令牌集与组件模式并实现；godmode:grounding 在依赖设计系统当前 API 或市场当前条款前进行核实；godmode:performance-tuning 在所选设计意味着大量媒体或字体时提前检查成本。