[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MG370B26MZF269PME7TDPN":3,"skill-same:01M6MG370B26MZF269PME7TDPN":50},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":21,"linkOnly":22,"markdownContent":23,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M6MG370B26MZF269PME7TDPN","interaction-specification",null,"hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fui-designer\u002Finteraction-specification\u002FSKILL.md",[],[18,19,20],"specification","interaction","interaction specification","2026-11-10 10:12:30",false,"---\n\nname: ui-designer\u002Finteraction-specification\ndescription: 交互规范方法论，基于 Laws of UX、Material Design Motion、HIG 等开源原则，定义加载\u002F空状态、反馈层级、微交互、手势与无障碍交互\nversion: 2.0.0\nagent: ui-designer\ntype: methodology\nuser-invocable: false\nagent-invocable: true\ndependencies:\n- ui-designer\u002Fdesign-system\n  triggers:\n- 需要定义交互行为时\n- 需要处理边界情况时\n- 需要确保无障碍访问时\n  metadata:\n  internal: true\n  references:\n  - \"Laws of UX (Jon Yablonski): https:\u002F\u002Flawsofux.com\u002F\"\n  - \"Material Design Motion: https:\u002F\u002Fm3.material.io\u002Fstyles\u002Fmotion\"\n  - \"Apple HIG - Motion: https:\u002F\u002Fdeveloper.apple.com\u002Fdesign\u002Fhuman-interface-guidelines\u002Fmotion\"\n  - \"WAI-ARIA Authoring Practices: https:\u002F\u002Fwww.w3.org\u002FWAI\u002FARIA\u002Fapg\u002F\"\n  - \"Refactoring UI - Feedback: https:\u002F\u002Fwww.refactoringui.com\u002F\"\n\n---\n\n# 交互规范方法论\n\n## 适用场景\n\n定义用户与界面的交互细节。核心原则：**每一个用户操作都必须有明确、即时、可理解的反馈**；每一个系统状态都必须有对应的展示方式。\n\n## 交互设计核心定律（Laws of UX）\n\n在设计交互时，始终考虑以下定律：\n\n| 定律               | 含义                     | 交互应用                                 |\n| ------------------ | ------------------------ | ---------------------------------------- |\n| **Fitts 定律**     | 目标越大、越近，点击越快 | 常用操作放在拇指可达区；按钮足够大       |\n| **Hick 定律**      | 选项越多，决策越慢       | 减少每次呈现的选项数；分步引导           |\n| **Jakob 定律**     | 用户期望一致性           | 遵循平台惯例和用户已有心智模型           |\n| **Miller 定律**    | 工作记忆 7±2 项          | 分组、分页，不要一次塞太多               |\n| **Tesler 定律**    | 复杂度守恒               | 把复杂度从用户转移到系统，不要让用户承担 |\n| **Parkinson 定律** | 工作会填满可用时间       | 限制功能范围，保持聚焦                   |\n| **峰终定律**       | 用户记住峰值和结尾       | 确保关键时刻体验出色                     |\n\n---\n\n## 反馈层级（Feedback Hierarchy）\n\n用户操作后，根据**影响范围**和**紧急程度**选择反馈方式。不要所有操作都弹 Toast。\n\n| 层级             | 方式             | 适用场景                     | 持续时间      |\n| ---------------- | ---------------- | ---------------------------- | ------------- |\n| **L1: 内联反馈** | 组件自身状态变化 | 按钮按下、输入聚焦、勾选成功 | 即时，无持续  |\n| **L2: Toast**    | 轻量通知         | 操作成功、轻微警告           | 3-5s 自动消失 |\n| **L3: Banner**   | 顶部横幅         | 需要用户注意但不阻塞         | 可手动关闭    |\n| **L4: Modal**    | 模态确认         | 危险操作、需要决策           | 直到用户响应  |\n| **L5: 全屏**     | 整页状态         | 加载、错误、空状态           | 直到状态改变  |\n\n**原则**：能用 L1 就不用 L2，能用 L2 就不用 L3。高优先级操作（删除）才用 L4。\n\n### Toast 设计\n\n```\n┌─────────────────────────────────┐\n│  [✓]  操作成功        [×]       │\n└─────────────────────────────────┘\n```\n\n| 属性     | 值                            |\n| -------- | ----------------------------- |\n| 高度     | 48px                          |\n| 内边距   | 12px 16px                     |\n| 圆角     | `radius-md` (8px)             |\n| 阴影     | `shadow-lg`                   |\n| 最大宽度 | 420px                         |\n| 位置     | 顶部居中（距顶 24px）或右下角 |\n\n**Toast 类型**：\n\n| 类型    | 颜色 | 图标 | 时长            | 示例                 |\n| ------- | ---- | ---- | --------------- | -------------------- |\n| Success | 绿   | ✓    | 3s              | 「保存成功」         |\n| Info    | 蓝   | ℹ    | 3s              | 「已复制到剪贴板」   |\n| Warning | 橙   | ⚠    | 4s              | 「存储空间不足」     |\n| Error   | 红   | ✕    | 5s 或不自动消失 | 「网络错误，请重试」 |\n\n**Toast 原则**：\n- 不要放需要用户操作的内容（放 Modal）\n- 不要同时显示多个 Toast（队列或合并）\n- Error Toast 不自动消失，让用户有时间阅读\n- 有 `aria-live=\"polite\"` 让屏幕阅读器播报\n\n---\n\n## 加载状态\n\n### 加载策略决策\n\n根据**预期等待时间**选择加载方式：\n\n| 等待时间   | 方式                  | 说明                       |\n| ---------- | --------------------- | -------------------------- |\n| \u003C 100ms    | 无反馈                | 人类感知不到延迟           |\n| 100ms - 1s | Spinner \u002F 骨架屏      | 快速操作，不要让用户觉得卡 |\n| 1s - 5s    | 进度条 + 状态文字     | 告诉用户正在做什么         |\n| > 5s       | 分阶段进度 + 预估时间 | 让用户知道还要等多久       |\n\n> **原则**（来自 Nielsen Norman Group）：超过 1 秒必须给反馈，超过 10 秒必须给进度指示。\n\n### 加载场景\n\n| 场景         | 方式                           | 视觉                           |\n| ------------ | ------------------------------ | ------------------------------ |\n| 页面首次加载 | 骨架屏（Skeleton）             | 灰色占位块模拟内容结构         |\n| 按钮提交     | 按钮内 Spinner                 | 按钮文字变「提交中」+ 旋转图标 |\n| 列表加载更多 | 底部 Spinner                   | 「加载中...」文字              |\n| 局部刷新     | 区域内 Spinner \u002F 脉冲          | 不影响其他区域                 |\n| 搜索         | 输入框内 Spinner（延迟 300ms） | 避免每次按键都显示             |\n| 文件上传     | 进度条 + 百分比                | 显示已上传 \u002F 总大小            |\n\n### 骨架屏设计\n\n```\n┌──────────────────────────────────┐\n│  ████████                         │  ← 标题占位（比真实标题短）\n│  █████████████                    │  ← 描述占位\n│                                  │\n│  ████  ████████████████           │  ← 列表项\n│  ████  ████████████████           │\n│  ████  ████████████████           │\n└──────────────────────────────────┘\n```\n\n- 模拟真实内容的**结构和比例**，不是随机色块\n- 使用 `neutral-100` 背景 + shimmer 动画（1.5s 循环）\n- 不要在骨架屏上显示真实数据占位符\n- 加载完成后内容直接显示，不要先消失再出现\n\n---\n\n## 空状态\n\n空状态不是「没有内容」，而是**引导用户下一步行动**的机会。\n\n### 空状态类型与设计\n\n| 类型       | 原因               | 设计重点                         |\n| ---------- | ------------------ | -------------------------------- |\n| **初始空** | 用户从未创建过内容 | 引导创建：插图 + 说明 + CTA 按钮 |\n| **搜索空** | 搜索无结果         | 建议：检查关键词、清除筛选       |\n| **错误空** | 网络\u002F权限错误      | 解决：重试按钮、联系支持         |\n| **权限空** | 无权访问           | 告知：需要什么权限、如何申请     |\n| **删除空** | 内容已被删除       | 恢复：撤销按钮（30s 内）         |\n\n### 空状态结构\n\n```\n┌─────────────────────────────────────┐\n│                                     │\n│            [插图\u002F图标]               │  ← 视觉锚点（非装饰）\n│                                     │\n│           主标题（一句话）           │  ← 说明发生了什么\n│      副标题（为什么 \u002F 怎么办）       │  ← 引导下一步\n│                                     │\n│         [主操作按钮]                 │  ← 明确的行动号召\n│                                     │\n└─────────────────────────────────────┘\n```\n\n**原则**：\n- 插图与场景相关，不要用通用的「空盒子」图标\n- 主标题不超过 12 字，副标题不超过 30 字\n- 必须有 CTA 按钮（除非是权限\u002F错误，提供「返回」或「重试」）\n- 语气友好，不指责用户（不说「你没有数据」，说「开始创建你的第一个项目吧」）\n\n---\n\n## 错误处理\n\n### 错误信息三要素\n\n每个错误必须回答：**出了什么问题？为什么？怎么解决？**\n\n```\n┌─────────────────────────────────────────┐\n│ ⚠ 保存失败                                │  ← 问题\n│ 网络连接中断，请检查网络后重试             │  ← 原因 + 解决\n│                              [重试]       │  ← 行动\n└─────────────────────────────────────────┘\n```\n\n### 错误信息写作原则\n\n- **说人话**：不要显示「Error 500」或堆栈跟踪\n- **给方案**：不只说「失败」，要说「请重试」或「联系管理员」\n- **可恢复**：提供撤销、重试、返回等操作\n- **不指责**：不说「你输入错误」，说「请输入有效的邮箱地址」\n\n> **参考**：Apple HIG 要求错误信息用友好语气，避免技术术语。\n\n---\n\n## 微交互（Micro-interactions）\n\n微交互是**小而有意义的反馈**，让界面感觉有生命。\n\n### 微交互四要素（Dan Saffer）\n\n1. **触发（Trigger）**：什么启动了交互？（用户操作 \u002F 系统状态）\n2. **规则（Rules）**：交互如何进行？\n3. **反馈（Feedback）**：用户看到\u002F听到什么？\n4. **循环（Loops & Modes）**：交互如何结束？是否进入新模式？\n\n### 常见微交互\n\n| 触发          | 反馈                        | 时长  | 缓动        |\n| ------------- | --------------------------- | ----- | ----------- |\n| 按钮 hover    | 背景色加深 + cursor:pointer | 150ms | ease-out    |\n| 按钮按下      | scale(0.98) + 背景加深      | 100ms | ease-out    |\n| 卡片 hover    | 阴影加深 + translateY(-2px) | 200ms | ease-out    |\n| 勾选 checkbox | ✓ 图标弹出动画              | 200ms | spring      |\n| 开关切换      | 圆点滑动 + 背景色变化       | 200ms | ease-in-out |\n| 收藏按钮      | 心形放大 + 粒子效果         | 300ms | spring      |\n| 下拉刷新      | 箭头旋转 + 刷新图标         | 300ms | ease-in-out |\n\n### 微交互原则\n\n- **即时**：操作后 100ms 内必须有反馈\n- **克制**：不是每个元素都需要动效\n- **可逆**：动画可以反向播放（关闭 = 打开的反向）\n- **尊重偏好**：`prefers-reduced-motion` 时禁用非必要动画\n\n---\n\n## 动效规范\n\n### 页面过渡\n\n| 场景       | 动效        | 参数                                           |\n| ---------- | ----------- | ---------------------------------------------- |\n| 页面进入   | 淡入 + 上移 | 300ms ease-out, opacity 0→1, translateY(8px)→0 |\n| 页面退出   | 淡出        | 200ms ease-in, opacity 1→0                     |\n| 列表项进入 | 错峰淡入    | 每项延迟 50ms, 200ms ease-out                  |\n\n### 容器变换\n\n| 场景        | 动效        | 参数                                       |\n| ----------- | ----------- | ------------------------------------------ |\n| Modal 出现  | 淡入 + 缩放 | 250ms ease-out, scale(0.95)→1, opacity 0→1 |\n| Modal 消失  | 淡出 + 缩放 | 200ms ease-in, scale 1→0.95, opacity 1→0   |\n| Drawer 出现 | 滑入        | 300ms ease-out, translateX(-100%)→0        |\n| Drawer 消失 | 滑出        | 250ms ease-in, translateX 0→(-100%)        |\n| 展开\u002F收起   | 高度动画    | 250ms ease-in-out                          |\n\n> **参考**：Material Design 3 的「Shared axis」「Fade」「Container transform」三种过渡模式可根据场景选用。\n\n---\n\n## 手势设计（移动端）\n\n### 触控目标\n\n- **最小**：44×44px（HIG）\u002F 48×48dp（Material Design）\n- **推荐**：48×48px，相邻元素间距 ≥ 8px\n- **拇指热区**：屏幕底部 1\u002F3 区域最易操作\n\n### 手势映射\n\n| 手势     | 用途                    | 注意                              |\n| -------- | ----------------------- | --------------------------------- |\n| **点击** | 选择、激活              | 必须有视觉反馈（ripple 或 scale） |\n| **长按** | 上下文菜单、多选        | 必须有触觉反馈（haptic）          |\n| **滑动** | 列表项操作（删除\u002F归档） | 必须可撤销、有视觉提示            |\n| **下拉** | 刷新                    | 必须有 loading 指示               |\n| **捏合** | 缩放图片\u002F地图           | 必须支持双击重置                  |\n| **拖拽** | 排序、移动              | 必须有拖拽中视觉反馈              |\n\n> **原则**：手势是快捷方式，不是唯一途径。每个手势操作都必须有对应的按钮操作（无障碍）。\n\n---\n\n## 键盘导航\n\n### 焦点顺序\n\n- Tab 顺序遵循**视觉阅读顺序**（左到右、上到下）\n- 不要用 tabindex > 0 破坏自然顺序（用 DOM 顺序控制）\n- 模态框打开时**锁定焦点**在框内\n\n### 快捷键\n\n| 按键                | 功能                       |\n| ------------------- | -------------------------- |\n| `Tab` \u002F `Shift+Tab` | 前后导航                   |\n| `Enter`             | 激活按钮、链接、提交       |\n| `Space`             | 切换 checkbox\u002Fradio\u002Fswitch |\n| `Esc`               | 关闭弹窗、下拉、取消       |\n| `↑` `↓` `←` `→`     | 列表、菜单、标签页导航     |\n| `Home` \u002F `End`      | 列表首尾                   |\n| `Cmd\u002FCtrl + Enter`  | 表单提交（可选便利键）     |\n\n### 焦点样式\n\n```css\n:focus-visible {\n  outline: 2px solid var(--primary-500);\n  outline-offset: 2px;\n  border-radius: 4px;\n}\n```\n\n- 用 `:focus-visible` 而非 `:focus`（鼠标点击不显示，键盘显示）\n- 不要用 `outline: none` 而不提供替代\n- 焦点环颜色与背景对比度 ≥ 3:1\n\n---\n\n## 屏幕阅读器\n\n### ARIA 使用原则\n\n1. **优先用语义元素**：`\u003Cbutton>` 优于 `\u003Cdiv role=\"button\">`\n2. **ARIA 只在语义不足时使用**：不要给原生元素加多余 ARIA\n3. **`aria-label` 用于无文字的图标按钮**\n4. **`aria-live` 用于动态内容更新**\n\n### 关键 ARIA 模式\n\n| 组件     | ARIA                                                  |\n| -------- | ----------------------------------------------------- |\n| 图标按钮 | `aria-label=\"删除\"`                                   |\n| 加载中   | `aria-busy=\"true\"`                                    |\n| 错误提示 | `aria-live=\"polite\"` + `aria-describedby`             |\n| 模态框   | `role=\"dialog\"` `aria-modal=\"true\"` `aria-labelledby` |\n| Tab 切换 | `role=\"tablist\"` `role=\"tab\"` `aria-selected`         |\n| 折叠面板 | `aria-expanded` `aria-controls`                       |\n\n---\n\n## 响应式交互\n\n| 断点              | 交互调整                                   |\n| ----------------- | ------------------------------------------ |\n| `\u003C 640px` 手机    | 全屏弹窗、底部抽屉、大触控目标、手势操作   |\n| `640-1024px` 平板 | 侧边抽屉、适中触控目标、悬停+点击          |\n| `> 1024px` 桌面   | 居中弹窗、悬停效果、键盘快捷键、小触控目标 |\n\n**移动端特有**：\n- 弹窗从底部滑入（Bottom Sheet），不是居中\n- 操作按钮放在屏幕底部（拇指可达）\n- 表单输入时键盘弹出，确保输入框可见（scroll into view）\n- 不要依赖 hover（移动端没有 hover）\n\n---\n\n## 自检清单\n\n- [ ] 每个用户操作都有明确反馈（内联 \u002F Toast \u002F Modal）\n- [ ] 加载策略按等待时间分级（\u003C1s \u002F 1-5s \u002F >5s）\n- [ ] 空状态有插图 + 说明 + CTA 按钮\n- [ ] 错误信息包含：问题 + 原因 + 解决方案\n- [ ] 微交互动效 ≤ 300ms，尊重 `prefers-reduced-motion`\n- [ ] 所有可交互元素键盘可达，焦点可见\n- [ ] 图标按钮有 `aria-label`，动态内容有 `aria-live`\n- [ ] 移动端触控目标 ≥ 44×44px，手势有替代按钮操作\n- [ ] 参考了 Laws of UX 中至少 3 条定律\n\n## 常见误区\n\n❌ **所有操作都弹 Toast** — 大多数反馈应该是内联的（按钮状态变化）\n❌ **加载只用 Spinner** — 长加载必须有进度和预估时间\n❌ **空状态只写「暂无数据」** — 必须引导用户下一步\n❌ **错误信息显示堆栈跟踪** — 用户看不懂，也不安全\n❌ **动效超过 500ms** — 用户会觉得慢，微交互应 \u003C 300ms\n❌ **手势是唯一操作方式** — 必须有对应的按钮操作\n❌ **移除 focus outline** — 键盘用户无法知道焦点在哪\n","# 交互规范方法论\n\n## 适用场景\n\n定义用户与界面的交互细节。核心原则：**每一个用户操作都必须有明确、即时、可理解的反馈**；每一个系统状态都必须有对应的展示方式。\n\n## 交互设计核心定律（Laws of UX）\n\n在设计交互时，始终考虑以下定律：\n\n| 定律               | 含义                     | 交互应用                                 |\n| ------------------ | ------------------------ | ---------------------------------------- |\n| **Fitts 定律**     | 目标越大、越近，点击越快 | 常用操作放在拇指可达区；按钮足够大       |\n| **Hick 定律**      | 选项越多，决策越慢       | 减少每次呈现的选项数；分步引导           |\n| **Jakob 定律**     | 用户期望一致性           | 遵循平台惯例和用户已有心智模型           |\n| **Miller 定律**    | 工作记忆 7±2 项          | 分组、分页，不要一次塞太多               |\n| **Tesler 定律**    | 复杂度守恒               | 把复杂度从用户转移到系统，不要让用户承担 |\n| **Parkinson 定律** | 工作会填满可用时间       | 限制功能范围，保持聚焦                   |\n| **峰终定律**       | 用户记住峰值和结尾       | 确保关键时刻体验出色                     |\n\n---\n\n## 反馈层级（Feedback Hierarchy）\n\n用户操作后，根据**影响范围**和**紧急程度**选择反馈方式。不要所有操作都弹 Toast。\n\n| 层级             | 方式             | 适用场景                     | 持续时间      |\n| ---------------- | ---------------- | ---------------------------- | ------------- |\n| **L1: 内联反馈** | 组件自身状态变化 | 按钮按下、输入聚焦、勾选成功 | 即时，无持续  |\n| **L2: Toast**    | 轻量通知         | 操作成功、轻微警告           | 3-5s 自动消失 |\n| **L3: Banner**   | 顶部横幅         | 需要用户注意但不阻塞         | 可手动关闭    |\n| **L4: Modal**    | 模态确认         | 危险操作、需要决策           | 直到用户响应  |\n| **L5: 全屏**     | 整页状态         | 加载、错误、空状态           | 直到状态改变  |\n\n**原则**：能用 L1 就不用 L2，能用 L2 就不用 L3。高优先级操作（删除）才用 L4。\n\n### Toast 设计\n\n```\n┌─────────────────────────────────┐\n│  [✓]  操作成功        [×]       │\n└─────────────────────────────────┘\n```\n\n| 属性     | 值                            |\n| -------- | ----------------------------- |\n| 高度     | 48px                          |\n| 内边距   | 12px 16px                     |\n| 圆角     | `radius-md` (8px)             |\n| 阴影     | `shadow-lg`                   |\n| 最大宽度 | 420px                         |\n| 位置     | 顶部居中（距顶 24px）或右下角 |\n\n**Toast 类型**：\n\n| 类型    | 颜色 | 图标 | 时长            | 示例                 |\n| ------- | ---- | ---- | --------------- | -------------------- |\n| Success | 绿   | ✓    | 3s              | 「保存成功」         |\n| Info    | 蓝   | ℹ    | 3s              | 「已复制到剪贴板」   |\n| Warning | 橙   | ⚠    | 4s              | 「存储空间不足」     |\n| Error   | 红   | ✕    | 5s 或不自动消失 | 「网络错误，请重试」 |\n\n**Toast 原则**：\n- 不要放需要用户操作的内容（放 Modal）\n- 不要同时显示多个 Toast（队列或合并）\n- Error Toast 不自动消失，让用户有时间阅读\n- 有 `aria-live=\"polite\"` 让屏幕阅读器播报\n\n---\n\n## 加载状态\n\n### 加载策略决策\n\n根据**预期等待时间**选择加载方式：\n\n| 等待时间   | 方式                  | 说明                       |\n| ---------- | --------------------- | -------------------------- |\n| \u003C 100ms    | 无反馈                | 人类感知不到延迟           |\n| 100ms - 1s | Spinner \u002F 骨架屏      | 快速操作，不要让用户觉得卡 |\n| 1s - 5s    | 进度条 + 状态文字     | 告诉用户正在做什么         |\n| > 5s       | 分阶段进度 + 预估时间 | 让用户知道还要等多久       |\n\n> **原则**（来自 Nielsen Norman Group）：超过 1 秒必须给反馈，超过 10 秒必须给进度指示。\n\n### 加载场景\n\n| 场景         | 方式                           | 视觉                           |\n| ------------ | ------------------------------ | ------------------------------ |\n| 页面首次加载 | 骨架屏（Skeleton）             | 灰色占位块模拟内容结构         |\n| 按钮提交     | 按钮内 Spinner                 | 按钮文字变「提交中」+ 旋转图标 |\n| 列表加载更多 | 底部 Spinner                   | 「加载中...」文字              |\n| 局部刷新     | 区域内 Spinner \u002F 脉冲          | 不影响其他区域                 |\n| 搜索         | 输入框内 Spinner（延迟 300ms） | 避免每次按键都显示             |\n| 文件上传     | 进度条 + 百分比                | 显示已上传 \u002F 总大小            |\n\n### 骨架屏设计\n\n```\n┌──────────────────────────────────┐\n│  ████████                         │  ← 标题占位（比真实标题短）\n│  █████████████                    │  ← 描述占位\n│                                  │\n│  ████  ████████████████           │  ← 列表项\n│  ████  ████████████████           │\n│  ████  ████████████████           │\n└──────────────────────────────────┘\n```\n\n- 模拟真实内容的**结构和比例**，不是随机色块\n- 使用 `neutral-100` 背景 + shimmer 动画（1.5s 循环）\n- 不要在骨架屏上显示真实数据占位符\n- 加载完成后内容直接显示，不要先消失再出现\n\n---\n\n## 空状态\n\n空状态不是「没有内容」，而是**引导用户下一步行动**的机会。\n\n### 空状态类型与设计\n\n| 类型       | 原因               | 设计重点                         |\n| ---------- | ------------------ | -------------------------------- |\n| **初始空** | 用户从未创建过内容 | 引导创建：插图 + 说明 + CTA 按钮 |\n| **搜索空** | 搜索无结果         | 建议：检查关键词、清除筛选       |\n| **错误空** | 网络\u002F权限错误      | 解决：重试按钮、联系支持         |\n| **权限空** | 无权访问           | 告知：需要什么权限、如何申请     |\n| **删除空** | 内容已被删除       | 恢复：撤销按钮（30s 内）         |\n\n### 空状态结构\n\n```\n┌─────────────────────────────────────┐\n│                                     │\n│            [插图\u002F图标]               │  ← 视觉锚点（非装饰）\n│                                     │\n│           主标题（一句话）           │  ← 说明发生了什么\n│      副标题（为什么 \u002F 怎么办）       │  ← 引导下一步\n│                                     │\n│         [主操作按钮]                 │  ← 明确的行动号召\n│                                     │\n└─────────────────────────────────────┘\n```\n\n**原则**：\n- 插图与场景相关，不要用通用的「空盒子」图标\n- 主标题不超过 12 字，副标题不超过 30 字\n- 必须有 CTA 按钮（除非是权限\u002F错误，提供「返回」或「重试」）\n- 语气友好，不指责用户（不说「你没有数据」，说「开始创建你的第一个项目吧」）\n\n---\n\n## 错误处理\n\n### 错误信息三要素\n\n每个错误必须回答：**出了什么问题？为什么？怎么解决？**\n\n```\n┌─────────────────────────────────────────┐\n│ ⚠ 保存失败                                │  ← 问题\n│ 网络连接中断，请检查网络后重试             │  ← 原因 + 解决\n│                              [重试]       │  ← 行动\n└─────────────────────────────────────────┘\n```\n\n### 错误信息写作原则\n\n- **说人话**：不要显示「Error 500」或堆栈跟踪\n- **给方案**：不只说「失败」，要说「请重试」或「联系管理员」\n- **可恢复**：提供撤销、重试、返回等操作\n- **不指责**：不说「你输入错误」，说「请输入有效的邮箱地址」\n\n> **参考**：Apple HIG 要求错误信息用友好语气，避免技术术语。\n\n---\n\n## 微交互（Micro-interactions）\n\n微交互是**小而有意义的反馈**，让界面感觉有生命。\n\n### 微交互四要素（Dan Saffer）\n\n1. **触发（Trigger）**：什么启动了交互？（用户操作 \u002F 系统状态）\n2. **规则（Rules）**：交互如何进行？\n3. **反馈（Feedback）**：用户看到\u002F听到什么？\n4. **循环（Loops & Modes）**：交互如何结束？是否进入新模式？\n\n### 常见微交互\n\n| 触发          | 反馈                        | 时长  | 缓动        |\n| ------------- | --------------------------- | ----- | ----------- |\n| 按钮 hover    | 背景色加深 + cursor:pointer | 150ms | ease-out    |\n| 按钮按下      | scale(0.98) + 背景加深      | 100ms | ease-out    |\n| 卡片 hover    | 阴影加深 + translateY(-2px) | 200ms | ease-out    |\n| 勾选 checkbox | ✓ 图标弹出动画              | 200ms | spring      |\n| 开关切换      | 圆点滑动 + 背景色变化       | 200ms | ease-in-out |\n| 收藏按钮      | 心形放大 + 粒子效果         | 300ms | spring      |\n| 下拉刷新      | 箭头旋转 + 刷新图标         | 300ms | ease-in-out |\n\n### 微交互原则\n\n- **即时**：操作后 100ms 内必须有反馈\n- **克制**：不是每个元素都需要动效\n- **可逆**：动画可以反向播放（关闭 = 打开的反向）\n- **尊重偏好**：`prefers-reduced-motion` 时禁用非必要动画\n\n---\n\n## 动效规范\n\n### 页面过渡\n\n| 场景       | 动效        | 参数                                           |\n| ---------- | ----------- | ---------------------------------------------- |\n| 页面进入   | 淡入 + 上移 | 300ms ease-out, opacity 0→1, translateY(8px)→0 |\n| 页面退出   | 淡出        | 200ms ease-in, opacity 1→0                     |\n| 列表项进入 | 错峰淡入    | 每项延迟 50ms, 200ms ease-out                  |\n\n### 容器变换\n\n| 场景        | 动效        | 参数                                       |\n| ----------- | ----------- | ------------------------------------------ |\n| Modal 出现  | 淡入 + 缩放 | 250ms ease-out, scale(0.95)→1, opacity 0→1 |\n| Modal 消失  | 淡出 + 缩放 | 200ms ease-in, scale 1→0.95, opacity 1→0   |\n| Drawer 出现 | 滑入        | 300ms ease-out, translateX(-100%)→0        |\n| Drawer 消失 | 滑出        | 250ms ease-in, translateX 0→(-100%)        |\n| 展开\u002F收起   | 高度动画    | 250ms ease-in-out                          |\n\n> **参考**：Material Design 3 的「Shared axis」「Fade」「Container transform」三种过渡模式可根据场景选用。\n\n---\n\n## 手势设计（移动端）\n\n### 触控目标\n\n- **最小**：44×44px（HIG）\u002F 48×48dp（Material Design）\n- **推荐**：48×48px，相邻元素间距 ≥ 8px\n- **拇指热区**：屏幕底部 1\u002F3 区域最易操作\n\n### 手势映射\n\n| 手势     | 用途                    | 注意                              |\n| -------- | ----------------------- | --------------------------------- |\n| **点击** | 选择、激活              | 必须有视觉反馈（ripple 或 scale） |\n| **长按** | 上下文菜单、多选        | 必须有触觉反馈（haptic）          |\n| **滑动** | 列表项操作（删除\u002F归档） | 必须可撤销、有视觉提示            |\n| **下拉** | 刷新                    | 必须有 loading 指示               |\n| **捏合** | 缩放图片\u002F地图           | 必须支持双击重置                  |\n| **拖拽** | 排序、移动              | 必须有拖拽中视觉反馈              |\n\n> **原则**：手势是快捷方式，不是唯一途径。每个手势操作都必须有对应的按钮操作（无障碍）。\n\n---\n\n## 键盘导航\n\n### 焦点顺序\n\n- Tab 顺序遵循**视觉阅读顺序**（左到右、上到下）\n- 不要用 tabindex > 0 破坏自然顺序（用 DOM 顺序控制）\n- 模态框打开时**锁定焦点**在框内\n\n### 快捷键\n\n| 按键                | 功能                       |\n| ------------------- | -------------------------- |\n| `Tab` \u002F `Shift+Tab` | 前后导航                   |\n| `Enter`             | 激活按钮、链接、提交       |\n| `Space`             | 切换 checkbox\u002Fradio\u002Fswitch |\n| `Esc`               | 关闭弹窗、下拉、取消       |\n| `↑` `↓` `←` `→`     | 列表、菜单、标签页导航     |\n| `Home` \u002F `End`      | 列表首尾                   |\n| `Cmd\u002FCtrl + Enter`  | 表单提交（可选便利键）     |\n\n### 焦点样式\n\n```css\n:focus-visible {\n  outline: 2px solid var(--primary-500);\n  outline-offset: 2px;\n  border-radius: 4px;\n}\n```\n\n- 用 `:focus-visible` 而非 `:focus`（鼠标点击不显示，键盘显示）\n- 不要用 `outline: none` 而不提供替代\n- 焦点环颜色与背景对比度 ≥ 3:1\n\n---\n\n## 屏幕阅读器\n\n### ARIA 使用原则\n\n1. **优先用语义元素**：`\u003Cbutton>` 优于 `\u003Cdiv role=\"button\">`\n2. **ARIA 只在语义不足时使用**：不要给原生元素加多余 ARIA\n3. **`aria-label` 用于无文字的图标按钮**\n4. **`aria-live` 用于动态内容更新**\n\n### 关键 ARIA 模式\n\n| 组件     | ARIA                                                  |\n| -------- | ----------------------------------------------------- |\n| 图标按钮 | `aria-label=\"删除\"`                                   |\n| 加载中   | `aria-busy=\"true\"`                                    |\n| 错误提示 | `aria-live=\"polite\"` + `aria-describedby`             |\n| 模态框   | `role=\"dialog\"` `aria-modal=\"true\"` `aria-labelledby` |\n| Tab 切换 | `role=\"tablist\"` `role=\"tab\"` `aria-selected`         |\n| 折叠面板 | `aria-expanded` `aria-controls`                       |\n\n---\n\n## 响应式交互\n\n| 断点              | 交互调整                                   |\n| ----------------- | ------------------------------------------ |\n| `\u003C 640px` 手机    | 全屏弹窗、底部抽屉、大触控目标、手势操作   |\n| `640-1024px` 平板 | 侧边抽屉、适中触控目标、悬停+点击          |\n| `> 1024px` 桌面   | 居中弹窗、悬停效果、键盘快捷键、小触控目标 |\n\n**移动端特有**：\n- 弹窗从底部滑入（Bottom Sheet），不是居中\n- 操作按钮放在屏幕底部（拇指可达）\n- 表单输入时键盘弹出，确保输入框可见（scroll into view）\n- 不要依赖 hover（移动端没有 hover）\n\n---\n\n## 自检清单\n\n- [ ] 每个用户操作都有明确反馈（内联 \u002F Toast \u002F Modal）\n- [ ] 加载策略按等待时间分级（\u003C1s \u002F 1-5s \u002F >5s）\n- [ ] 空状态有插图 + 说明 + CTA 按钮\n- [ ] 错误信息包含：问题 + 原因 + 解决方案\n- [ ] 微交互动效 ≤ 300ms，尊重 `prefers-reduced-motion`\n- [ ] 所有可交互元素键盘可达，焦点可见\n- [ ] 图标按钮有 `aria-label`，动态内容有 `aria-live`\n- [ ] 移动端触控目标 ≥ 44×44px，手势有替代按钮操作\n- [ ] 参考了 Laws of UX 中至少 3 条定律\n\n## 常见误区\n\n❌ **所有操作都弹 Toast** — 大多数反馈应该是内联的（按钮状态变化）\n❌ **加载只用 Spinner** — 长加载必须有进度和预估时间\n❌ **空状态只写「暂无数据」** — 必须引导用户下一步\n❌ **错误信息显示堆栈跟踪** — 用户看不懂，也不安全\n❌ **动效超过 500ms** — 用户会觉得慢，微交互应 \u003C 300ms\n❌ **手势是唯一操作方式** — 必须有对应的按钮操作\n❌ **移除 focus outline** — 键盘用户无法知道焦点在哪\n",{},"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fui-designer\u002Finteraction-specification",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":7,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interaction-specification",{"tool":42,"command":43},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interaction-specification",{"tool":45,"command":46},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill interaction-specification","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fui-designer\u002Finteraction-specification\u002FSKILL.md",true,[],[51,61,69,77,85,93],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":56,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":60},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":65,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":60},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":60},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":60},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":60},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":55,"licenseFileUrl":97,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":60},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]