API设计工作流与使用StopLight的捆绑YAML OpenAPI定义

考虑到我所面临的挑战，我想听听您对如何执行API工作流的反馈

我需要使用一种设计优先的方法来设计我的API，我选择了StopLight（免费）。我开始使用一个YAML来存储所有实体和操作，但后来我决定分离实体，因为在不同的定义上维护多个实体太麻烦了，所以我将每个实体放在不同的文件中，并在定义中引用它们

这使得设计过程更加容易，因为实体在多个specc之间被重用。问题开始了，我们希望导出定义以在Azure API管理上导入，并提供给外部各方。我尝试了两种StopLight导出选项，但我不喜欢输出，让我举例说明：

我用于设计的正常场景：

导出，捆绑版本（推荐）：

导出取消引用：

所有这些都是根据定义验证的，但最后的选项很奇怪，而且真的无法理解定义

有人面临过这个挑战吗？我不确定这是否是一个产品问题，或者我可能在定义上做错了什么

先谢谢你