ux-microcopy-audit

微文案审查技能

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

这是一项评估型技能，会自动运行并审查现有文案，旨在作为生成型技能的验证步骤调用（ux-microcopy 写作技能，以及 typography、dashboard、onboarding 和组件技能都会将其标签和消息交由此技能处理）。

此技能负责文案质量。以下内容明确由其他技能负责：

• 操纵性文案（确认羞辱、虚假紧迫感、内疚感）→ 由暗黑模式审查负责判断意图；标记并转交。
• 文案无障碍细节（替代文本规则、屏幕阅读器行为）→ 由无障碍审查负责；此技能会标记纯语言和清晰度问题，但不处理技术层面的无障碍机制。

范围纪律。 直接调用此技能时（用户指定了此审查），只审查这一项，不要纳入相关审查。只有在编排器（ux-design-review）或生成型技能根据 docs/orchestration-policy.md 调用此技能时，它才会与其他审查视角一同运行；此时它属于 Tier A — 始终相关，自动运行。明确指定的范围始终优先。

---

此技能相较默认行为的改进

默认情况下，文案审查往往流于主观印象（“听起来不错”）且不够全面——会漏掉隐藏文案（错误状态、空状态），也从不检查整个流程中的一致性。此技能会强制执行以下步骤：

1. 建立文案清单——检查所有文案，包括隐藏状态。
2. 使用明确的评估标准——清晰、简洁、以行动为导向、一致、语气契合、包容，而非凭感觉判断。
3. 为每项发现提供改写建议，并标注严重程度。
4. 检查整个流程的一致性，这是单屏审查无法做到的。

---

审查方法（文案清单）

1. 盘点文案。 列出流程或产品中的每一处文本，别漏掉隐藏内容：错误消息、空状态、工具提示、确认消息和通知。
2. 根据下方标准进行评估。 记录截图或位置，方便应用修改。
3. 确定优先级——一次处理一个问题；优先指出对用户影响最大的问题。
4. 提出改写建议，而不只是标记问题。

---

评估标准——检查内容及违规表现

1. 清晰易懂、使用浅白语言

标记条件： 使用行话或过于正式的词语；措辞含糊；文案需要反复阅读。

• ❌ “无法验证身份验证凭据。”
• ✅ “密码不匹配。请重试或重置密码。”

2. 简洁

标记条件： 有赘词；标签包含多个句子；明明 6 个词就能表达，却用了 20 个词。

3. 以行动为导向且具体

标记条件： 使用通用标签（“确定”“是”“提交”“开始”）；行动号召未说明会发生什么或原因。

• ❌ “提交” → ✅ “创建账户”

4. 一致性

标记条件： 同一概念在产品中有不同名称（“安排时间”与“预约”）；按钮动词不一致；术语与平台不匹配（在移动设备上使用“点击”）。每个概念只使用一种说法。

5. 语气契合

标记条件： 语气不符合当前情境——付款出错时开玩笑，欢迎语冷淡或机械，安全操作中使用含糊措辞（“也许”）。语气既要符合品牌，也要契合当下情境。

6. 错误、空状态和成功状态

标记条件： 错误消息指出了问题却没有说明如何解决、责怪用户或使用全大写；空状态一片空白，没有引导用户采取第一个操作；成功后没有确认反馈。

7. 包容性和普遍易懂性

标记条件： 可以使用中性代词时却使用了性别代词；链接缺乏描述性（“点击此处”/“更多”）；只用占位符作为标签。（技术层面的无障碍问题 → 无障碍审查。）

8. 诚实

标记条件： 确认羞辱、制造紧迫感、引发内疚，或使用令人困惑的双重否定。注明问题，并转交暗黑模式审查进行意图分类。

严重性评级

严重性	含义
Critical	文案令人困惑或产生误导——错误发生后没有解决办法、标签导致错误操作，或文案带有操纵性。
Major	存在明显阻碍——CTA 含糊、术语晦涩、同一概念的用词不一致，或敏感时刻的语气不当。
Minor	润色问题——措辞冗长，或表达略显不妥但仍能理解。

---

审核输出格式

## Microcopy Audit — [Screen / Flow]
Context: [product voice · audience · the moment]

### Critical
- [Location] "current copy" → "rewrite" — why. (Criterion)
### Major
- …
### Minor
- …
### Working well ✓
- …

**Consistency notes:** terms used inconsistently across the flow.
**Top 3 rewrites:** highest-impact fixes.

最后提供一致性备注和优先改写建议——调用该内容的生成器或写作者会据此采取行动。

---

如何做好审核

1. 先盘点，包括隐藏状态——最糟糕的文案往往藏在这些地方。
2. 检查整个流程的一致性，不要只单独检查每个屏幕。
3. 直接改写，而不只是标记问题——给出更好的版本。
4. 根据场景调整语气，不要一味遵循统一的品牌风格。
5. 将操纵意图问题交由 dark-patterns 处理，将技术层面的 a11y 问题交由 accessibility 处理。

---

常见的应做与不应做模式

❌ 不要	✅ 应该
“文案听起来没问题”	盘点所有文案（包括隐藏状态）；明确评审标准；评定严重性
孤立地审核单个屏幕	检查整个流程中的术语一致性
只标记问题而不解决	提供改写版本
放过通用的“OK/提交”标签	标记问题 → 改为“动词 + 结果”
忽略错误状态/空状态	明确审核隐藏文案
重新推导操纵或 a11y 规则	转交给 dark-patterns / accessibility

---

来源课程（Uxcel）

• UX 写作内容审核
• 确保 UX 文案的一致性
• 10 条微文案建议
• UX 写作中的模式
• 撰写以行动为导向的消息
• UX 微文案的无障碍设计