Glossary — Domain Language Builder
用途
在项目根目录构建或更新 CONTEXT.md,捕获项目的领域语言。用户与智能体之间的共享词汇可减少冗长表达(智能体不必用 20 个词代替 1 个领域术语),在代码中强制一致命名,并防止跨会话的术语漂移。
主要能力
- 新建 CONTEXT.md:若无该文件,通过引出会话发现领域术语。
- 探索代码库识别领域特定命名模式——类型、模块、关键抽象、变量名和注释中反复出现的名词。
- 向用户呈现发现结果:“我在代码中发现这些领域概念:[列表]。哪些值得定义?是否有命名不一致的?”
- 对每个确认的术语解析四个字段:规范名称、一句话定义、应避免的别名、与其他术语的关系。这四个字段是智能体正确且一致使用术语所需的最小集合——更少会导致歧义,更多则增加噪音。
- 询问歧义:“[术语] 与 [相似术语] 是同一个,还是不同的?”尽早暴露这些问题,因为未解决的近义词是智能体生成代码中命名不一致的主要来源。
- 按 references/context-format.md 中的格式写入 CONTEXT.md。
使用方式
更新已有 CONTEXT.md:
- 若 CONTEXT.md 已存在,先阅读它。
- 识别触发本次调用的新概念或歧义。
- 检查它是否适配现有术语(更新定义)或确实是新的(添加它)。
- 若新概念与现有术语冲突,将其加入“Flagged ambiguities”并给出清晰解决方式。
- 保留所有现有内容——追加,不要重写。重写会破坏跨会话的术语溯源,并可能静默丢失其他会话依赖的术语。
在其他工作中使用 CONTEXT.md:
- 在开始探索或修改带有 CONTEXT.md 的项目代码前,先阅读 CONTEXT.md。严格使用其中的术语——而不是词汇表明确避免的同义词。一致的术语可降低领域对话与实现之间的认知翻译成本。
- 记录当前任务需要但词汇表中缺失的概念,将其标记为下次 /glossary 会话的候选。
- 使用词汇表的词汇命名变量、函数、类型和文件。
适用场景
- 需要与智能体长期协作、统一领域术语的项目。
- 代码命名不一致或存在近义词混淆的代码库。
- 跨多个会话维护术语一致性的场景。
限制
资料未提供关于费用、价格、平台支持范围、具体运行环境要求或性能效果的说明。具体格式细节需参考 references/context-format.md,该文件内容暂未提供。