官方技能 · AI 实践
团队术语表整理
根据文档整理团队术语表:每个概念一个首选术语、通俗的定义、要避免的词、用法说明、负责人,以及给 AI 指令用的清单。
可在 Claude、ChatGPT 和编程智能体中使用。在 Team 和 Business 套餐中,Pod 里的官方技能会在我们改进后自动更新到最新版。
适用场景
- 团队成员和 AI 工具对同一件事用不同的说法
- 你在写帮助内容或 AI 指令,需要统一词汇
你需要提供
- 源文档和界面文字
- 读者:内部、客户或两者
- 已有的术语决定
你会得到
一张按拼音或字母排序的术语表,以及一份可直接粘贴到 AI 指令里的“用 / 不用”清单。
工作方式
- 收集候选术语 产品和功能名称、业务概念、缩写、指标,以及任何有不止一种用法的词。统计每种写法出现的次数和位置。
- 按概念给不同写法分组 “账户”“客户”“客户组织”可能是一个概念,也可能是三个。判断方法:它们是否总是指同一个东西?如果不是,就分成几条,各自给出更精确的定义。
- 选定首选术语 优先选客户在产品里看到的词,其次是最常见的写法,再次是最通俗的。其他写法记为“不用”,并写明原因(旧名称、有歧义、内部行话)。
- 用通俗的话写定义 一两句话,写给从没见过这个产品的人。说明它是什么,以及它和最相近的术语有什么区别。定义里不要重复术语本身(“工作区是一个用于……的工作区”)。
- 补充用法说明 写法(用哪个字、是否加空格、中英文怎么写)、是否容易写错、缩写首次出现时是否需要写全称,再给一个例句。
- 为每个术语指定负责人 由谁来决定修改(功能名称归产品,合同术语归法务,指标归财务)。
- 整理成人和 AI 都好用的格式 一张按拼音或字母排序的表格,再加一份简短的“用 / 不用”清单,可以原样粘贴到 AI 指令里。
SKILL.md 全文
这就是 AI 读取的完整文件。 下载
---
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 助手的指令和帮助中心的写作规范里。
与团队共享
把它添加到 AI Skill Pod,团队里的每个人(包括外包人员)都能在自己的 AI 中使用同一个版本。 了解与团队共享 AI 技能的最佳方式
更新记录
- v1.0.0 · · First release.