Community写作与编辑github.com

twltr/ux-copy

编写或审查任何语言的UX文案——微文案、按钮标签和行动号召、错误消息、空状态、确认对话框、工具提示、加载、成功和引导文本。适用于命名操作、措辞错误或破坏性确认、填充空状态或审查现有界面字符串,包括针对德语、法语或其他非英语界面以及这些语言编写的请求的文案。长篇营销文案、文章和电子邮件不在此方法范围内。

ux-copy 是什么?

这是一个专注于UX微文案的专业技能,可帮助设计师和开发人员编写或审查任何语言的界面文本。它提供了一个系统化的方法,从用户的情境和实际结果出发,编写清晰、有效的文案,而不是使用通用的词汇如“提交”、“确定”或“出现错误”让用户猜测。该技能支持多种平台,包括Figma等设计工具和Notion等知识库,并特别强调非英语界面的本地化处理,如正式/非正式“您”的选择、控制动词形式、大小写规则、排版格式和长度适配。它涵盖按钮CTA、错误消息、空状态、确认对话框、工具提示、加载文本、成功消息和引导文本等常见界面元素,但明确排除了长篇营销文案、文章和电子邮件。技能提供了丰富的示例和输出格式模板,帮助用户将建议清晰地呈现给团队。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/twltr/skill-profile/tree/HEAD/skills/design/ux-copy

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

UX 文案

设计领域的叶子技能;通过其领域或名称访问。

界面文本是在任务进行中、通常在有压力的情况下被快速阅读的。它有效工作时,用户知道会发生什么以及下一步该做什么;而像“提交”、“确定”或“出现错误”这样的通用词汇会让用户猜测。从用户的情境和操作的实际结果出发,用界面自身的语言进行编写。

工作示例

请求(虚构产品): “用户经常意外删除项目。请审查此对话框:您确定吗? [确定] [取消]”

删除“Q3 发布”?
它的 14 个任务和所有文件将从团队中移除。
此操作无法撤消。
                                   [取消]  [删除项目]

标题命名了操作和对象,主体说明了使其严重的后果,破坏性按钮重复了动词,使其能独立阅读。“取消”保持不变:这是熟悉的退出方式,重命名它不会增加任何价值。

从情境出发

确定屏幕或流程、用户正在尝试做什么以及他们可能的感受、产品的语调和现有术语,以及约束条件如字符限制、平台约定和目标语言。作为参数传递的文案是要审查的文本。当细节缺失时,根据声明的假设进行编写,而不是发送调查问卷;仅当答案会改变文案时才提问,例如正式或非正式的称呼。

标记为 ~~ 的部分命名的是一个工具类别,而不是一个产品:~~设计工具(例如 Figma)或 ~~知识库(例如 Notion)。使用主机提供的该类别的任何连接工具;如果没有,则跳过此步骤。

在 ~~知识库 中,首先阅读品牌语调、内容风格指南和术语。在 ~~设计工具 中,查看屏幕在其流程中的布局,并从布局中获取字符限制。

其他语言中的文案

以界面的语言进行本地化编写;用英语起草然后翻译的文案会保留英语结构,读起来像外语。用请求的语言回复,但用界面的语言编写字符串——两者可能不同,例如一个关于德语应用的英语问题。以下模式适用于所有语言;这些约定会改变它们的表达方式:

  • 称呼方式。 许多语言在正式和非正式的“您”之间选择(德语、法语、西班牙语、荷兰语)。遵循产品现有的选择;如果没有,提出一个并将其应用于所有地方,包括错误中。
  • 控件上的动词形式。 德语、法语和西班牙语界面通常用不定式而不是祈使句标记按钮和菜单项。遵循平台和产品的约定。
  • 大小写。 句子大小写是英语规则。德语在任何位置都大写名词;切勿将英语标题大小写应用于其他语言。
  • 排版和格式。 使用该语言的引号、间距(法语在 ! ? : ; 前加空格)以及数字、日期和货币格式。
  • 长度。 德语和法语通常比英语长三分之一,短字符串差异更大;长复合词不会换行。对照实际宽度检查,并使用正确的 lang 属性启用断字。

在审查中,检查所有字符串的一致性,而不仅仅是单个字符串内。

模式

元素必须做什么示例
按钮, CTA动词加对象;命名结果;在整个流程中保持名称“发布” → 提示 “已发布”
错误发生了什么以及如何修复;仅在对修复有帮助时才说明原因;绝不指责,绝不使用裸代码“您的银行拒绝了此卡。尝试其他卡或联系您的银行。”
字段错误说明需要什么,而不是什么错了“输入一个在今天之后的日期”
空状态这里将出现什么以及如何开始;无结果建议更改搜索“尚无发票。创建一个或从 CSV 文件导入。”
确认命名操作和对象,说明后果,用动词标记按钮见工作示例
工具提示添加标签无法说明的内容;绝不重复标签—
加载说明正在发生什么;为长时间等待设定预期“正在导入 2,400 个联系人。这可能需要一分钟。”
成功确认具体结果“发票已发送给 Dana” 而不是 “操作成功!”
引导每个步骤一个概念,并与用户做的事情相关联—

语调保持产品本身;语气随情境变化。错误是冷静且具体的:同理心意味着承认影响并帮助修复,而不是条件反射地道歉或开玩笑。成功消息简洁,警告直接。

输出

对于一个元素,给出建议以及一句话说明为什么它适合用户的情境。仅在真正有选择空间时才提供替代方案,例如语气或长度权衡:

## UX 文案:[上下文]

**[元素]:** [文案]
[为什么这适合用户在此时此地]

| 选项 | 文案 | 最佳用途 |
|---|---|---|
| A | [文案] | [何时使用] |

**本地化说明:** [仅当文案被翻译或以多种语言发布时:要避免的习语、扩展、称呼方式、文化背景]

对于多个字符串的审查,使用一个表格,使每个更改都可追溯:

| 位置 | 当前 | 建议 | 原因 |
|---|---|---|---|
| 结账,卡片错误 | “错误 402” | “您的银行拒绝了此卡。尝试其他卡。” | 说明发生了什么以及下一步操作 |

布局、排版和视觉层次不在此方法范围内;长篇营销文本、文章和电子邮件也不在其中,这些需要写作方法而非微文案模式。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能