用途:当领域实体(Domain Entity)与其他领域实体发生关联时,判定二者应属于同一聚合还是不同聚合,套用正确的引用方式,并把边界决策持久化到项目代理说明文件中,供后续任务复用。聚合是一组共享一致性边界的领域实体集群,其中一个实体为聚合根;同一聚合内实体直接相互引用,不同聚合之间仅通过聚合根的身份标识(ID)相互引用。
主要能力:判定边界(依据被关联实体是否具有独立生命周期:能否独立创建、修改、删除,能则属不同聚合,不能则属同一聚合);套用引用风格(同聚合用直接引用,集合用复数命名如 items、discounts;跨聚合仅持有对方聚合根 ID,属性命名为实体名加 Id,如 orderId、customerId,集合为 orderIds);命名一致性(无 Id 后缀表示直接引用,有 Id 后缀表示身份引用);每个聚合根一个仓储,子实体经聚合根仓储持久化与检索;将决策以固定格式追加记录到 AGENTS.md、CLAUDE.md 或同类代理说明文件,不删除或修改既有决策,除非人工明确要求。
使用方式:先查代理说明文件中是否已有覆盖这两个实体的边界决策,有则遵循;无则评估生命周期独立性,答案明确为是则不同聚合,明确为否则同聚合;若含义模糊或依赖代码中看不出的业务上下文,必须询问人工后再写代码,不得猜测。跨聚合引用时不要在领域实体定义中导入对方实体类型,需要其数据时通过其自身仓储加载,不要嵌套聚合。
适用场景:定义持有另一个领域实体引用或其标识符的领域实体、引入新实体关系、改变实体引用方式、创建与现有实体关联的新实体,以及审查此类代码时。
限制:资料未提供具体平台、语言版本要求、安装命令、收费或效果数据;边界判定依赖项目上下文,模糊时必须询问人工,无法客观确定时不应自行决定。