用途：把 dbt v1 项目从 1.3–1.7 等起始版本一路升级到 dbt 1.12，而非只做一次小版本升级。
主要能力：区分两类机制——1.8 之前为无兼容垫片的破坏性变更，需按项目当前版本逐个小版本边界依次重放；1.8 之后所有不兼容变更都通过 dbt_project.yml 的 flags: 行为标志控制，对项目实际表现出的变更把对应标志固定为 false，以保留当前语义并能在 1.12 解析。问题清单来自预编译包 references/kb_<FROM>_<ADAPTER>.json，每个问题带 action、automation_type 与 detection/fixing 上下文，不得凭记忆编造。
使用方式：先加载执行配置（本地/VS Code 用 references/exec-local.md，dbt Studio 用 references/exec-platform.md），再按固定顺序执行：Git 预检、收集适用问题、阅读项目、检测扫描、确定性修复、智能体修复与行为标志固定、人工确认修复、验证门槛（先 dbt parse，再执行配置中列出的额外检查）、重新检测、生成报告。本地确定性修复可运行 dbt-migrate-1x；Studio 无该工具，需按 context.fixing 手工修复。
适用场景：需要跨多个 dbt 小版本迁移、且希望保持现有行为语义的项目。
限制：验证针对 dbt 1.12；不得执行 pip 或安装器，环境变更仅作建议性编辑；人工问题须先展示 diff 并获确认；调用点问题（脚本、Makefile、CI YAML、作业命令）只记录不修改；不得编辑 dbt_packages/ 等依赖目录；不得在 $PROJECT 之外写入；行为标志只能通过 set-flag 操作固定，且仅针对检测到确实存在的问题。资料未提供具体价格、平台支持范围等更多信息。