Community写作与编辑github.com

wensity/wensity-ui-copy

编写界面中的文字:标题、按钮、标签、帮助文本、错误信息、空状态、提示、确认对话框、新手引导和落地页文案,以及逼真的示例内容。用于编写或修改 UI 中的用户可见文本、填充新页面或组件内容、当文案像营销套话或 AI 生成时,或用户要求更好的措辞、微文案、CTA 文本、错误提示或空状态时。跳过保留现有文本的更改。

wensity-ui-copy 是什么?

Wensity UI Copy 是一个专注于用户界面文案编写的 AI 代理技能,旨在确保界面中的每个单词都设计良好、具体且清晰。它将文字视为设计的一部分,避免模糊或夸大的文案,采用平实、具体的语言来提升界面的可信度与可用性。该技能涵盖了从标题、按钮、表单、错误信息到空状态、加载反馈、确认对话框等几乎所有 UI 文本元素,并提供了详细的规则和示例。它支持所有需要编写或修订用户可见文本的场景,包括新功能开发、文案润色、错误信息重写,以及空状态和引导流程的改进。其核心工作方式是检查文本是否帮助用户理解或行动,并按照一套严格的风格指南(包括语气、措辞、结构)进行改写或创作。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wensity/skills/tree/HEAD/skills/wensity-ui-copy

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

在你喜欢的 AI 中提问

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

文档

Wensity UI Copy

文字是设计的一部分。含糊或浮夸的文案会让精致的界面显得平庸;而平实、具体的文案则能让普通的界面变得可信。检验每段字符串的标准是:它是否能帮助用户理解或采取行动?

1. 语气

  • 使用平实的语言。 像热心人随口说出的那样写作。用"保存更改",而不是"持久化修改"。用"你的积分已用完",而不是"信用余额已耗尽"。
  • 使用用户的词语,而非系统的。 用"通知",而不是"Webhook 调度配置"。根据用户的操作来命名事物。
  • 简洁。 删掉每一个不影响语义的词,然后再删一遍。
  • 全篇使用句子首字母大写: 标题、按钮、菜单项、标签页、标签。用"创建新项目",而不是"创建新项目"(保持原文风格,译注:英文的 Sentence case 指仅首字母大写)。
  • 使用主动语态,面向用户。 用"你无权访问此项目",而不是"此项目不允许访问"。当系统失败时,直接说明:"我们无法保存你的文件",而不是"文件无法被保存"。
  • 保持冷静。 除真正的庆祝外不使用感叹号,错误中不道歉,错误状态下不开玩笑。

2. 使文案听上去像 AI 生成的词语

避免这些词语。它们不传达任何用户可以验证的信息:

  • 动词:解锁、释放、提升、赋能、增压、革新、变革、简化、利用、驾驭、重塑、猛增。
  • 形容词:无缝的、轻松的、尖端的、新一代的、世界级的、健壮的、强大的、直观的、创新的、一体化的。
  • 短语:"在当今快节奏的世界中"、"将您的 X 提升到新水平"、"无论您是 X 还是 Y"、"告别"、"不必再找了"。
  • 格式:连续三个形容词("快。安全。简单。")、中点列表(设计 · 构建 · 发布),以及产品文案中任何位置的破折号,包括页面 <title>、meta 描述和 alt 文本。使用冒号、逗号或两个句子:"Ledgerline:多币种发票"。

用一个具体的事实替换每个词语:它做什么、有多快、为谁服务、结果如何。"将 40 分钟的报告缩短到 2 分钟"优于"增压你的工作流"。

3. 标题

  • 标题应点明要点, 而非主题。"发票提前 9 天到账"优于"功能"。"你的工作区为空"优于"工作区"。
  • 不要使用眉标。 不要在标题上方放置小写大写标签("功能"、"定价"、"运作方式")。编写一个独立的标题。
  • 页面标题应命名页面,以便用户知道自己在哪:"账单"、"团队成员"。

4. 按钮和链接

  • 以动词开头,并命名结果: "创建发票"、"发送邀请"、"导出 CSV"。而不是单独用"提交"、"确定"、"是"、"点击此处"、"了解更多"。
  • 使按钮与下一步操作匹配。 如果按钮显示"发布",则提示应显示"已发布",页面应显示已发布状态。
  • 主要和次要操作必须明确不同: "删除项目"和"取消",而不是"是"和"否"。
  • 理想长度为 1 到 3 个词。 如果添加了具体好处,CTA 可以扩展到 5 个词("免费开始,无需卡")。
  • 链接文本应能独立表意(屏幕阅读器会脱离上下文列出链接):"阅读 API 指南",而不是"此处"。
  • 破坏性操作应命名对象: "删除 3 个文件"、"从团队中移除 Sam"。

