应启用CodeBuddy智能识别数据库模型与schema差异的能力。可通过CLI自动生成迁移脚本、Craft模式交互生成SQL、增强WorkBuddy注释、反向生成模型与脚本、或用Skills审查合规性五种路径实现高效安全的数据库迁移。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在数据库结构变更时避免手动编写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抽象层，或需直接产出纯SQL供DBA人工审核时，可通过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、将待审核的migration_abc123.py文件路径提供给CodeBuddy：/review migration_abc123.py with db-migration-reviewer。
3、接收结构化反馈，例如：⚠️ 中等：ALTER TABLE users DROP COLUMN phone未包含备份步骤，建议先ADD COLUMN phone_backup。
4、根据提示修改脚本，再次提交审查直至无严重告警。
