SuperAPI AI 工具集

domain-modeling-plus

编程与开发

查看项目

更新于 10-23 16:18

技能介绍

用途

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 中的格式。