5. 表单

  • 标签位于字段上方, 始终可见。占位符文本不是标签;输入开始后它会消失。
  • 占位符显示格式,而非说明: [email protected]、MM / YY。当标签足够时,省略它们。
  • 帮助文本 放在字段下方,用于说明用户在输入前需要知道的规则:"至少 12 个字符"。
  • 标记可选字段,而非必填字段, 当大多数字段为必填时:"公司(可选)"。
  • 在失焦或提交时验证, 而不是每次按键。将错误信息显示在其所属的字段旁边。

6. 错误

每个错误应回答两个问题:发生了什么,以及现在该怎么办。

弱更好
无效输入输入一个今天的日期之后的日期
发生错误我们无法连接到服务器。请检查您的连接后重试。
错误 403您无权访问此项目。请让所有者邀请您。
上传失败此文件为 24 MB。限制为 10 MB。
付款被拒您的卡被拒绝。请尝试其他卡或联系您的银行。
  • 绝不要责怪用户("您输入了一个无效的邮箱")。描述修复方法("输入一个类似 [email protected] 的邮箱")。
  • 将错误代码和堆栈跟踪从消息中移除。如果支持需要,则在末尾添加一个引用 ID。
  • 保留用户输入的内容。绝不要因为一个字段验证失败就清空整个表单。

7. 空状态

空状态是新用户看到的第一件事。将其视为新手引导:

  1. 说明什么将出现在这里:"您发送的发票将显示在这里。"
  2. 提供填充它的一个操作:一个主要按钮,"创建发票"。
  3. 可选:一个导入链接、一个模板或一篇简短指南。

对于"无结果"空状态,说明搜索内容以及如何扩大范围:"未找到 'invioce' 的结果。请检查拼写或清除筛选条件。"

8. 加载、成功与提示

  • 加载: 当操作超过一秒钟时,说明正在发生什么:"正在生成报告…"。使用省略号字符。
  • 成功提示: 使用动作的过去式,加上对象:"已发送邀请至 [email protected]"、"项目已删除。撤销"。
  • 对于可逆操作,提供撤销而非确认对话框。 仅在操作无法撤销时才要求确认。
  • 确认对话框: 标题提出真正的问题("删除 'Q3 报告'?"),正文说明后果("这将为所有人移除它。您无法撤销此操作。"),按钮命名操作("删除报告"/"取消")。

9. 数字、日期与单位

  • 使用数字:"3 个文件",而不是"三个文件"。
  • 使用用户区域设置进行格式化:Intl.NumberFormat 和 Intl.DateTimeFormat(或 toLocaleString)代替手工构建的字符串。
  • 近期事件使用相对时间("2 分钟前"),较久远的事件使用绝对日期("3 月 4 日"),并在工具提示中显示完整时间戳。
  • 正确使用复数形式:"1 个文件"、"2 个文件"、"0 个文件"。使用 Intl.PluralRules 或辅助函数,绝不用 "file(s)"。
  • 使用不间断空格保持数字与单位在一起(HTML 中使用 10&nbsp;MB,JavaScript 中使用 "10\u00A0MB"),以免它们换行时断开。

10. 逼真的占位符内容

在没有真实内容的情况下构建设计时,编写看上去真实的内容:

  • 具体名称和数据: "Maya Chen,Northwind 的产品设计师"、"$12,480.00"、"发票 INV-2041"。而不是"张三"、"$XX"、"Lorem ipsum"。
  • 逼真的长度, 包含一些较长的内容,以便对布局进行测试:一个 40 个字符的名称、一个 3 行描述紧挨着一个 1 行描述。
  • 绝不要编造证据。 没有虚假的客户标志、星级评分、用户数量或作为真实内容呈现的推荐语。使用标记的占位符([客户引语]、[标志])或向用户索要真实内容。
  • 与产品的世界相匹配。 一个开发工具示例数据是仓库和部署;一个诊所应用示例数据是预约和病人。

11. 文案中的可访问性

  • 每个仅图标的按钮都应有一个可访问的名称:aria-label="关闭对话框"。
  • 当图片承载信息时,alt 文本描述图片展示的内容("柱状图:自 1 月以来收入增长 24%")。装饰性图片使用 alt=""。
  • 不要仅依赖颜色词("点击绿色按钮")。
  • 除非受众每天使用该缩写,否则在首次出现时展开缩写。

12. 完成前检查

  • 无第 2 节中的填充词,无三个形容词的标语,界面字符串中无破折号。
  • 每个标题都陈述一个要点;无眉标。
  • 每个按钮以动词开头并命名其结果。
  • 每个错误说明发生了什么以及该怎么做。
  • 每个空状态自我解释并提供下一步操作。
  • 全篇文章使用句子首字母大写。
  • 示例内容具体、长度多样,且不包含编造的证明。
  • 仅图标控件和有意义的图片包含可访问文本。

Individual skills in this repo

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

相关技能