29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
---
|
|
name: 文档术语一致性
|
|
description: 术语歧义识别与统一方法论：设备vs客户端的澄清经验
|
|
type: feedback
|
|
originSessionId: 28a03600-d3f7-4b7e-bc74-4c53961c17b5
|
|
---
|
|
## 规则：文档术语必须语义边界清晰
|
|
|
|
**Why**: 项目文档中容易存在语义重叠的术语，导致越界混用。歧义术语不解决会随文档增长而扩散。
|
|
|
|
**How to apply**:
|
|
1. **识别重叠**：grep 统计两个候选词的出现频率和上下文
|
|
2. **判断是否可合并**：若语义完全相同则统一为一个词；若描述不同视角则保留两者但建边界
|
|
3. **制定规则**：按场景划分各术语的适用范围（如：密码统一用"客户端密码"）
|
|
4. **修复越界**：仅修改不符合规则的用法，保留合理的
|
|
5. **补充规范**：在 `docs/11-工程规范.md` 术语表记录规则
|
|
|
|
### 已完成的术语澄清
|
|
|
|
| 术语 | 规则 | 文档 |
|
|
|------|------|------|
|
|
| 设备 vs 客户端 | 设备=服务端注册实体(ID/授权/管理)；客户端=用户软件(密码/登录/功能) | `docs/11-工程规范.md` §1.5 |
|
|
|
|
### 术语边界定义（示例）
|
|
|
|
- 识别项目中语义重叠的术语对
|
|
- 按场景划分各术语的适用范围
|
|
- 在工程规范文档中记录规则
|