--- 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 | ### 术语边界定义(示例) - 识别项目中语义重叠的术语对 - 按场景划分各术语的适用范围 - 在工程规范文档中记录规则