CodeBuddy AI编写数据库迁移脚本高效指南
数据库迁移的复杂度往往取决于具体场景，但手动编写SQL迁移脚本确实容易遗漏字段约束、索引或数据类型，且效率偏低。如果你已经在项目中引入CodeBuddy，完全可以借助它对ORM模型与数据库Schema差异的智能解析能力，将迁移流程自动化、标准化。以下五条实践路径均经过生产环境验证，可直接复用。
如果你每次改动表结构时依然用手写迁移脚本、担心误操作或漏掉关键字段，说明CodeBuddy的数据库差异对比能力尚未被充分利用。下面逐一拆解具体操盘方式。
一、通过CodeBuddy CLI执行结构比对并生成基础迁移脚本
此方案的核心是让CodeBuddy CLI解析项目中的ORM模型定义，并与当前数据库实际Schema进行全量对比，最终自动输出一份与Alembic等主流迁移框架兼容的Python迁移文件。
实施步骤十分简洁：
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()等实际DDL调用，而非空pass占位。
二、使用CodeBuddy Craft模式交互式生成定制化SQL迁移语句
当目标数据库不支持ORM抽象层（如MySQL/MariaDB原生模式），或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命令，迁移更新自动触发。
四、从现有数据库反向生成模型与配套迁移脚本
面对遗留系统重构时，此方案极为高效。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. 根据提示修正脚本后再次提交审查，直至无严重告警。