ima2 UI/UX:意图发现、模式与产品词汇
设置
npm install -g ima2-gen # 全局安装 (Node.js >= 20)
ima2 setup # 首次认证 (推荐 GPT OAuth)
ima2 serve # 启动本地服务
ima2 ping # 验证
ima2 status # 配置和 OAuth 状态
Agent 启动流程: 首先执行 ima2 ping。如果无法连接:运行 ima2 serve &。如果未安装:运行 npm install -g ima2-gen && ima2 setup。使用 ima2 skill path 定位技能文件;阅读 ../ima2-uiux/SKILL.md(本文件)获取设计方向,阅读 ../ima2-front/SKILL.md 获取实现资产。
通过以下变更场景激活:
- 用户的设计方向模糊(“깔끔하게”、“모던하게”、“让它好看就行”)
- 构建引导流程、空白状态、错误状态或加载状态 UI
- 用户提及产品美学(“Notion 느낌”、“像 Linear 那样”)
- 开始新的设计系统或生成调色板
- 选择布局模式或导航架构
- 设置网站图标、产品 Logo 或品牌标识元素
- 处理 Logo 深色模式变体、OG 图像或社交分享元数据
当用户无法清晰表达明确设计方向时,请优先阅读本文件而非风格化的细节参考。
有关反混乱检测和禁用模式,请参考 ima2 skill front ref anti-slop,尤其是 2026 渐变预算和单一主题禁令。
Emoji 禁令(存根): 禁止将 Emoji 用作 UI 视觉元素(严格)。规范规则、范围和豁免:ima2-front §5 / ima2 skill front ref anti-slop § Emoji 混乱。
角色分离: 本技能负责设计判断:意图发现、信息架构、UX 状态含义、排版/颜色/布局方向、产品个性、品牌词汇、反混乱模式判断和设计系统决策。ima2-front 负责实现:HTML/CSS/组件、响应式机制、无障碍连接、运行时行为和渲染验证。在此选择设计方向后,加载 ima2-front 进行具体实现。
外部/当前设计证据: 对于实时的产品参考声明、当前设计系统文档、浏览器 API 行为、可能已更改的无障碍指南或浏览器渲染的源证据,请搜索网络并遵循其查询重写、源获取和证据状态规则。仅在有候选 URL 后使用浏览器 fetch/open/text/get-dom/snapshot。
C0/C1 工作(小型本地补丁): 对于小型补丁,跳过完整的参考链。
规则类说明 (UX-STYLE-01): 本技能中所有表达品味的内容——产品个性、设计主义、预设标记、美学词汇——均为
STYLE_SAMPLE:可供参考的示例,绝非普遍要求。客观的 UX 正确性(状态覆盖、无障碍、可读性)由ima2-front§1.5 负责,并保持严格/默认。
模块化参考
推荐:将技能安装到 Agent 的技能目录。
ima2 skill install --dir <agent-skill-path> # Agent 提供其自身的路径 ima2 skill install --tmp # 临时后备方案Agent 决定其自身的技能目录并通过
--dir传递。安装后,SKILL.md和references/将存在于磁盘上,可供原生读取。即席读取(无需安装):
ima2 skill uiux refs # 列出所有参考模块及其行数 ima2 skill uiux ref design-isms # 打印单个模块(基本名称匹配)
| 文件 | 何时读取 | 内容概述 |
|---|---|---|
references/design-isms.md | 用户命名某种风格/运动时 | 16 种设计运动及其 CSS 特征,包括液态玻璃 + 液态编辑默认工具包(2025-2026)+ AI 衬线编辑 + 有机胶囊(已验证 2026-07-09) |
references/design-award-sources.md | 寻找现实世界设计参考时 | 分层源指南:奖项和展示网站,每个网站的最佳用途以及搜索方法 |
references/compositional-patterns.md | 组合英雄区、导航、动效或内容结构时 | 来自奖项研究的经典构图模式,附带响应式和无障碍门控 |
references/design-trends.md | 检查日期流行度、新兴技术或推广状态时 | 2026-07-14 轴频率快照、技术信号、签名账本和重新爬取协议 |
references/design-read-example.md | 学习或回顾设计阅读格式时 | 完整的设计阅读 + 刻度设置示例 |
references/product-personalities.md | 用户提及某个产品时 | 10 个产品 DNA 档案及精确标记,包括 2026 AI 产品柔和色 + OpenAI 暖色无衬线有机 + Anthropic 衬线书卷气 |
references/layout-macrostructures.md | 选择页面/组件布局时 | 组件布局 + 页面级构图 |
references/ux-states.md | 构建任何有状态 UI 时 | 引导、空白、错误、加载、渐进式披露 |
references/color-system.md | 生成颜色/调色板时 | 基于 OKLCH 的调色板生成、色相预算、着色中性色、深色模式、无障碍 |
references/design-system-bootstrap.md | 新项目/设计系统时 | 令牌架构、组件层次结构、DESIGN.md 格式 (google-labs-code/design.md) |
references/responsive-nav.md | 响应式或导航工作时 | 断点、容器查询、按密度划分的导航模式 |
references/ux-preflight.md | 交付前 | UX 状态验证检查清单 |
references/typography-line-breaks.md | 文本密集型 UI 始终需要 | 标题断行质量,短描述符类别(英雄副标题、卡片描述——使用 balance 而非 pretty),孤字预防,ch 单位,韩语孤字标准,-webkit-line-clamp 冲突 |
references/favicon-logo.md | 网站图标、产品 Logo 或品牌标识工作时 | 网站图标文件集、SVG 深色模式、导航/页脚中的 Logo、深色模式变体、OG 图像、品牌令牌、常见错误 |
references/logo-trust-sections.md | 集成/合作伙伴/客户 Logo 时 | 跑马灯与网格决策、反模式、灰度处理、位置 |
references/visual-hierarchy.md | 任何布局/构图决策时 | 6 个杠杆:尺寸比例、粗细对比、颜色强调、间距、位置、密度 |
references/form-patterns.md | 表单、向导、认证、文件上传时 | 验证时机、多步骤、密码 UX、文件上传、搜索/筛选 |
references/mobile-native-ux.md | 原生移动应用 UX 决策时 | iOS HIG 与 Material 3、手势、深度链接、韩语隐私、应用商店 UX |
references/intent-discovery-ladder.md | UX-INTENT-01 可选深化(步骤 1-6)时 | 情绪/亮度/密度/形状/视口/参考阶梯,模糊请求消歧 |
references/korean-design-vocabulary.md | 韩语设计简报或韩语优先 UI 时 | 韩语描述符 → CSS 标记翻译、快速匹配表、字体选择指南 |
懒用户门控 (UX-LAZY-01,默认——对 UX 应用马尾辫原则)
为认知节俭型用户设计:用户不阅读,他们扫描;他们满足于满意解;他们愿意用选择权换取一个明显的下一步操作。在交付任何面向用户的决策点之前——选项、设置、步骤、确认、输入字段、模式——按照马尾辫方式证明其存在的合理性,顺序如下:
- 不采取任何操作:正确的默认值能否完全消除这个决策?
- 删除:该步骤/字段是否值得其完成率成本(希克定律)?
- 吸收:系统能否承担复杂性而是用户(特斯勒定律)?
- 降级:某些用户仍需要 → 渐进式披露,绝不作为顶级分叉。
每个屏幕都有一个主要操作。表面条件:面向消费者/一次性流程最小化决策;重复工作工具(密集配置)最小化重复操作——将专家控件折叠到向导中是反方向失败。严格豁免:破坏性/不可逆操作、同意/隐私/法律、支付确认以及无障碍辅助功能绝不折叠到魔法默认值中。
UX 状态契约 (UX-STATE-01)
对于引导、空白、加载、错误或渐进式披露工作,正文必须在样式之前回答状态含义。深层模式在 references/ux-states.md 中。
- 引导教学第一个有意义的操作,而不是整个产品。
- 空白解释状态存在的原因并指明下一个操作。
- 加载为已知结构选择骨架,为短时间未知等待选择旋转器/进度条,并避免虚假完成。
- 错误暴露重试、恢复或升级;绝不让用户陷入死胡同。
- 渐进式披露说明什么保持隐藏、为什么保持隐藏以及在哪里变为可用。
IA 选择器 (UX-IA-01)
按工作形态划分的默认导航架构;关于响应式细节,请阅读 references/responsive-nav.md。
| 工作形态 | 默认 IA |
|---|---|
| 密集桌面重复工作 | 侧边栏 + 命令面板 |
| 中等分段工作 | 标签或分段导航 |
| 移动优先消费者流程 | 底部导航、面板或拇指区域操作 |
| 向导/认证/设置 | 步骤条或堆叠线性流程 |
1. 用户意图发现协议
当用户的设计请求模糊时(“깔끔하게 해줘”、“모던하게”、“让它好看就行”),不要生成通用输出。运行简洁模糊流程 (UX-INTENT-01):
- 使用可用信号从 §2 生成设计阅读。
- 如果一个决策仍然阻碍方向,则提出一个最佳澄清分叉,提供二元/三元选择。
- 根据答案继续;如果用户未回答且任务可以继续,则选择最符合领域默认值并说明假设。在表现力表面(落地页/消费级/创意/AI 产品)上,该默认值为下方无简报默认方向 (UX-DEFAULT-ISM-01);平静表面保持平静的领域正确默认值。
如果用户提供了明确的设计规范或这是 ≤5 行的补丁,则跳过此部分。
无简报默认方向 (UX-DEFAULT-ISM-01,默认——工具包内容 STYLE_SAMPLE)
这是 UX-INTENT-01 步骤 3 的后备方案,绝非绕过:它仅在设计阅读和单个阻塞分叉已解决或未回答后触发,且应用的方向始终作为明确的假设在交付物中说明。一个命名、具体、受领域限制的方向取代了通用的 LLM 默认值;它不得以新标签重新引入通用的玻璃拟态 / 居中卡片 / 米色默认品味。
表现力表面的默认工具包:液态编辑(2026 复合体,于 2026-07-07 从 Tier-2 趋势研究中确定——完整特征见 references/design-isms.md §1.14):
- 结构:以排版为主导的编辑构图(超大作者标题比例、默认无衬线、衬线展示仅在有排版理由时使用(UX-TYPE-01),触觉/摄影纹理优于扁平渐变洗涤,非对称内容加权布局。
- 材质强调:仅限浮动功能层(导航/工具栏/芯片集群)上的液态玻璃或近乎不透明的药丸镀铬;药丸芯片内容单元;内容层保持实心(
ima2-frontFE-LIQUID-LAYER-01)。药丸镀铬内的子元素在静止状态下不携带胶囊边框/轮廓——仅通过填充/色调进行强调(ima2-frontFE-PILL-NEST-01);顶部栏滚动状态按ima2-front/references/top-bar.mdFE-TOPBAR-STATE-01 处理。 - 动效:反馈基线 + 一个标志性时刻(指针接近芯片或滚动驱动揭示)+ >= 1 个在落地页段表面上的支撑滚动揭示(底层 2,上限 ~4——
ima2-front/references/motion.mdFE-MOTION-BUCKET-01);其他区域仅反馈,按动效领域门控。 - 颜色:源自 OKLCH 的单一强调色 + 着色中性色(色相预算,
references/color-system.md)。
领域门控(严格):仪表盘、管理后台、运营、财务、政府、B2B 重复工作工具绝不会默认接收此工具包——“花哨”永远不能凌驾于领域正确性之上(§ IA 选择器 + ima2-front 产品密度配置文件)。
可选深化: 仅当第一个分叉失败或用户明确希望引导式探索时,才使用下面的阶梯。
- 使用二元/三元选择,而非开放式问题。
- 引用已知产品——用户识别他们想要的东西比表达更快。
- 如果图表技能可用,建议:“참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요。”
- 如果用户命名了具体产品参考,则跳过其余步骤并直接通过
references/product-personalities.md进行映射。
有关完整的 6 步引导式阶梯(情绪→亮度→密度→形状→视口→参考)和模糊请求消歧表,请阅读 references/intent-discovery-ladder.md。仅在上述简洁流程需要更深入的引导式探索时加载它。
2. 设计阅读(对于新页面、组件或布局为强制要求。对于 ≤5 行的补丁为可选——请参阅开发人员 §0.1 补丁快速通道。)
在生成任何前端代码之前,请生成本阅读。如果项目有 DESIGN.md 文件,请先阅读它——其令牌和散文覆盖上述所有内容。
原生工具支持(结构/60):在编写本阅读之前,使用 view_image 将视觉参考——现有屏幕、竞争对手截图、设计导出——读入上下文;使用 ima2 生成所需的位图资产(图标、插图、模拟图像)(探测 ima2 status,如果停止则尝试 ima2 serve;ima2 是主要工具,仅当 ima2 真正不可用时才使用),而不是留下占位框;并根据视觉验证(浏览器截图 -> view_image)进行视觉检查。
输出格式(迷你 DESIGN.md)
填充示例:references/design-read-example.md。
---
name: <项目名称>
colors:
primary: "<色值>"
accent: "<色值>"
background: "<色值>"
typography:
heading: { fontFamily: <字体>, fontSize: <大小> }
body: { fontFamily: <字体>, fontSize: <大小> }
---
读取为:<页面类型> 面向 <受众>,语言风格为 <氛围>。 <1-2 句话:具体参考,而非形容词。“1970 年代讲义”优于“现代而干净”>
应该做的:<来自简报的上下文肯定项> 不应该做的:<来自简报的上下文否定项>
3. 排版导航 (UX-TYPE-01,严格)
排版从内容节奏和可读性开始,而非装饰。
层级标题缩放
眼镜层级 -> 2rem / 1.5rem / 1.25rem # <3 级远读
手机 -> 1.75rem / 1.375rem / 1.125rem
文本 -> 0.875rem - 1rem # 桌面和移动设备
- 标题:具有明显大小对比的
font-weight: 600或700。永远不要使用font-weight: 300作为主要标题——除非您正在设计一个特定的、命名的奢侈品/时尚品牌以及配色方案。 - 正文:
font-weight: 400,行高 1.5–1.75。 - 在桌面端使用
line-clamp限制长文本。
断行(每当文本包装时均要求)
对于任何包装的文本元素(标题、描述、按钮标签),检查断行质量:
- 孤字预防:标题中任何一行至少要有 4 个字符(韩语 3 个)。
- 短描述符类别:英雄副标题、卡片描述——使用
text-wrap: balance而非pretty。 -webkit-line-clamp冲突:如果使用clamp,balance无效——通过调整元素宽度或内容进行手动检查。- 有关完整规则,请阅读
references/typography-line-breaks.md。
字体系列惯例
- 仅使用系统字体堆栈或通过
@import加载的单个 Google Font。 - 韩语文本:使用适合中文/韩语 CVC 音节的字体。“Noto Sans KR”是安全的默认值。
- 衬线字体:仅在具有编辑理由时使用(长格式文章、引文或排他性品牌标识)。
- 等宽字体:仅用于代码、数据或 UI 中的数字对齐。
布局布线宏结构
对于任何新页面,从以下选项中选择一个组合:
| 模式 | 何时选择 |
|---|---|
| 全宽英雄区 | 第一次访问、品牌视觉 |
| 侧边栏 + 主要内容 | 多层级信息、密集任务 |
| 卡片网格 | 异构内容、浏览 |
| 交错/杂志 | 长篇叙事、编辑叙事 |
| 列表/表格 | 数据密集型屏幕、管理面板 |
更多模式:references/layout-macrostructures.md。
修复:规则冲突或歧义
如果本文件中的任何规则与 ima2-front/SKILL.md 或其参考文件冲突:
- 如果存在密切相关的
ima2-front规则类(FE-),则ima2-front的标记规则获胜。 - 如果存在冲突的 UX 规则类(UX-),则较严格的规则获胜,除非较宽松的规则是最近的修改(由
ima2 status或ima2 skill log的哈希决定)。 - 如果存在产品级别歧义,则搜索对话历史记录以查找设计系统基线的先前描述。
如果仍有疑问,请搜索该子系统的网络或生成两个变体(但仅在询问用户后)。
变更日志
| 版本 | 日期 | 更改 |
|---|---|---|
| 2.1.0 | 2026-07-09 | 添加 Organic Capsule 参考;更新 Liquid Editorial 默认方向的工具包内容;修复 UX-DEFAULT-ISM-01 中的应用门控语言使其明确为后备方案 |
| 2.0.0 | 2026-06-30 | 主要重写:模块化参考系统、意图发现协议、严格角色分离、断行规则 (UX-TYPE-01) |