技能介绍

迁移审查的盲区

大多数数据库事故不是写错了一行 SQL，而是一条看似无害的 ALTER TABLE 在生产环境静默生效。给 varchar 字段改长度可能触发 ACCESS EXCLUSIVE 锁，整个表的读写被瞬间冻结；在错误的时机建索引会拖垮高峰期负载；列类型变更、外键删除这类操作一旦执行，回滚成本极高。代码评审只关心逻辑对不对，没人会逐行核对每条 DDL 在锁行为上的代价。

Squawk 如何工作

这个技能把 Squawk 接入你的迁移流程，对 PostgreSQL 迁移文件和 SQL 变更做静态 Lint：

规则驱动分析：内置一组针对 DDL 的规则，覆盖锁竞争、索引策略、字段变更等高危模式，对每条迁移 SQL 给出 warning 或错误标记；
逐条迁移扫描：直接读取项目中的 SQL 文件，逐条识别风险操作并输出可操作的诊断信息，例如指出某次 varchar 长度变更会阻塞全表读写；
灵活集成：可以走 CLI、Docker 镜像，也能接入 CI 或 pre-commit 钩子，让检查发生在代码合入之前。

适用边界

Squawk 是静态规则检查器，不是执行计划分析工具：它无法感知你的表实际数据量、负载曲线和锁等待情况，误报和漏报都可能存在，高危操作仍需人工判断。规则集是通用的，业务特定的约束需要自己补充或忽略。它只覆盖 PostgreSQL 方言，其他数据库的迁移文件不在范围内。把它当作迁移评审的第一道筛子，而不是替代品。