# UX UI Principles Audit

> 当需要拿一份界面/屏幕/用户流去对照研究支撑的 UX/UI 原则做体检、找反模式（UX 异味）并产出带严重度与修复建议的审计报告时使用；不适用于从零做视觉稿、纯前端实现或无界面描述的拍脑袋评审；触发词：UX 审计、界面体检、反模式、UX 异味、可用性评估、AI 界面审查、用户流检查

- Skill: `findscripter/ux-ui-principles-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add findscripter/ux-ui-principles-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/findscripter/ux-ui-principles-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- License: MIT
- Author: findscripter (https://skillmd.com/u/findscripter)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/findscripter/ux-ui-principles-audit

---

## 何时使用

- 已有可描述的界面、屏幕或用户流（截图说明、组件清单、交互文字稿、线框图描述均可），要对照研究支撑的 UX/UI 原则做体检。
- 目标是：检出反模式（UX 异味）、判断是否违背最佳实践、给每条发现标严重度并附可落地的修复建议。
- 覆盖四类专项视角：① 通用界面评估（对照 168 条原则）；② 反模式/异味检测；③ AI 驱动界面的信任·透明·安全审查（44 条 AI 时代原则）；④ 用户流的决策·错误·反馈检查。

不该用的边界：
- 从零做视觉设计、出 UI 稿或品牌 logo → 这是创作不是审计，本技能只评不画。
- 写前端代码、改组件实现 → 交给前端实现类技能；本技能产出修复建议，不落代码。
- 没有任何界面/流程描述、只是空谈设计理念 → 缺少评估对象，先索要界面描述再开工。
- 设计令牌/组件库体系搭建 → 用 `ui-design-system-builder`。

## 步骤 / 指令

```
1. 选评估视角（可多选）
   - 整体界面体检        → 168 条原则评估
   - 专挑坏味道          → 反模式/异味检测
   - AI 产品界面          → 44 条 AI 时代原则（信任/透明/可控/安全）
   - 多步流程            → 用户流的决策点、错误处理、反馈检查

2. 固定评估对象（缺则向用户索要）
   - 界面：屏幕/组件清单 + 关键交互文字描述。
   - 用户流：起点→各步→分支→终点，标出错误分支与反馈点。
   - 若有上线 URL/原型，请用户提供截图或文字描述（本技能不抓取页面）。

3. 逐条对照原则扫描，每条发现给结构化条目：
   - [严重度] 位置/组件 — 问题一句话（违背了哪条原则/属哪种反模式）
   - 原因：为什么是问题（对用户的后果）
   - 修复：可直接采用的改法（具体到布局/文案/交互）

4. 严重度分级
   - Critical：阻断任务、误导决策、无障碍硬伤、AI 误导用户。必改。
   - Major：明显增加认知负荷或出错率的反模式。建议改。
   - Minor：打磨项（措辞、一致性、视觉层级）。可选。

5. 汇总输出
   - 先 Critical/Major 后 Minor；同类反模式合并归组。
   - 无问题项明确说"未发现该类问题"，不要凑数编造。
   - 不确定的标"待确认"并写出假设，不冒充事实。
```

规则：
- 单一职责：只审计评估，不顺手改设计、不落前端代码。
- 每条发现可定位（指明组件/步骤）且可执行（带具体改法）。
- 无障碍相关（对比度、键盘可达、屏幕阅读器、点击区）按 Critical/Major 处理并显式点名。
- AI 界面额外查：是否标明 AI 生成、是否可纠错/可撤销、是否暴露不确定性、是否有越权/幻觉风险提示。

## 示例

最小审计提示词：
```
对照研究支撑的 UX/UI 原则与反模式清单，审计以下界面。
每条发现：[严重度] 位置/组件 — 违背的原则/反模式；原因（对用户后果）；可执行修复。
先 Critical/Major 后 Minor；无问题请明说，勿编造。
<贴入界面/用户流描述>
```

输出条目样例：
```
[Critical] 结账页·主按钮 — 暗模式（confirmshaming）：取消按钮文案"我不想省钱"
原因：用情绪施压诱导，违背用户自主与诚实原则，损害信任。
修复：取消按钮改中性文案"暂不"，与主按钮视觉权重对等。

[Major] AI 摘要卡片 — 未标注内容由 AI 生成，且无纠错入口
原因：违背 AI 透明与可控原则，用户无法判断可信度、无法反馈错误。
修复：加"AI 生成"标签 + "报告问题/重新生成"操作。

[Minor] 表单·错误提示 — 仅靠红色传达错误，无文字/图标
原因：色盲用户无法感知，弱化无障碍。
修复：错误项补图标 + 明确文案，不单纯依赖颜色。
```

## 注意事项

- 本技能不抓取/渲染页面，只评估用户提供的界面或流程描述；需要看真实页面时让用户给截图或文字稿。
- 原则数量（168 / 44）是来源参照体系，不必逐条复述；按相关性挑出真正命中的问题，避免输出过长失焦。
- 区分"确证反模式"与"主观偏好"，别把风格口味标成 Critical。
- 输出不替代真实可用性测试与专家评审；缺关键输入、权限或成功标准时先停下问清。
- 修复建议要可直接采用：具体到改哪个文案/布局/交互，不要只说"建议优化体验"。

## 互见

- requires：无。
- related：`ux-research-design-toolkit`（把用户研究数据转成设计决策；本技能聚焦成品界面的原则审计，两者一前一后）；`apple-hig-advisor`（苹果 HIG 平台专项审计，本技能是跨平台通用原则）。
- combines_with：`ui-design-system-builder`（审计发现的不一致/无障碍问题，回流到设计令牌与组件体系修复）。

---
采编自 sickn33/antigravity-awesome-skills（MIT），原始来源 uxuiprinciples/agent-skills。