先看看示例
作者提供的示例,实际效果取决于你的输入和使用工具。
输入
场景:未付款订单可取消;付款后客户申请退回款项;现有文档都叫撤销。
输出
编辑示例 · 未运行
取消:终止尚未完成的订单流程;本场景中未付款订单可取消。
退款:已发生付款后的资金退回流程;退款完成不自动等于订单取消。
禁用歧义词:撤销,除非明确说明操作对象。
待确认:已付款但未发货时,取消与退款是否联动。
方法说明
从实际场景与代码用词中识别歧义,建立有边界、有例子的领域词汇表。 具体任务 澄清含义冲突的术语:用具体业务例子检验概念边界,记录到词汇表。 记录领域决策:仅对有真实取舍的模型选择写简短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