数据库迁移任务，看似简单实则暗藏风险。手动编写SQL迁移脚本不仅容易出错，也极其耗时。如果您已经部署了CodeBuddy，完全可以借助其对数据库模型与Schema差异的智能识别功能，让整个迁移流程既高效又可靠。以下五种实践验证过的途径，能帮助您快速上手。

如果您仍然为每次表结构变更都得手写迁移脚本而烦恼，害怕出现遗漏或错误，那么很可能您尚未完全激活CodeBuddy的这一能力。下面，我们详细解析具体操作。

一、利用CodeBuddy CLI进行结构对比并自动生成基础迁移脚本

这一方法的核心在于让CodeBuddy CLI深度解析项目中的ORM模型定义，并与当前数据库实际结构进行全面比对，最终自动输出Python格式的迁移文件——该文件与Alembic等主流迁移框架天然兼容。

具体操作步骤如下：

1. 在项目内配置数据库连接URL，可通过环境变量或配置文件设置DATABASE_URL。

2. 在终端中输入结构检测命令：codebuddy db migrate --autogenerate -m "add user_profile table"。

3. 检查输出目录（默认位于migrations/versions/）中是否生成了带时间戳和描述的.py文件。

4. 打开该文件，确认upgrade()函数内包含op.create_table()或op.add_column()等实际调用，而非仅留空的pass占位符。

二、借助CodeBuddy Craft模式交互式生成定制化SQL迁移语句

当目标数据库不支持ORM抽象层，或DBA要求纯SQL供人工审核时，Craft对话模式尤为实用。只需用自然语言描述需求，CodeBuddy便能实时生成语法正确、业务逻辑匹配的SQL片段。

操作流程简洁直观：

1. 在VS Code中打开项目，激活CodeBuddy侧边栏，点击Craft按钮进入交互会话。

2. 发出明确指令，例如：“生成SQL语句：为users表新增email_verified BOOLEAN字段，默认值为FALSE，并添加CHECK约束确保值仅限TRUE/FALSE”。

3. 等待数秒，CodeBuddy将返回完整SQL，通常包含ALTER TABLE、ADD COLUMN和ADD CONSTRAINT等子句。

4. 将输出内容复制到SQL客户端或迁移脚本中，替换占位符后即可执行验证。

三、整合WorkBuddy迁移流程，通过CodeBuddy增强注释与字段行为控制

此路径适合已接入WorkBuddy迁移流程的项目。CodeBuddy能理解代码上下文，协助补充WorkBuddy所需的识别注释（如# workbuddy: default=...），从而实现更精确的字段级控制，提升脚本的长期可维护性。

具体操作如下：

1. 在模型定义中找到需要迁移的字段，例如created_at = Column(DateTime)。

2. 向CodeBuddy提出需求：“为上述字段添加WorkBuddy兼容注释，使其在迁移中自动设置数据库级默认值为CURRENT_TIMESTAMP”。

3. 它将返回类似结果：# workbuddy: server_default='CURRENT_TIMESTAMP' created_at = Column(DateTime)。

4. 将该注释插入字段定义上方，保存后重新执行workbuddy revision --autogenerate命令，更新将自动触发。

四、从现有数据库反向生成ORM模型与配套迁移脚本

在遗留系统重构等场景中，这一路径尤为适用。CodeBuddy可直接读取目标数据库的Schema，反向生成对应的ORM模型代码，并附带一套初始化迁移脚本——快速实现从“数据库先行”到“代码同步”的闭环。

操作步骤清晰明了：

1. 执行反向工程命令：codebuddy db reflect --url $DATABASE_URL --output models/。

2. 检查models/目录下是否生成了user.py、order.py等模块，其中包含Table和Column的定义。

3. 接着初始化迁移：codebuddy db migrate --autogenerate -m "initial reflection from prod"。

4. 仔细核对生成的脚本中是否包含op.create_table()调用，确认字段类型、长度、NULL约束与原库完全一致。

五、利用CodeBuddy Skills进行预设数据库迁移审查

加载自定义Skills（如db-migration-reviewer）后，CodeBuddy可在脚本生成后自动执行合规性审查——识别缺少索引的位置、危险的DDL操作、遗漏的事务边界等问题，一目了然。

操作起来也十分便捷：

1. 确认.skills/db-migration-reviewer/目录存在且已启用，可通过codebuddy list skills验证。

2. 将待审核的迁移脚本路径交给CodeBuddy：/review migration_abc123.py with db-migration-reviewer。

3. 它将返回结构化反馈，例如提示：“⚠️ 中等：ALTER TABLE users DROP COLUMN phone未包含备份步骤，建议先ADD COLUMN phone_backup”。

4. 根据提示修改脚本，再次提交审查，直至无严重告警为止。