用途:为项目建立并维护术语表(glossary),防止同一概念出现多种叫法导致命名漂移。它不是项目词典,只收录真正存在命名陷阱的术语。
主要能力:决定项目需要单一术语表还是按限界上下文拆分;用“陷阱测试”筛选术语,只收录存在貌似合理但错误叫法的词;每个条目定义术语“是什么”而非“做什么”,并在 Avoid 行写出错误别名及理由。可选内容含上下文映射、按子域分组、标记歧义、关系说明和示例对话。
使用方式:术语表放在 docs/glossary.md 或 docs/ubiquitous-language/glossary.md,按上下文则用 {context}-glossary.md,多上下文可加 context-map.md,并在 CLAUDE.md 中早期引用而不内联。应用术语时先找到术语表,读取相关词条,使用规范名,主动避开 Avoid 条目;概念不在表中时先跑陷阱测试再决定是否新增。更新为事件驱动:出现命名错误、新概念、含义变化或被弃用名时即时编辑,就地修改,不记变更日志;不再有陷阱的条目删除。重复运行时是重新推导,可增可减,而非追加。
适用场景:多人或多 AI 协作、同一概念存在多种候选名称、第三方库术语渗入本地代码、一词多义等情况。
限制:只为有真实命名风险的概念建档,实现细节、配置字段、有唯一规范名的外部服务、通用编程概念不应收录。条目用标题而非表格,Avoid 行必须带理由。若资料未提供具体适用范围之外的细节,暂未提供。