domain-modeling

Files (4)

• ADR-FORMAT.md
• CONTEXT-FORMAT.md
• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# 领域建模

在设计时主动构建并磨利项目的领域模型。这是 *主动* 纪律 — 挑战术语、发明边界情形场景，并在词汇和决策刚结晶的那一刻写下来。（仅仅 *阅读* `CONTEXT.md` 拿词汇不是本 skill — 那是任何 skill 都能做的一行习惯。本 skill 用于你在改变模型，而不仅仅是消费它的时候。）

## 文件结构

大多数仓库只有一个 context：

```
/
├── CONTEXT.md
├── docs/
│   └── adr/
│       ├── 0001-event-sourced-orders.md
│       └── 0002-postgres-for-write-model.md
└── src/
```

若根目录存在 `CONTEXT-MAP.md`，仓库有多个 context。地图指向每一个所在之处：

```
/
├── CONTEXT-MAP.md
├── docs/
│   └── adr/                          ← system-wide decisions
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← context-specific decisions
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/
```

惰性创建文件 — 只有当你有东西可写时才建。若没有 `CONTEXT.md`，在第一个术语敲定时创建。若没有 `docs/adr/`，在需要第一份 ADR 时创建。

## 会话期间

### 对照词汇表提出挑战

当用户使用的术语与 `CONTEXT.md` 中的既有语言冲突时，立刻指出来。「你的词汇表把『cancellation』定义为 X，但你似乎指的是 Y — 到底是哪个？」

### 磨利模糊语言

当用户使用含糊或过载的术语时，提出一个精确的规范术语。「你在说『account』 — 你指的是 Customer 还是 User？那是两件不同的事。」

### 讨论具体场景

当正在讨论领域关系时，用具体场景给它们加压。发明探测边界情形的场景，迫使对概念之间的边界说精确。

### 与代码交叉对照

当用户陈述某事如何运作时，检查代码是否同意。若发现矛盾，摊开来：「你的代码取消的是整张 Order，但你刚才说部分取消是可能的 — 哪个对？」

### 当场更新 CONTEXT.md

当一个术语敲定时，立刻更新 `CONTEXT.md`。不要攒着批处理 — 发生时就捕获。使用 [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md) 中的格式。

`CONTEXT.md` 应完全不含实现细节。不要把 `CONTEXT.md` 当 spec、草稿本或实现决策的仓库。它是词汇表，别无其他。

### 吝啬地提供 ADR

只有以下三点全部为真时，才提议创建 ADR：

1. **难以逆转** — 以后改主意的成本是有意义的
2. **没有 context 会令人惊讶** — 未来的读者会纳闷「他们为什么这样做？」
3. **真实权衡的结果** — 存在真正的备选，你出于具体理由选了其中一个

三点缺任何一点，就跳过 ADR。使用 [ADR-FORMAT.md](./ADR-FORMAT.md) 中的格式。

From shenjunjian/matt-skill-cn, MIT.

More from shenjunjian/matt-skill-cn