用途
该技能用于撰写和审查界面内的文案,范围包括标签、描述、状态文本以及这些文本使用的标点。它的检查对象是界面中出现的文字,而不是界面布局或其他视觉元素;超出文字范围的界面问题归“克制”处理。
主要能力
- 大小写与标点精确检查:句首大写(sentence case)的标签会被记为问题,破折号会被记为问题;某个标签在删词后仍能说明发生什么时,删词才算问题。
- 标签使用 Title Case:按钮、菜单项、标签页、标题和设置名称采用 Title Case;短冠词、连词和介词保持小写,除非位于开头。例如“Add to library”应改为“Add to Library”。
- 用尽可能少的词:在仍能说明发生什么的前提下压缩字数。例如下载界面的“Start Download”改为“Start”;上下文已指明名词时只显示数字,“12 items”改为“12”。
- 使用朴实名称,不用 ID:显示事物的展示名称而非 ID,内部缩写或自创人名会被标记。例如下拉框中的“instagram_graph”应显示为“Instagram”。
- 描述一行或没有:设置项下出现两行描述会被标记,细节应移入工具提示。
- 状态与时刻匹配:搜索仍在进行时显示“Searched”会被标记,应依次显示“Searching”和“Searched”。
- 不用破折号、不用省略号:破折号处改用逗号或句号;除搜索占位符外不使用省略号,例如“Loading...”改为“Loading”。
使用方式
每项检查以成对方式呈现:错误写法放在替换写法旁边,并配规则编号。规则与示例对照如下:
| 规则 | 错误写法 | 替换写法 |
|---|---|---|
| copy-title-case | Add to library | Add to Library |
| copy-fewest-words | Start Download on the download screen | Start |
| copy-number-not-noun | 12 items | 12 |
| copy-plain-words | PDP | Product Page |
| copy-display-names | instagram_graph | |
| copy-one-line-description | Two lines under a setting | One line, the rest in a tooltip |
| copy-state-tense | Searched while running | Searching, then Searched |
| copy-no-em-dash | Synced — 2 minutes ago | Synced 2 minutes ago |
| copy-no-ellipsis | Loading... | Loading |
报告与判定
严重程度分为三级:HIGH 表示向用户展示了 ID 或内部术语,或状态写错;MEDIUM 表示标签大小写错误、两行描述或破折号;LOW 表示标签比需要的多一个词。
报告格式为每个根因一条发现:
file:line - [rule-id] what is wrong
随后附上 Rule | Count | Severity 汇总。只要存在 HIGH 就阻止通过(Block),否则批准(Approve)。没有读过的文件不得批准;无法运行的检查标记为 Not verified。
适用场景
适用于界面文案的编写与评审,例如按钮、菜单、标签页、标题、设置名称、状态文本、下拉选项和加载提示等文字内容的检查。
限制
该技能只处理界面文字,不处理布局或其他视觉问题;压缩字数以“仍能说明发生什么”为前提;省略号仅允许出现在搜索占位符中;未读文件不得批准,无法执行的检查需明确标记为未验证。