Communitygithub.com

bbulman/labeling

用于为导航、菜单、标签、分类或功能命名或重命名,解决标签模糊、内部行话或用户困惑的问题。

labeling 是什么?

这项技能专注于帮助产品团队为界面中的每一个标签(如导航项、菜单选项、按钮、分类名称等)做出清晰、用户友好的命名决策。它提供了一套系统化的方法,从收集用户实际使用的词汇开始,逐步选择适合不同层级(如任务导向、受众导向、主题导向等)的标签系统,并遵循具体、熟悉、平行结构等关键规则来撰写候选标签。该技能适用于多种AI开发工具,如Claude Code、Cursor、Codex等,其核心价值在于通过预测性测试和信息气味优化,确保新用户能够准确理解标签背后的内容,从而显著提升产品的可寻性和用户体验。最终交付物包括结构化的CSV文件和总结性的Markdown报告,供团队决策参考。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/information-architecture-skill/tree/HEAD/skills/labeling

在你喜欢的 AI 中提问

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

文档

标签命名

标签是告诉用户在打开一扇门之前门后是什么的文字。这项技能服务于决定每个目的地、区域或操作应该叫什么,以及每个层级使用哪种命名系统。每个标签的检验标准是:一个新用户能否预测它背后是什么?

开始之前

你需要如果缺少它
当前的标签,每个标签背后是什么以及出现在哪里阅读导航或请求提供。如果还没有任何内容,交付空的 labels.csv 和测试计划。
谁阅读它们以及他们试图做什么询问。如果没有回答,在顶部说明你的假设。
用户自己的语言:搜索日志、支持问题、卡片分类组名、访谈、评论根据内容和类似产品的惯例起草,将每个标签标记为 untested(未测试),并交付测试计划以便验证用词。永远不要将猜测作为用户的语言呈现。

方法

  1. 在上下文中列出标签。 记录每个标签的组(一起看到的标签)、目的地以及它背后真正的内容。脱离同级标签来判断标签是导致重叠被遗漏的原因。

  2. 收集用户的词汇。 他们的词汇是首要候选词;你的内部术语不是。

    来源提供什么注意
    搜索日志输入的确切词汇,最强的触发词运行可寻性技能的日志报告;永远不要估算数量
    支持问题人们如何描述需求遇到困难的人会用不同的方式表达
    卡片分类组名人们如何称呼一个集群使用他们最常用的词
    访谈,5到10人词汇以及这些词对他们意味着什么注意他们未经提示就使用的词
    类似产品人们已经学过的词汇熟悉胜于巧妙
  3. 每层选择一种标签系统。 在一个菜单中混合使用意味着每个项目回答不同的问题,人们无法比较它们。

    系统示例适用时失效时
    任务"追踪订单"人们带着要完成的任务来任务重叠或列表过长
    受众"面向开发者"不同群体需要不同内容,并能自我定位某人属于多个群体,或不知道自己是哪个群体
    主题"计费"主题是用户思考的方式主题是组织自己的,不是用户的
    格式"视频", "模板"用户按格式选择他们首先关心的是主题
    字母顺序 A-Z词汇表、目录用户知道确切的名称他们在浏览以发现内容
  4. 根据以下规则撰写候选标签。

    规则弱较强
    具体且熟悉,无神秘内容资源、解决方案、发现指南和模板
    同级标签结构平行定价、开始使用、面向团队定价、设置、团队
    前置区分性词汇报告设置、报告历史设置、历史,放在"报告"下
    同一事物,同一名称处处一致菜单里用"团队",页面上用"人员"选择一个,并在导航、标题和面包屑中统一使用
    门与房间匹配"计划"打开后是"选择您的订阅"链接文本和页面标题一致
    链接文本说明你能得到什么了解更多下载入职核对清单
  5. 决定内部名称的处理方式。

    名称类型处理方式
    团队、部门或项目代号永远不要显示。按用户来做的内容命名
    用户必须学习的特性品牌名称在用于导航的任何地方,配以简洁的描述
    受众真正使用的专业术语保留它,即使圈外人不知道,并针对该受众进行测试
    法律或监管术语保留确切术语,并在旁边加上通俗解释
    缩写拼写完整,除非受众搜索缩写多于全称
  6. 对每个有争议的标签提供两到三个选项,说明每个选项的优缺点,并推荐一个。单一答案隐藏了决策过程。

  7. 增强标签周围的信息气味。 简短描述、项目数量、面包屑和活跃状态可以承载单个词无法传达的内容。当标签单独看起来没问题但用户仍然跳失时,请阅读 references/information-scent.md。

  8. 测试可预测性。 单向测试:显示标签本身,询问用户期望背后是什么;另一方向:给出一个目标,询问用户会选择哪个标签。作为第一轮,你可以进行冷读:覆盖目的地,写下你期望的内容,然后比较。将此作为你自己的阅读结果报告,而不是作为研究结果。references/predictability-test.md 提供了计划和评分方法。

  9. 检查其他语言。 如果标签需要翻译,请在确定之前阅读 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

Individual skills in this repo

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

bbulman/findability

Use when people can't find something, when site search returns nothing or the wrong thing, when someone wants a search log analysed, best bets or synonyms set up, a no-results page designed or findability measured, or when a chatbot is proposed because "nobody can find anything". Not for redrawing the whole page tree, renaming a menu on its own, or running a tree test.

bbulman/information-architecture

Use when someone wants to organize, restructure or review how a site, app, docs set, knowledge base or content library is grouped and found, and the job spans several pieces or it isn't yet clear which piece is needed, even if they never say "information architecture" or "IA". Not for a job that is clearly one piece, such as only a tree test or only a redirect map, and not for visual design.

bbulman/navigation

Use when someone wants a navigation or menu designed, audited or cut down, including a main menu, nav bar, sidebar, app switcher, mega-menu, footer, breadcrumbs, tab bar or mobile menu, or says "there are too many items in the menu", "rethink the sidebar", "our nav is a mess" or "where should settings go". Not for deciding which pages exist, for wording a single label, for fixing site search, or for running a tree test.

bbulman/sitemaps

Use when someone needs the structure of a website, app or docs set decided, asking for a sitemap, site tree, page hierarchy or list of sections, or saying "what pages do we need", "how should we organise the site", "where should this page live" or "the site is too deep". This is where the structure gets decided. Not for writing the linked sitemap file that later design stages read once the structure is settled (design-os:create-sitemap), for generating sitemap.xml, or for designing the menus.

相关技能