跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

domain-modeling · 统一团队对业务概念的理解

从实际场景与代码用词中识别歧义,建立有边界、有例子的领域词汇表。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

场景:未付款订单可取消;付款后客户申请退回款项;现有文档都叫撤销。

输出

编辑示例 · 未运行
取消:终止尚未完成的订单流程;本场景中未付款订单可取消。

退款:已发生付款后的资金退回流程;退款完成不自动等于订单取消。

禁用歧义词:撤销,除非明确说明操作对象。

待确认:已付款但未发货时,取消与退款是否联动。

方法说明

从实际场景与代码用词中识别歧义,建立有边界、有例子的领域词汇表。

具体任务

澄清含义冲突的术语:用具体业务例子检验概念边界,记录到词汇表。

记录领域决策:仅对有真实取舍的模型选择写简短ADR。

必需材料

业务场景及现有术语

相关代码或数据模型

可选材料

现有GLOSSARY.md

历史决策记录

使用门槛

能提供术语在真实场景中的用法,并由业务参与者确认含义。

这个 Skill 额外提供的方法

让开发、产品和运营讨论同一词时有相同的对象与反例。

编辑示例(未运行)

分清订单取消与退款

任务:为两个容易混用的词写领域词条

输入:
场景:未付款订单可取消;付款后客户申请退回款项;现有文档都叫撤销。

结果片段:
取消:终止尚未完成的订单流程;本场景中未付款订单可取消。

退款:已发生付款后的资金退回流程;退款完成不自动等于订单取消。

禁用歧义词:撤销,除非明确说明操作对象。

待确认:已付款但未发货时,取消与退款是否联动。

以下为官方编辑构造的示例,未运行上游 Skill。通过边界情况留下待决问题,不把例子扩写成未经确认的完整状态机。

首次任务

任务:澄清含义冲突的术语。
任务重点:用具体业务例子检验概念边界,记录到词汇表。

必需材料:
- 业务场景及现有术语:[填写或粘贴我的材料;未具备则说明]
- 相关代码或数据模型:[填写或粘贴我的材料;未具备则说明]

可选补充:
- 现有GLOSSARY.md:[可填写,未提供不应假定存在]
- 历史决策记录:[可填写,未提供不应假定存在]

请交付可直接审阅或编辑的文稿,并单列待确认信息。仅依据这些材料处理;缺少决定结果的信息时先说明缺口,不补造事实。未执行的检查、修改或外部操作明确标为未执行。

使用前提:能提供术语在真实场景中的用法,并由业务参与者确认含义。
处理边界:同名概念在不同业务域可有不同定义;不能仅凭改名就声称业务模型已统一

验收要求:
1. 每个术语有正例和边界说明。
2. 词汇表与代码现状差异可定位。
3. ADR说明真正的取舍。

验收方法

每个术语有正例和边界说明

词汇表与代码现状差异可定位

ADR说明真正的取舍

依赖与准备

可读写仓库文档的助手;保留已有GLOSSARY-MAP及ADR组织约定。

使用边界

同名概念在不同业务域可有不同定义

不能仅凭改名就声称业务模型已统一

排错

大家同意词但仍各说各话:换具体边界场景验证理解。

词汇表越写越散:按业务上下文分组并建立明确索引。

固定来源

https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/engineering/domain-modeling/SKILL.md