dbt-osmosis 模式同步器

问题：文档漂移如何积累

在 dbt 项目中，当你修改模型、重命名字段或调整继承关系时，schema.yml 和列文档往往不会自动更新。时间一长，文档与实际模型结构逐渐偏离，出现所谓的文档漂移。继承的列元数据尤其容易过时，因为手动维护很难跟上频繁的模型迭代。这些陈旧的元数据会让新团队成员难以理解数据血缘，也会误导下游消费方。

技能如何工作

这个技能基于 dbt-osmosis，它是一个面向 dbt 开发工作流的 Python CLI 和包。核心目标是让 schema.yml 与列文档保持与项目当前状态一致，从而防止漂移累积。具体能力包括：

• 分析模型变更，同步 schema.yml 中的字段描述
• 同步继承的列元数据，确保文档反映最新的模型结构
• 提供 ad-hoc SQL 编译与运行辅助，支持开发中的快速验证

适用边界与注意点

使用前需要满足一些条件：Python 版本需在 3.10 至 3.13 之间，环境中要有 dbt Core 及兼容的适配器，并能访问目标 dbt 项目仓库。对于文档站点相关命令，还需在 docs/ 目录下使用 Node 工具链。技能侧重于元数据同步，不替代数据库迁移或测试流程。