DDD 全流程开发规范(ddd-lifecycle)
从零搭建到日常演进的一体化 DDD 开发规范。由三个互补组件构成(均为 MIT,原文见 references/,来源与许可见 references/ATTRIBUTION.md):
- modeling/ — 语言纪律与决策留痕(源自 mattpocock/skills):统一语言词汇表、上下文映射、按 spec-dev 规范记录 ADR
- methodology/ — DDD 全景方法论与模型评分(源自 wondelai/skills):六大模块 + 10 分制诊断
- architecture/ — 六边形架构施工手册(源自 affaan-m/ECC):Ports & Adapters、分层、迁移、测试
三者零重叠:modeling 管"说话与决策",methodology 管"建模与裁决",architecture 管"分层与施工"。
文档规范（独立与被调用完全统一）
实际文档动作前取得 跨技能文档规范； 已有当前定义直接复用。本 skill 专注建模，不另设文档位置、保存权限或 ADR 生命周期。
- 跨特性领域术语：
.spec-dev/glossary.md；同名不同义以适用域区分。 - 本特性局部术语：对应 spec 的术语节；没有适用 spec 时先留候选，不自动创建实施档案。
- ADR：
.spec-dev/adr/，统一编号及 Accepted/Deprecated/Superseded 生命周期。 - 完整设计或当前保存范围获批后才写，同范围已有授权直接复用，不逐项请示。
- 无内容不创建文件；不自动搬移、删除或双写已有 CONTEXT.md、docs/adr/ 等旧位置。
- 上下文关系仍应建模；需要图或映射时按当前任务授权表达，不以映射工作为由自动建立第二套词汇表。
全流程阶段编排
按当前所处阶段加载对应参考文档(渐进披露——只读当下需要的):
| 阶段 | 做什么 | 深读 | 产出 |
|---|---|---|---|
| 0 领域发现(项目第一天) | 与用户磨统一语言:挑战模糊术语、编造边界场景压测领域关系、用代码交叉验证说法 | modeling/SKILL.md + modeling/CONTEXT-FORMAT.md | 获授权的共享/局部术语记录 |
| 1 上下文映射(子域变多时) | 识别限界上下文、选定九种映射模式(ACL/共享内核/开放主机…) | modeling/SKILL.md(文件结构节)、methodology/bounded-contexts.md、methodology/strategic-design.md | 获授权的上下文关系表达 |
| 2 架构奠基(搭工程骨架) | 六边形六步:用例边界→出站端口先行→纯编排用例→边缘适配器→组合根→按边界分层测试 | architecture/SKILL.md(全文) | 分层骨架 + 端口接口 |
| 3 战术建模(每个需求) | 实体/值对象判定、聚合边界、领域事件、仓储与工厂 | methodology/SKILL.md 模块 3–5 + methodology/building-blocks.md、domain-events.md、repositories-factories.md | 领域模型代码 |
| 4 编码施工(持续) | 语言纪律 + 分层规则 + 按边界测试,两者同时常驻 | modeling/SKILL.md(会话动作节)+ architecture/SKILL.md(反模式/测试节) | 代码 + 按统一授权保存术语 |
| 5 抉择点(事件驱动) | 见下方抉择路由表 | 按路由 | ADR(仅过门槛者) |
| 6 审查自检(每迭代/里程碑) | 10 分制模型评分:7 行快速诊断各 1 分 + 3 项深度加分,报告失败行与修复动作 | methodology/SKILL.md(Scoring 节) | 评分报告 + 修复清单 |
开发中的 DDD 抉择路由表
| 你在纠结什么 | 裁决依据 | 深读 |
|---|---|---|
| "这是实体还是值对象?" | 身份测试:"属性全变还是不是同一个?"是→实体;"只由属性定义?"是→值对象。多数时候应是值对象 | methodology/building-blocks.md |
| "聚合边界画哪?该合并吗?" | 聚合保持小;跨聚合只按 ID 引用;立即一致性仅在聚合内,之间设计最终一致 | methodology/building-blocks.md |
| "这个状态变化要发事件吗?" | 只发领域专家关心的事(过去时命名);领域事件留在上下文内,跨上下文用集成事件 | methodology/domain-events.md |
| "要不要上事件溯源/CQRS?" | 先明确解耦与审计诉求;事件溯源以事件史为事实源,按需引入 | methodology/domain-events.md |
| "这个词该进词汇表吗?" | 只收词汇表条目:业务术语及其定义;通用编程概念(timeout、错误类型)即使常用也不收 | modeling/CONTEXT-FORMAT.md |
| "两个词是一回事吗?" | 即时挑战,逼出规范词;定不下来通常说明模型有问题(命名困难=设计信号) | modeling/SKILL.md、methodology/ubiquitous-language.md |
| "这个决策值得写 ADR 吗?" | 三条件缺一不写:①难逆转 ②缺上下文会令未来读者费解 ③真实取舍的结果 | modeling/SKILL.md + modeling/ADR-FORMAT.md |
| "这段逻辑放哪层?" | 依赖永远内向:domain 不 import 框架;出站端口归 application 层;映射留在适配器 | architecture/SKILL.md |
| "外部系统的模型渗进来了?" | 防腐层(ACL)在边界翻译,绝不让外来模型污染核心域 | methodology/bounded-contexts.md |
| "这个子系统该上多重的 DDD?" | 10 分制评分定轻重:≤3 分 → 只做统一语言,别过度设计 | methodology/SKILL.md(Scoring 节) |
| "怎么从旧结构迁到六边形?" | Strangler 渐进:按用例切片、每步可回滚;先边界后细节 | architecture/SKILL.md(迁移节) |
常驻纪律(任何阶段都生效)
- 术语冲突即时挑战:用户用词与适用领域定义冲突时及时指出；保存服从统一文档规范，术语敲定不自动产生写入授权。
- 依赖永远内向:Adapters → application/domain;application → 端口;domain → 任何外部的东西都不依赖。
- ADR 三条件门槛:难逆转 + 缺上下文费解 + 真实取舍,缺一条就跳过。
- 词汇表只记录领域术语：不作 spec、草稿本或实现决策存储；局部术语留对应 spec。
参考文档索引
references/
├── ATTRIBUTION.md 来源与 MIT 许可
├── modeling/ 语言纪律与决策(mattpocock/skills)
│ ├── SKILL.md 会话中的主动建模纪律(六类动作)
│ ├── CONTEXT-FORMAT.md 词汇表格式(单/多上下文)
│ └── ADR-FORMAT.md ADR 极简格式
├── methodology/ DDD 方法论(wondelai/skills)
│ ├── SKILL.md 六大模块 + 10 分制评分(全景入口)
│ ├── ubiquitous-language.md
│ ├── bounded-contexts.md 九种上下文映射模式
│ ├── building-blocks.md 实体/值对象/聚合规则
│ ├── domain-events.md 事件命名/事件溯源/集成事件
│ ├── repositories-factories.md
│ └── strategic-design.md 子域划分/核心域识别/精炼
└── architecture/ 六边形施工(affaan-m/ECC)
└── SKILL.md 6 步实施/模块布局/反模式/迁移/测试/TS·Java·Kotlin·Go 映射
使用约束
- 语言无关:方法论与流程适用于任何语言;代码示例仅为示意,按当前项目语言翻译心智模型。
- 不预设微服务:限界上下文默认落在模块边界(模块化单体);上下文 ≠ 服务。
- 本 skill 是编排层,参考文档保留领域方法；文档位置、保存权限和生命周期以统一文档规范为准，其他冲突按常驻纪律及用户要求处理。