用途:为项目维护一份精简且有主见的领域词汇表,让人类与 AI 对关键概念保持一致理解。把术语分歧视为可能的领域模型分歧,而非单纯用词问题,从而防止术语漂移、自造词汇、过时概念框架与同义词膨胀。
主要能力:提供三类工作流,按用户意图选择(不明确时先询问)。一是词汇表编写:定位并通读现有权威词汇表(LEXICON.md、TERMS.md、GLOSSARY.md、CONTEXT.md 及相关 README 章节),报告重叠并确认权威来源,默认新建于根目录 LEXICON.md;用两个以上并行的只读子代理从规格文档、模式/API/公共类型、概念冲突中提取候选术语,要求给出术语问题与确切证据位置。二是词汇表审计:通读规范术语、实现引用与 Avoid 条目,并行扫描被禁术语、规范误用、新造词汇与概念冲突,排除生成与第三方文件,并按安全层级分类明确违规。三是命名评审:检查误导性、过载、不一致、独有或不对称的名称,区分真实概念问题与无害的措辞差异。
核心规则:一个概念一个术语,保留唯一规范名,拒绝泛化词与臆测同义词,不发明折中名称;术语需有代码、文档、模式、项目历史或外部来源作依据;词汇表只管术语,不引入或裁定架构、实现与项目状态,未决的领域决策呈交用户;条目只写识别概念所需的边界事实,不做成流程或微型规格;判断标准是“该事实变化时术语含义是否不变”,若是则从定义中剔除,仅在需要区分概念时保留条件、关系或生命周期事实。用户权威:概念冲突由用户裁定,不静默选择或重开已定决策。
候选术语准入:仅当条目能解决有证据的命名或含义歧义,或解释读者正确使用术语所需的项目特有区别时才纳入;显著性、频率与架构重要性不足以作为理由。
审查与处置:将发现分为加入词汇表、与用户讨论、提出项目改动、丢弃四类;对有后果的发现,调用新的怀疑性子代理,检查术语准入与定义是否符合定义测试后再推进。接受的术语立即写入并简要告知用户;被替换的规范术语保留在 Avoid 下;项目改动仅应用用户批准的变更。
变更安全层级:Tier 1 为散文、注释、未导出标识符;Tier 2 为共享类型、接口、跨模块签名,需明确批准加类型检查与测试;Tier 3 为持久化模式、公共 API、线路契约、CLI 标志、序列化数据、日志,需迁移或兼容方案。术语按风险最高出现处定级,混合风险术语不得当作机械替换。
格式:标题为 Project Lexicon,按领域或子系统分组,每个规范术语给一两句定义与边界、生命周期角色,必要时加“不要与 X 混淆”说明,以及 Reference(稳定公共类型、表或 API 契约)、AKA(仅列外部标准或上游项目使用的名称)、Avoid(仅有证据的废弃名或用户明确拒绝的替代名);不适用时省略这些元数据项。范围上,导出、持久化、公共与线路标识符使用规范复合名词,局部无歧义作用域允许简洁名与描述性修饰(activeUser、userId)。
限制:资料未提供具体安装命令、收费与价格信息;各工作流依赖可用的子代理能力,审计需排除生成与第三方文件,涉及兼容面的改动必须先有迁移或兼容计划。