标签命名
标签是告诉用户在打开一扇门之前门后是什么的文字。这项技能服务于决定每个目的地、区域或操作应该叫什么,以及每个层级使用哪种命名系统。每个标签的检验标准是:一个新用户能否预测它背后是什么?
开始之前
| 你需要 | 如果缺少它 |
|---|---|
| 当前的标签,每个标签背后是什么以及出现在哪里 | 阅读导航或请求提供。如果还没有任何内容,交付空的 labels.csv 和测试计划。 |
| 谁阅读它们以及他们试图做什么 | 询问。如果没有回答,在顶部说明你的假设。 |
| 用户自己的语言:搜索日志、支持问题、卡片分类组名、访谈、评论 | 根据内容和类似产品的惯例起草,将每个标签标记为 untested(未测试),并交付测试计划以便验证用词。永远不要将猜测作为用户的语言呈现。 |
方法
-
在上下文中列出标签。 记录每个标签的组(一起看到的标签)、目的地以及它背后真正的内容。脱离同级标签来判断标签是导致重叠被遗漏的原因。
-
收集用户的词汇。 他们的词汇是首要候选词;你的内部术语不是。
来源 提供什么 注意 搜索日志 输入的确切词汇,最强的触发词 运行可寻性技能的日志报告;永远不要估算数量 支持问题 人们如何描述需求 遇到困难的人会用不同的方式表达 卡片分类组名 人们如何称呼一个集群 使用他们最常用的词 访谈,5到10人 词汇以及这些词对他们意味着什么 注意他们未经提示就使用的词 类似产品 人们已经学过的词汇 熟悉胜于巧妙 -
每层选择一种标签系统。 在一个菜单中混合使用意味着每个项目回答不同的问题,人们无法比较它们。
系统 示例 适用时 失效时 任务 "追踪订单" 人们带着要完成的任务来 任务重叠或列表过长 受众 "面向开发者" 不同群体需要不同内容,并能自我定位 某人属于多个群体,或不知道自己是哪个群体 主题 "计费" 主题是用户思考的方式 主题是组织自己的,不是用户的 格式 "视频", "模板" 用户按格式选择 他们首先关心的是主题 字母顺序 A-Z 词汇表、目录 用户知道确切的名称 他们在浏览以发现内容 -
根据以下规则撰写候选标签。
规则 弱 较强 具体且熟悉,无神秘内容 资源、解决方案、发现 指南和模板 同级标签结构平行 定价、开始使用、面向团队 定价、设置、团队 前置区分性词汇 报告设置、报告历史 设置、历史,放在"报告"下 同一事物,同一名称处处一致 菜单里用"团队",页面上用"人员" 选择一个,并在导航、标题和面包屑中统一使用 门与房间匹配 "计划"打开后是"选择您的订阅" 链接文本和页面标题一致 链接文本说明你能得到什么 了解更多 下载入职核对清单 -
决定内部名称的处理方式。
名称类型 处理方式 团队、部门或项目代号 永远不要显示。按用户来做的内容命名 用户必须学习的特性品牌名称 在用于导航的任何地方,配以简洁的描述 受众真正使用的专业术语 保留它,即使圈外人不知道,并针对该受众进行测试 法律或监管术语 保留确切术语,并在旁边加上通俗解释 缩写 拼写完整,除非受众搜索缩写多于全称 -
对每个有争议的标签提供两到三个选项,说明每个选项的优缺点,并推荐一个。单一答案隐藏了决策过程。
-
增强标签周围的信息气味。 简短描述、项目数量、面包屑和活跃状态可以承载单个词无法传达的内容。当标签单独看起来没问题但用户仍然跳失时,请阅读 references/information-scent.md。
-
测试可预测性。 单向测试:显示标签本身,询问用户期望背后是什么;另一方向:给出一个目标,询问用户会选择哪个标签。作为第一轮,你可以进行冷读:覆盖目的地,写下你期望的内容,然后比较。将此作为你自己的阅读结果报告,而不是作为研究结果。references/predictability-test.md 提供了计划和评分方法。
-
检查其他语言。 如果标签需要翻译,请在确定之前阅读 references/locales.md。按含义翻译,而不是逐字翻译,并与目标市场的用户重新测试。
交付物
除非用户指定其他文件,否则编写以下内容。
labels.csv,每个标签一行:group,label,destination,system,was,evidence,status。evidence说明词汇来源(搜索日志、支持、假设)。status是kept(保留)、renamed(重命名)或new(新增),加上tested(已测试)或untested(未测试),以分号分隔:renamed; untested。labels.md,按此顺序:建议(两到三句话);为每个层级选择的系统;有争议的标签(选项、权衡、选择及原因);内部名称及其处理方式;如何测试它们;假设和未解决的问题。完整的列表仅存在于labels.csv中,因此两者不能不一致。
| 任务 | 返回内容 |
|---|---|
| 重命名一个项目 | 三个带有权衡的选项、一个选择和一个测试问题,在回复中 |
| 审查一个菜单 | labels.csv 行和一个简短的更改列表 |
| 整个网站或应用 | 两个文件 |
更长的文档并不意味着更全面。
检查
运行机械检查并使用其计数:
node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv
它能够发现模糊的词、组内重复、以相同单词开头的同级项、组内混用语法形式、一个标签对应多个目的地以及一个目的地对应多个标签的情况。格式检查仅针对明显模式触发,因此请自行阅读每个组的平行结构。然后验证:
- 每个组使用一种标签系统,并且
labels.md说明了使用的是哪种。 - 每个标签都是
tested或标记为untested。干净的脚本运行结果不能证明用户理解。 - 每个标签的
evidence是真实的。如果是假设,该行应该注明。
Claude 在这里无法做到的事情
你无法通过自己阅读标签来了解真实用户的理解,也无法在未被告知的情况下了解组织的战略、品牌承诺或内部政治。永远不要编造使用数据、搜索量、测试结果或用户引述。提出带有权衡的备选方案,推荐一个并说明原因;由人类来做出决策,尤其是当名称涉及品牌或法律效力时。
此处结束后的交接
| 下一步需求 | 技能 |
|---|---|
| 分组本身看起来有问题 | card-sort, sitemaps |
| 哪些标签放在哪个菜单上 | navigation |
| 用于标签和过滤的术语 | taxonomies |
| 重命名的部分改变其地址 | url-structure, redirect-maps |
| 在层级结构内测试标签 | tree-tests |
| 重命名没有解决"用户找不到它"的问题 | findability |
| 首先列出已有的内容 | content-inventory |
| 模板背后的字段 | content-models |
| 整个网站的重构,或不确定从哪里开始 | information-architecture |