5.2.4 别让黑话搞晕团队——术语表维护
一句话破题
术语表确保所有人（包括 AI）对同一个词有相同的理解。
为什么术语容易混淆
同一个词，不同人可能有不同理解：
| 术语 | 你以为的意思 | 他以为的意思 |
|---|---|---|
| 用户 | 已注册账号 | 任何访问者 |
| 文章 | 博客帖子 | 任何内容 |
| 管理员 | 超级管理员 | 普通运营人员 |
这种理解差异会导致：
- 代码实现偏差：AI 按错误的理解生成代码
- 沟通效率低：反复解释"我说的不是这个意思"
- 后期返工：验收时才发现理解不一致
术语表的标准格式
markdown
## 术语表
| 术语 | 定义 | 备注 |
|------|------|------|
| 用户（User） | 已完成注册并通过邮箱验证的账号 | 与"访客"区分 |
| 访客（Visitor） | 未登录状态下的浏览者 | 可浏览公开内容 |
| 文章（Post） | 由用户创建的博客内容 | 包含标题、正文、标签 |
| 草稿（Draft） | 未发布的文章 | 仅作者可见 |
| 管理员（Admin） | 拥有后台管理权限的用户 | 可管理所有用户和内容 |术语定义的原则
1. 明确边界
❌ 用户：使用系统的人
（太模糊：访客算不算用户？）
✅ 用户：已完成注册并通过邮箱验证的账号
（清晰：有明确的判断标准）2. 区分相似概念
✅ 用户 vs 访客
✅ 文章 vs 草稿
✅ 发布 vs 保存3. 与代码保持一致
术语表中的名称应该与代码中的命名一致：
markdown
| 术语 | 代码中的命名 |
|------|--------------|
| 用户 | User |
| 文章 | Post |
| 评论 | Comment |术语表的维护
- 项目初期建立：在写第一份文档时就创建术语表
- 随时补充：发现新概念就添加
- 统一引用：所有文档都引用同一份术语表
- 定期审查：确保定义仍然准确
对 AI 协作的影响
向 AI 提供术语表，能避免理解偏差：
在这个项目中，以下术语有特定含义：
- 用户：已完成注册并通过邮箱验证的账号
- 访客：未登录的浏览者
- 文章：用户创建的博客内容，包含 title、content、tags
请基于以上定义，实现用户发布文章的功能。简化方案
对于小项目，可以直接在 PRD 开头定义关键术语：
markdown
## 术语说明
- **用户**：已注册账号
- **文章**：博客帖子
## 功能描述
...实用建议
- 不要过度定义：只定义容易混淆的术语，常识性概念不需要
- 用示例辅助：复杂概念可以举例说明
- 保持更新：概念变化时及时更新定义
- 中英文对照：技术术语最好同时给出中英文