ux-design-review

设计评审（UX 编排器）技能

此技能的工作方式（请先阅读）

这是全面 UX 评审的入口。它是 docs/orchestration-policy.md 的可执行形式——决定运行哪些审查视角、提供哪些视角，以及抑制哪些视角，然后返回一份按优先级排序的报告，而不是一堆单独的审查报告。

它的全部职责是避免两种相反的失误：没有框架地草率给出“看起来不错”的评审，以及不管是否相关都启动仓库中的每项审查（盲目跟风）。

**何时不应使用此技能：**如果用户指定了某个视角（例如“运行无障碍审查”“检查这里是否存在暗黑模式”），请跳过此编排器，直接调用相应技能。明确指定的范围优先于编排。

---

步骤 0 — 确定上下文配置（一次即可）

根据用户提供的信息推断以下内容；仅在某项未知且会影响运行哪些审查时才提问。为本次会话保留这些信息，不要重复询问。

• 是否使用设计系统？如果用户提供了设计令牌、风格指南、组件库、Figma 库、采用主题的组件代码，或提到“我们的设计系统／我们的品牌指南”，则推断为是。否则只询问一次：“你使用的是现有设计系统，还是从头开始设计？”——这是决定跳过哪些审查的最大影响因素。
• 平台——移动端或 Web（决定是否需要考虑移动端适配）。
• 主要任务——用户实际想完成什么（稍后用于解决冲突）。

用一句话说明你将采用的假设。

---

步骤 1 — 确定工作的特征

查看产物并记录符合以下哪些特征：

• 是否包含交互式 UI？（几乎总是如此）
• 是否包含面向用户的文案？
• 是否涉及转化／定价／注册阻力／主动选择／取消？
• 是否包含多个屏幕或对内容进行结构化？
• 是否面向移动端？

---

步骤 2 — 自动运行始终相关的审查视角（Tier A）

只要存在相应特征，就运行以下审查。它们不依赖视觉系统，而且几乎总能发挥作用：

• ux-heuristics-audit — 任何交互式 UI。可用性行为、反馈、错误恢复。
• ux-microcopy-audit — 任何面向用户的文案。清晰度、语气、错误／空状态／CTA 用语。
• ux-dark-patterns-audit — 任何转化／定价／主动选择／取消界面。

这些审查会在未收到提示的情况下运行。设计系统配置不会抑制它们。

每个审查视角都以其可安装技能的 name 命名。仅当相应技能已安装时才调用审查视角；如果未安装某项技能，请在报告的“可用但未运行”部分列出，不要因此阻止流程——此编排器会根据现有审查视角调整运行内容。

---

第 3 步 — 提供依赖上下文的视角（Tier B）

这些视角相关，但应当提供给用户选择，而不是直接执行；如果正在使用设计系统，其中一些还会被禁用。请应用策略中的禁用矩阵：

视角	提供时机	正在使用设计系统时
ux-accessibility-audit	任何 UI	缩小到使用情况——自定义配色组合、焦点顺序、替代文本、标签；不要重新审查令牌调色板
ux-aesthetics-audit	任何视觉 UI	禁用——视觉协调性已有定义
ux-information-architecture-audit	多屏幕／结构化内容	不受影响——提供
ux-mobile-responsiveness-audit	平台 = mobile	不受影响——提供
ux-color（作为视角）	正在定义／更改调色板	禁用——颜色由令牌管理
ux-typography（作为视角）	正在定义／更改字体	禁用——字体由令牌管理
ux-layout-spacing-grids（作为视角）	正在定义／更改间距／网格	禁用——间距由比例管理

请简短、明确地说明禁用原因：“你的设计系统管理颜色、字体和间距，因此我会跳过这些，并检查系统的实际应用情况（实际使用中的无障碍性、IA、文案）。”

然后提供其余选项：“你还希望我检查实际使用中的无障碍性并审查 IA 吗？” 如果用户同意，就执行；否则将它们保留为可选项。

---

第 4 步 — 合并为一份按优先级排列的报告

对不同视角的发现进行去重（如果启发式和无障碍审查都标记了同一个未标注控件，只报告一次，并注明两者）。解决不同视角间的冲突时，以第 0 步中的主要任务为准。输出一份按严重程度排序的列表：

## Design Review — [target]
Context: [platform · design system: yes/no · primary task]
Lenses run: [heuristics, microcopy, …]   Lenses available but not run: [aesthetics, …]

### Critical
- [Issue] — what's wrong → fix. (heuristic / a11y / dark-pattern / …)
### Major
- …
### Minor
- …
### Working well ✓
- …

**Top 3 priorities:** the highest-impact fixes across all lenses.
Offered, not run: accessibility-in-use, IA — say the word and I'll add them.

---

常见的应做／不应做模式

❌ 不应做	✅ 应做
因为工作“涉及 UI”就执行全部七项 UX 审查	自动执行 Tier A；提供 Tier B；跳过设计系统管理的部分
用户有设计系统时，重新审查颜色／字体／间距	明确说明会跳过这些；改为检查实际应用情况
每项审查分别返回一份报告	合并为一份按优先级排列、去重后的列表
用户只要求一个指定视角时仍运行此协调器	直接交由该视角处理（明确指定的范围优先）
因为有设计系统就默默跳过无障碍审查	将其缩小为使用情况检查——绝不要完全省略

---

与策略的关系

此技能是可执行形式的 docs/orchestration-policy.md。如果两者出现任何不一致，以策略为准；请更新此技能，使其与策略保持一致。

来源课程（Uxcel）

这是一个协调器——其核心内容存在于它所路由到的各个视角中。请参阅各项中的来源课程：ux-heuristics-audit、ux-microcopy-audit、ux-dark-patterns-audit、ux-accessibility-audit、ux-aesthetics-audit、ux-information-architecture-audit、ux-mobile-responsiveness-audit。