用途:Domain 有两个相互独立的用途。一是词汇工作,把术语、名称或规则边界精确到足以支撑验收示例、代码与对话;二是标准查询,为某次变更找到适用的语言、数据格式、风险或测试设计标准。两者互不依赖。Plan 负责统一的发现与恢复,Domain 只解析所需的词汇或规则边界并交回既有意图。
词汇工作:引用现有归属方,在调用方指令、领域文档或契约中找到词汇归属方,只读取相关术语;查询是只读的。没有归属方时,把每条定义标注为代码中观察到或提议。每个限界上下文保持一个含义;词跨上下文时,命名各含义及边界处的翻译,而非强加单一全局定义。报告与意图不符的代码:识别术语所指的行为者、状态、操作与可观察结果,再与调用方、类型和测试比较;不一致是待解决的发现,重命名代码不会补上缺失行为,改定义去迁就代码会掩盖缺陷。为共享名称的重命名定价:导出名、序列化字段、存储值和 API 载荷需要兼容工作(迁移、版本化、客户端更新),而非表面替换;命名变更须在授权范围内。用示例区分:用具体案例分开竞争含义,分支边界写成 Given/When/Then 并在实现与验证中复用;仅在未解决的区分会改变行为或归属时才提问,查询无需访谈。更新归属方,默认不新增词汇表;获得授权时更新现有归属方,保留有用别名作为显式翻译;无归属方时把提议返回调用方意图或对话,不新建词汇表文件。
词汇工作按以下形状返回,然后停止:Term、Context、Meaning、Source、Distinguishing example、Open question。表后列出上下文间翻译、每处代码与意图不一致、任何提议重命名的兼容成本,以及已更新的归属方或为其提议的文本。同义词走私失败指替换词改变了术语权威,如把裁决称为关闭,会悄悄把跟踪器状态转换交给判断;当替换会转移责任时保留原术语。
AgentOps 术语:当主题是 AgentOps 时,其归属方仍为 docs/contracts/ubiquitous-language.md,职责与端口为 docs/contracts/bounded-contexts.yaml,返回其精确定义与源路径;不要把 AgentOps 词汇用于无关调用方领域。操作层、联邦集成图、语义工作与证明协议及 RPI 遍历在现行契约中保持各自含义。队列、认领、租约、关闭、落地、发布与交付仍属调用方系统职责,词汇编辑不授权这些转换。
标准查询:只加载当前变更所需的语言或风险指南,从通用标准开始。仓库契约与实际工具链优先,这些参考不创建第二条审批或验证通道。语言:Go、Python、Rust、JavaScript、TypeScript、shell。数据与文本:JSON、YAML、Markdown。相关风险:并发、SQL、LLM 信任。测试设计:测试金字塔;包形式:技能结构。理念来源:Matt Pocock 的工程技能(领域建模),为 AgentOps 改编。