UX 文案写作（深度工作流）

UX 文案写作是以文字为核心的界面设计：旨在降低认知负荷、预防错误，并建立用户信任。它并非在项目末期临时添加的营销润色。

何时提供该工作流

触发条件：

• 错误提示令人困惑、关键流程流失率高、空状态呈现“异常”感
• 产品内术语不一致
• 无障碍审查指出标签含义不清或操作指引过于冗长
• 为设计系统制定语音与语调规范

初始提案：

采用六个阶段：（1）上下文与用户，（2）语音与语调，（3）清晰度与结构，（4）错误与恢复，（5）表单与校验，（6）无障碍与本地化。请客户提供界面截图、当前文案以及相关数据指标（如客服工单数、流程流失率等）。

阶段 1：上下文与用户

目标：文案需契合用户的心智模型与当前情绪状态。

关键问题

1. 用户在此界面的核心目标是什么？首要操作是什么？
2. 压力水平如何？涉及账单、安全或健康等敏感场景时，语气需相应调整
3. 用户专业度如何？面向新手用户还是资深用户？采用渐进式披露策略

约束条件

• UI 组件存在字符长度限制；含法律合规要求的文本须经法务复核

退出条件：为每个界面或流程产出一份具象化的场景简报——而非泛泛而谈的“友好型”描述。

阶段 2：语音与语调

目标：保持稳定统一的品牌语音，同时根据具体情境灵活调整语调。

语音（稳定不变）

• 核心原则：例如清晰、尊重、自信、人性化——从中选取 3–4 条，并明确定义其反模式（即应避免的表达方式）

语调（依情境变化）

• 成功状态：简洁肯定，给予即时反馈
• 错误状态：语气沉着、不归咎用户；明确提供下一步操作指引
• 空状态：以邀请式语言引导用户行动，避免居高临下或说教感

术语规范

• 术语表：明确区分“Workspace”与“Project”等概念——每个概念仅使用一个标准术语；并与工程团队在 API/文档中向用户暴露的命名保持一致

退出条件：针对三种典型场景（成功、错误、空状态），分别提供改写前后对比示例。

阶段 3：清晰度与结构

目标：文案具备可快速扫描性，关键信息前置。

实践准则

• 标题需具体明确：“Payment failed”优于“Something went wrong”（除非真实原因确实完全未知）
• 按钮文案使用动词：“Save address”优于“OK”
• 遵循样式指南的句首小写规则；避免全大写（缩略词除外）
• 数字与日期按用户本地化格式显示；在合适场景使用相对时间（如“Updated 2 min ago”）

微文案层级结构

• 主信息 → 次级说明 → 三级扩展（如“了解更多”链接）

退出条件：删减所有冗余词汇；在关键路径中，确保每句话只传达一个核心观点。

阶段 4：错误与恢复

目标：用户能准确理解发生了什么，并清楚知道接下来该做什么。

错误提示结构

• 发生了什么（使用通俗语言，不可仅显示错误码）
• 原因（若已知且对用户有帮助——避免堆栈跟踪等技术细节）
• 该怎么做（具体步骤、支持链接、重试入口）
• 卡住时的支持路径

安全注意事项

• 禁止在登录流程中泄露邮箱是否存在——若安全策略要求模糊处理，须与安全团队协同确认

退出条件：针对前十大错误状态完成文案重写，并与工程团队就消息内容的真实性达成一致。

阶段 5：表单与校验

目标：内联帮助信息与校验文案需无障碍可达且响应及时。

实践准则

• 每个输入控件均需配有显式标签；不可仅依赖 placeholder 作为标签
• 错误信息须通过编程方式与对应字段关联（如使用 aria-describedby）；提交失败时需主动朗读播报
• 复杂密码规则应在用户开始输入前即清晰展示
• 执行破坏性操作后，提供明确的成功确认反馈

错误提示的语气

• 避免引发羞耻感的表述（如“Invalid input”）→ 改用中性客观表达（如“Enter a date after Jan 1, 2024”）

退出条件：将表单审查清单应用于流量最高的表单。

阶段 6：无障碍与本地化

目标：文案需适配屏幕阅读器及多语言翻译需求。

无障碍（a11y）

• 对具有信息意义的图片提供替代文本（alt text）；纯装饰性图片需明确标记为装饰用途
• 操作指引不可仅依赖颜色传达；错误识别不可仅靠颜色区分

本地化（i18n）

• 禁止拼接字符串并预设其他语言的词序逻辑
• 标点符号与正式程度需符合目标区域习惯；使用伪本地化（pseudolocale）进行溢出测试

退出条件：文案字符串设计为便于提取；若字符串中嵌入 HTML，则必须有明确的后续处理方案，否则不得嵌入。

最终审查清单

• 语音与语调已形成文档，并附带实际示例
• 关键路径文案具备可扫描性；主要操作按钮使用动词
• 错误提示包含原因说明、下一步操作及支持路径
• 表单具备完整标签、有效校验及无障碍关联机制
• 字符串模式满足本地化安全要求（i18n-safe）

高效指导建议

• 大声朗读文案——若读起来拗口，即需修改。
• 与设计团队紧密协作：文案长度直接影响界面布局；切勿脱离设计网格盲目修改。
• 针对AI 产品，文案中需清晰界定机器与人工的责任边界。

特殊情况处理

• 企业级密集型 UI：优先保障任务执行效率，适度弱化个性表达。
• 受监管行业（如金融、医疗）：纳入法务审核闭环——仅建议更平实易懂的替代方案，不提供法律意见。