domain-modeling-zh · git:20260910.0667b2c · 2026-09-10 · sha256 309d9f28735a96ff
domain-modeling-zh git:20260910.0667b2cA
Immutable. This exact content never changes and is served at /api/v1/blob/309d9f28735a96ff.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_d6chqp45intb4634/309d9f28735a96ff2ee72c7357d14137ae7f5df7a388eeab04bd246f929b802f.json
Then /plugin install domain-modeling-zh@markdownregistry-d6chqp45intb4634 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: domain-modeling-zh description: 构建并打磨项目的 domain model(领域模型)。当讨论 codebase 术语、编写或编辑 CONTEXT.md,或记录或编辑 ADR 时使用。 --- # Domain Modeling 在设计过程中主动构建并打磨项目的 domain model。这是一种*主动*的纪律 — 质疑术语、虚构 edge-case(边界情况)场景,并在术语和决策成形的瞬间把它们写下来。(仅仅*阅读* `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`,说明仓库有多个 contexts。该地图指向每个 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 时创建它。 ## 会话期间 ### 对照 glossary 提出质疑 当用户使用的术语与 `CONTEXT.md` 中现有的语言冲突时,立即指出来。"你的 glossary 把 'cancellation' 定义为 X,但你似乎指的是 Y — 到底是哪个?" ### 打磨模糊的语言 当用户使用含糊或一词多义的术语时,提出一个精确的规范术语。"你在说 'account' — 你指的是 Customer 还是 User?那是两个不同的东西。" ### 讨论具体的场景 当讨论 domain 关系时,用具体的场景对它们做压力测试。虚构一些探针式 edge cases 的场景,迫使用户对概念之间的边界保持精确。 ### 与代码交叉对照 当用户陈述某样东西如何运作时,检查代码是否一致。如果发现矛盾,把它摆到台面上:"你的代码取消整个 Orders,但你刚才说部分取消是可能的 — 哪个是对的?" ### 即时更新 CONTEXT.md 当一个术语被确定时,就地更新 `CONTEXT.md`。不要批量积攒 — 随时发生随时记录。使用 [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md) 中的格式。 `CONTEXT.md` 应该完全不含 implementation 细节。不要把 `CONTEXT.md` 当作 spec、草稿本或 implementation 决策的仓库。它是 glossary,仅此而已。 ### 谨慎地提议 ADR 只有当以下三件事都成立时,才提议创建 ADR: 1. **难以逆转(Hard to reverse)** — 日后改变主意的成本是实质性的 2. **脱离上下文会令人费解(Surprising without context)** — 未来的读者会想 "why did they do it this way?(他们为什么这样做?)" 3. **真实权衡的结果(The result of a real trade-off)** — 存在真正的备选方案,而你出于具体原因选择了其中一个 如果三者缺一,跳过 ADR。使用 [ADR-FORMAT.md](./ADR-FORMAT.md) 中的格式。