Files
team/memory/terminology-consistency.md
T
2026-04-19 21:47:08 +08:00

1.2 KiB

name, description, type, originSessionId
name description type originSessionId
文档术语一致性 术语歧义识别与统一方法论:设备vs客户端的澄清经验 feedback 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

术语边界定义(示例)

  • 识别项目中语义重叠的术语对
  • 按场景划分各术语的适用范围
  • 在工程规范文档中记录规则