领域建模 是做什么的?
在设计过程中主动构建并精炼项目的领域模型。这是一项主动的规范 —— 质疑术语、发明边界场景,并在概念形成的那一刻立即记录术语和决策。(仅仅阅读 CONTEXT.md 中的词汇并非此技能——那是任何技能都能做到的一行习惯。本技能适用于当你在改变模型,而不仅仅是消费它时。)
文件结构
大多数仓库只有一个上下文:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
如果根目录存在 CONTEXT-MAP.md,则表示仓库有多个上下文。该文件指向每个上下文所在位置:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← 系统级决策
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← 上下文特定决策
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
在你有内容需要写入之前,请懒惰地创建文件。如果 CONTEXT.md 不存在,则在解析第一个术语时创建。如果 docs/adr/ 不存在,则在需要第一个 ADR 时创建。
在会话期间
对照术语表进行质疑
当用户使用的术语与 CONTEXT.md 中已有语言冲突时,立即指出。“你的术语表将‘取消’定义为 X,但你似乎指的是 Y —— 实际是哪一个?”
精炼模糊语言
当用户使用模糊或过载的术语时,提出一个精确的规范术语。“你说的是‘账户’—— 你指的是客户还是用户?这两者是不同的。”
讨论具体场景
当讨论领域关系时,用具体场景对其进行压力测试。构思能够探测边界情况的场景,迫使用户精确界定概念之间的界限。
与代码交叉引用
当用户陈述某个功能的运作方式时,检查代码是否一致。如果发现矛盾,提出来:“你的代码取消了整个订单,但你刚刚说可以部分取消 —— 哪个是正确的?”
内联更新 CONTEXT.md
当某个术语被解析时,立即更新 CONTEXT.md。不要批量处理——在它们发生时捕获。使用 CONTEXT-FORMAT.md 中的格式。
CONTEXT.md 应完全不含实现细节。切勿将 CONTEXT.md 视为规范、草稿或实现决策的存储库。它仅且仅是一个术语表。
谨慎提供 ADR
仅在以下三个条件同时满足时才提出创建 ADR:
- 难以撤销 —— 日后改变主意的成本很大
- 缺乏上下文则令人费解 —— 未来的读者会疑惑“他们为什么这样做?”
- 真实权衡的结果 —— 存在真正的备选方案,并且你基于特定原因选择了其中一个
如果缺少任何一条,则跳过 ADR。使用 ADR-FORMAT.md 中的格式。