---
name: glossary-builder
description: 根据团队文档整理一份术语表：每个术语配一句通俗的定义、首选写法、要避免的同义词和旧名称、一个例句和一位负责人，让团队成员和 AI 工具用同一套说法描述业务。适用于团队要一份术语表、词汇表、用词规范、统一术语，或问“X 到底叫什么”，或者想把公司的常用词汇交给 AI 助手时。
---

# 术语表整理

一个团队说“账户”，另一个团队说“客户”，产品里又叫“工作区”，于是每份文档、每个 AI 回答都越写越乱。术语表为每个概念选定一个术语，用新员工也能看懂的话来定义，并列出不该用的词。GOV.UK 的 A to Z 风格指南和 Google 的开发者用词表都是这样做的：每个术语一条，一句简短的规则，“用 X，不用 Y”。

## 适用场景

- 新员工、客户或 AI 助手对同一件事总是用不同的说法。
- 写帮助文档、销售演示文稿或 AI 指令之前，让它们用同一套词汇。
- 合并团队或产品时，双方对同一事物的叫法不同。
- 不适用于设计概念之间的关系（用 ontology-draft），也不适用于完整的写作风格指南（用 brand-voice）。

## 需要准备

- 源文档：帮助文档、产品界面文字、销售演示文稿、合同、Slack 讨论、工单。
- 术语表给谁看：内部员工、客户，还是两者都有。
- 已有的术语决定（产品名称、法定名称）。没有的话，就提出建议并标注“[建议]”。

## 步骤

1. **收集候选术语。** 产品和功能名称、业务概念、缩写、指标，以及任何有不止一种用法的词。统计每种写法出现的次数和位置。
2. **按概念给不同写法分组。** “账户”“客户”“客户组织”可能是一个概念，也可能是三个。判断方法：它们是否总是指同一个东西？如果不是，就分成几条，各自给出更精确的定义。
3. **选定首选术语。** 优先选客户在产品里看到的词，其次是最常见的写法，再次是最通俗的。其他写法记为“不用”，并写明原因（旧名称、有歧义、内部行话）。
4. **用通俗的话写定义。** 一两句话，写给从没见过这个产品的人。说明它是什么，以及它和最相近的术语有什么区别。定义里不要重复术语本身（“工作区是一个用于……的工作区”）。
5. **补充用法说明。** 写法（用哪个字、是否加空格、中英文怎么写）、是否容易写错、缩写首次出现时是否需要写全称，再给一个例句。
6. **为每个术语指定负责人。** 由谁来决定修改（功能名称归产品，合同术语归法务，指标归财务）。
7. **整理成人和 AI 都好用的格式。** 一张按拼音或字母排序的表格，再加一份简短的“用 / 不用”清单，可以原样粘贴到 AI 指令里。

## 输出格式

```markdown
# [团队 / 公司] 术语表
*第 [n] 版，[日期]。读者：[内部 / 客户 / 两者]。如需修改：联系该术语的负责人。*

| 术语 | 定义（通俗说法） | 不用 | 用法说明 | 例句 | 负责人 |
|---|---|---|---|---|---|
| [术语] | [1–2 句话] | [其他写法，原因] | [写法、易错点、缩写] | [例句] | [人 / 团队] |

## 给 AI 指令用（原样粘贴）
- 用“[术语]”，不用“[其他写法]”或“[其他写法]”。

## 待决定事项
- [两个团队对 X 有分歧] — 选项：[a / b] — 决定人：[姓名]
```

## 示例

**输入：** “排班宝（员工排班软件）的文档。界面上写的是‘工作区’。销售演示文稿里写‘账户’和‘组织’。客服工单里写‘公司’。帮助中心对同一个功能有时叫‘换班’，有时叫‘调班申请’。财务报表里有‘MRR’也有‘月收入’。有些文档写‘登录’，有些写‘登陆’。”

**输出：**

```markdown
# 排班宝术语表
*第 1 版，11月4日。读者：两者。如需修改：联系该术语的负责人。*

| 术语 | 定义（通俗说法） | 不用 | 用法说明 | 例句 | 负责人 |
|---|---|---|---|---|---|
| 登录 | 用账号进入排班宝的操作 | 登陆（错别字，“登陆”指上岸） | 动词、名词都写“登录”，如“登录页面” | “用工作邮箱登录。” | 产品 |
| 工作区 | 一家雇主在排班宝里管理排班和员工的空间；一家公司可以有不止一个工作区 | 账户、组织、公司（容易和付费的法律主体混淆） | 与界面保持一致，不写成“工作空间” | “邀请经理加入你的工作区。” | 产品 |
| 换班 | 员工申请把自己的班次让给同事，由经理审批 | 调班申请（旧名称） | 作名词时可写“换班申请” | “在‘排班’页面发起换班。” | 产品 |
| MRR | 月度经常性收入：我们每月预期得到的订阅收入，不含一次性费用 | 月收入（有歧义：可能包含一次性费用） | 面向客户的文字中，首次出现时写全称 | “3月 MRR 增长到 [数字]。” | 财务 |

## 给 AI 指令用（原样粘贴）
- 指排班宝里管理排班的地方时，用“工作区”，不用“账户”“组织”或“公司”。
- 用“换班”，不用“调班申请”。
- 用“登录”，绝不写“登陆”。
- “MRR”只用于经常性收入；首次出现时写全称。

## 待决定事项
- 付费的法律主体（例如“客户”）是否需要一个和“工作区”分开的术语？ — 选项：把“客户”单独列为一条 / 不处理 — 决定人：产品负责人
```

## 发送前检查

- [ ] 每个概念只有一个首选术语。
- [ ] 每条定义不了解产品也能看懂，并且没有重复术语本身。
- [ ] 每个“不用”的写法都说明了原因。
- [ ] 每个术语都有一位决定修改的负责人。
- [ ] 给 AI 指令用的清单和表格完全一致。

## 常见错误

- 用同一份术语表里的行话来定义术语。要用新员工懂的话来定义。
- 保留两个“都可以”的同义词。选一个；术语表的意义就在于统一。
- 放在一份没人打开的文档里。把简短清单粘贴到 AI 助手的指令和帮助中心的写作规范里。