ux-microcopy

UX 微文案技能

此技能的行为方式（请先阅读）

这是一项生成式技能。Claude 默认生成的 UX 文案往往冗长、故作机智或泛泛而谈（“哎呀！出了点问题”“提交”“确定吗？”）。好的微文案恰恰相反：朴实、具体，并在不经意间提供帮助。表达性的部分——语气——取决于具体情境，因此此技能会分步引导：

1. 明确品牌声音、受众和情境——适合庆祝成功状态的语气，不适合支付错误。
2. 应用始终适用的核心原则——清晰、简洁、以行动为导向、保持一致，以及包容且易于访问的语言，适用于所有文案。
3. 有意识地选择语气——根据品牌和具体情境选择语体；不要默认采用诙谐或机械的语气。

然后交由审核环节处理：配套的 ux-microcopy-audit，以及 accessibility（确保屏幕阅读器和所有用户都能理解文案）和 dark-patterns（文案必须诚实地说服用户，绝不操纵）。

---

第 0 步 — 写作前明确情境

• 品牌声音——产品一贯的个性（活泼还是正式，热情还是中性）。
• 受众与用词——使用用户常用的词语（例如“乘车”，而非“通勤”）；考虑用户的技术熟悉程度和阅读水平。
• 情境——庆祝、日常、敏感（支付／安全），还是错误／恢复？这决定语气。
• 语言地区——语言和平台惯例（桌面端用“点击”，移动端用“轻触”）；本地化不只是字面翻译。

如果在没有答案的情况下继续，请说明假设。

---

始终适用的核心原则（适用于所有微文案）

• 语言朴实、简单。 面向尽可能广泛的用户写作；除非受众习惯，否则不要使用行话或过于书面的词语。大声读出来检验。
• 简洁。 在不丢失含义的前提下尽可能少用词；约 16% 的人逐字阅读，其余人会浏览。删掉填充内容。
• 以行动为导向且具体。 标签应以动词（加名词）描述操作结果——“升级到 Pro”“删除文件”“立即取消静音”——不要用“是／否／确定／提交”等笼统说法。优秀的 CTA 还会传达益处。
• 告诉用户正在发生什么以及接下来会怎样。 减少不确定性：说明用户当前所在位置、操作的作用以及所需时间。
• 术语一致。 整个产品中，同一概念使用同一术语（例如始终使用“排期”，不要在其他地方改用“预订”）；并遵循平台惯例。
• 数字和日期符合日常表达。 用“明天”，而非“4 月 1 日”；用“上午 8:45”，而非“差一刻九点”；用具体数字／社会认同，而非含糊的“很多”。
• 包容且易于访问。 使用不分性别的代词（they/them）；链接文本应有描述性（“阅读更多定价信息”，而非“更多”）；微文案应为实时文本，不要嵌入图片；使用持久标签（不要只用占位文本）；确认操作已完成。
• 诚实，绝不操纵。 不要羞辱用户以促使其确认、制造虚假紧迫感或让用户产生内疚感（→ dark-patterns）。

---

语气 — 需要权衡的选择（根据品牌和情境决定）

有意识地选择语体；同一条消息在不同语体下读起来会不一样。不要默认采用某一种语体。

语气	适用场景	注意事项
活泼／诙谐	低风险情境、轻微错误、彩蛋	了解受众；绝不能牺牲清晰度
热情／赞扬	用户努力时给予鼓励；庆祝成就	不要对日常操作过度喝彩
温暖／友好	欢迎、日常指引（称呼名字、使用缩略表达和“你”）	严肃情境下可能显得轻率
自信	敏感情境——支付、安全、数据	避免含糊措辞（“也许”“试试看”）
尊重／正式	专业、受监管或敏感情境	可能显得枯燥——仍要保持清晰
诚实／直接	权限／数据请求	使用主动语态；不要掩盖意图
简洁	信息密集的 UI、标签、移动端	不要省略必要的背景信息

规则：让语气符合情境。支付错误需要自信且清晰，而不是开玩笑。

---

微文案模式（速查）

• 按钮： 动词 + 结果；具体描述优于泛泛而谈（“立即取消静音” > “是”）。
• 错误/警报： 明确说明（发生了什么）+ 提供解决办法（如何修复）+ 使用浅显语言；放在问题旁边；语气礼貌，不责怪用户，也不使用全大写。
• 标签： 使用具体的动词 + 名词，而不是“确定/开始/完成”。
• 占位符： 仅用于提供提示/示例，绝不能作为唯一标签（输入内容后占位符会消失）。
• 工具提示： 提供真正有用的信息，不要说明显而易见的事。
• 通知/推送： 询问“这对用户有什么帮助？”；内容要实用，不要造成打扰。
• 空状态/成功状态： 空状态 = 引导用户执行第一个操作；成功状态 = 确认结果 + 带来积极体验。

---

验证结果（编排）

交接时，请使用每个审查视角对应的可安装技能 name。只有安装了相应技能时才调用；如果未安装，此技能本身的核心内容已涵盖这些规则——继续处理即可，不要因此停下。

编写或修改文案后，请将结果交给审查视角审核，而不是直接宣布完成。这些视角是候选项——具体采用方式由 docs/orchestration-policy.md 决定，也可以将整个内容交由 ux-design-review 审查。在此，microcopy 和 dark-patterns 属于 Tier A（自动运行）；accessibility 属于 Tier B（可选）——在现有设计系统下，accessibility 的审查范围会缩小为使用方式。如果用户只针对某个具体事项调用了此技能，请尊重该范围。

• ux-microcopy-audit （Tier A） — 配套审查：检查清晰度、行动导向、前后一致性，以及整个流程中的语气是否恰当。
• ux-accessibility-audit （Tier B — 可选；在设计系统下缩小范围） — 检查浅显语言、描述性链接、实时文本、持久标签，以及屏幕阅读器的确认提示。
• ux-dark-patterns-audit （Tier A） — 确保文案以诚实的方式说服用户：不使用确认羞辱、刻意制造紧迫感或内疚施压。

如果审查指出问题，请围绕核心原则进行修正：语言更浅显、更具体，语气更恰当。

---

常见的应做/不应做模式

❌ 不应做	✅ 应做
“哎呀！出了点问题。”	“我们无法保存你的更改。请检查网络连接，然后重试。”
“提交” / “确定” / “是”	动词 + 结果：“创建账户”“删除文件”
行话 / 过于正式的词语	使用用户实际会用的浅显语言
处处使用相同的语气	根据品牌和具体场景调整语气
在付款/安全错误中开玩笑	使用自信、清晰、令人安心的文案
“4 月 1 日” / “差一刻九点”	“明天” / “上午 8:45”
这里用“注册”，那里用“免费加入”	每个概念统一使用一个术语
“点击‘更多’”链接 / 泛泛的标签	使用描述性文案：“详细了解定价”
将文字嵌入图片	使用实时、可选中的文本
用确认羞辱的方式劝阻用户退出	中立、诚实地提供关闭选项（→ dark-patterns）

---

来源课程（Uxcel）

• 10 条微文案技巧
• 10 种 UX 写作语气
• 撰写以行动为导向的消息
• 撰写问题提示消息
• UX 写作中的模式
• UX 微文案中的无障碍设计