技能介绍

要解决什么问题

团队用声明式 SQL 管理 schema，但仓库文件和线上结构会慢慢分叉：生产上有人直接执行了 DDL，有人改了表忘了回写，迁移脚本也可能只跑了一半。

这些差异会带来实际故障：发布时 SQL 语句报错，回滚时发现字段已不存在；AI agent 直接操作数据库时，读到的文档和线上结构不一致，可能在最不希望的地方触发变更。

技能如何工作

这个技能把 sqldef 作为漂移检查的执行层：

以声明式 SQL 为基准：CREATE TABLE 等语句既是 schema 定义，也是期望状态描述。
对比实时数据库：mysqldef、psqldef、sqlite3def、mssqldef 分别对应一种数据库，连接选项与原生客户端一致，可复用现有配置。
生成可审查的执行计划：输出「让线上结构变成期望状态所需的语句」，而不是直接修改数据库。
先评审后执行：计划进入正常 review 流程，确认后再由人工或 agent 执行。

四种数据库共用一套工作流，只有连接参数不同，因此可以用同一套检查脚本覆盖多个引擎。

适用边界

sqldef 围绕声明式 SQL 设计，要求仓库中的 SQL 与期望 schema 保持一致。它不做迁移版本管理，也不自动阻止破坏性变更：DROP TABLE 之类的语句会原样出现在计划里，需要评审者自己判断。生成计划需要读取目标库元数据的权限，建议在只读副本上运行检查。当前没有 Debian 包，环境要求需要提前确认。