用途
Domain Modeling Plus 用于在项目设计过程中主动构建并打磨领域模型。它强调这是一种主动的建模纪律——挑战术语、发明边界场景、并在术语和决策成型的当下就写下来。仅仅为了词汇而阅读 CONTEXT.md 并不属于这个技能,那只是任何技能都能做到的一行习惯。这个技能适用于你正在改变模型、而不仅仅是消费模型的场景。
它可与 grill-me-plus 会话、wayfinder-plus 的 grilling 工单以及 to-spec-plus 的合成过程并行运行——在任何术语被决定的地方都适用。
文件结构
大多数仓库只有一个上下文:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-single-db-multi-tenancy.md
│ └── 0002-money-as-integer-minor-units.md
└── app/
如果根目录存在 CONTEXT-MAP.md,则仓库有多个上下文。该映射指向每个上下文所在的位置——在 Laravel 模块化单体中即模块根目录:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← 系统级决策
└── app/Domain/ ← 或 modules/、app-modules/ —— 遵循仓库约定
├── Ordering/
│ ├── CONTEXT.md
│ └── docs/adr/ ← 上下文特定决策
└── Billing/
├── CONTEXT.md
└── docs/adr/
按需惰性创建文件——只在有内容可写时才创建。没有 CONTEXT.md?在第一个术语被解决时创建。没有 docs/adr/?在需要第一个 ADR 时创建。格式参见 references/context-format.md 和 references/adr-format.md。
会话期间的做法
对照术语表挑战
当用户使用的术语与 CONTEXT.md 中已有语言冲突时,立即指出:“你的术语表把 'cancellation' 定义为 X,但你似乎指的是 Y——到底是哪个?”
锐化模糊语言
当用户使用含糊或含义过载的术语时,通过 AskUserQuestion(Claude Code)或 request_user_input(Codex)来解决:把候选的规范术语作为选项,你的推荐放在第一位,每个选项的描述说明选择它会让模型承诺什么。“你说的是 'account'——那是指 Customer 还是 User?”是一个点击即可回答的决策,而不是开放式作文题。没有结构化工具可用时,回退到在聊天中提问。
讨论具体场景
在讨论领域关系时,用具体场景对其进行压力测试。发明能探测边界情况、并迫使概念之间边界精确化的场景:“一个拥有两个 Subscription 的 Customer 在周期中途取消其中一个——已经开出的 Invoice 会怎样?”
与代码交叉引用
当用户陈述某事物如何运作时,检查代码是否同意。在 Laravel 代码库中,模型存在于比散文更多的地方——对照以下内容检查术语表术语:
- Eloquent 模型和关系名称(app/Models、HasMany 方法名)
- 迁移中的表和列名
- 枚举用例(app/Enums)
- Policy 名称和能力字符串
- Filament 资源/页面标签和导航名称
- 路由名、任务名、事件名
如果发现矛盾,就提出来:“你的代码取消整个 Order(Order::cancel()),但你刚说部分取消是可能的——哪个对?”当术语对照代码当前命名被解决时,重命名是真实的工作——把它记为一个决策(如果涉及跟踪器,也记为一个工单),绝不要悄悄吸收。
内联更新 CONTEXT.md
当术语被解决时,就在那里更新 CONTEXT.md。不要批量处理——在它们发生时捕获。使用 references/context-format.md 中的格式。
CONTEXT.md 必须完全不含实现细节。它是术语表——不是规格、不是草稿本、也不是实现决策的存放处。
谨慎提供 ADR
只有当以下三点全部为真时,才提议创建 ADR:
- 难以逆转——以后改变主意的成本是有意义的
- 没有上下文会令人惊讶——未来的读者会想“他们为什么这样做?”
- 是真实权衡的结果——存在真正的替代方案,而你出于特定理由选择了一个
如果三点中任何一点缺失,就跳过 ADR。使用 references/adr-format.md 中的格式。