用途:在代码库中强制命名一致性,维护一份活的领域术语表(thesaurus),每次需要命名时先查询它。适用于变量、函数、类、接口、枚举、聚合、实体、值对象、命令、查询、领域事件、数据库表/列、API 端点、文件目录、配置键、环境变量以及提交信息等。
主要能力:包含四种模式——命名咨询(高频)、术语表生成(罕见,见 references/generating-thesaurus.md)、命名审计(周期性,见 references/naming-audit.md)、历史挖掘(可选,见 references/git-history-mining.md)。术语表默认位于 docs/THESAURUS.md,含 YAML frontmatter 声明格式版本,采用 grep-first 布局,分 ## Index、## Terms、## Forbidden、## Legacy、## Unresolved 五节,每行一条注册记录,便于单次 rg 查询判断某名称的状态。
使用方式:先定位术语表,检查 thesaurus-format 版本;用 rg 搜索候选名称及代码中已有叫法,例如 rg -n -i 'invoice' docs/THESAURUS.md、rg -n 'OrderLineItem' docs/THESAURUS.md、rg -n 'avoid:.*Purchase' docs/THESAURUS.md。根据命中行形态决定:命中 Index 行则使用其 Identifier;命中 avoid 则改用该行 Identifier;命中 Forbidden 的 use: 则采用其后标识符;命中 Legacy 的 → 则新代码用替换名;命中 Unresolved 则不要静默决定,向用户提出。新概念先尝试复用、组合、限定、询问四步,仍无解才铸造新术语并加入术语表。
限制:术语表记录概念而非行为,擅长名词,不替代业务规则的行为规格;条目应保持简短。非英语领域可用原语言作 Term,Identifier 用代码形式。若代码与已批准术语表冲突,新代码以术语表为准;用户要求修复遗留命名时以用户指令为准。历史挖掘需 .git 且历史足够长,索引为临时文件,用完删除。资料未提供具体收费、平台与效果信息。