YuAICode go-migration-guard — GORM 迁移覆盖启发式检查
启发式提醒,不是保证。 脚本只看 diff 里的文本信号,无法执行 SQL 或理解运行时逻辑。Claude 应结合实际 migration 文件内容判断,不要凭本 skill 的结论臆断"已覆盖"或"一定缺失"。
何时触发
用户说:
- "检查一下迁移 / migration 覆盖了吗"
- "gorm 模型改了,有没有加迁移"
- "迁移链断了 / 数据库和模型不同步了"
- "AutoMigrate 会自动加字段吗"
- 代码 review 时看到
.go里有 gorm struct 改动,想确认迁移
用法
在目标 repo 根目录运行(与
git命令并列):bash <skill>/bin/check-migration.sh [base] # base 缺省:自动探测 main 或 master;也可传 HEAD~1、某 commit hash 等 # 例:bash <skill>/bin/check-migration.sh main脚本输出两类信息:
- 字段变更列表 — diff 里所有新增(
+)或删除(-)且含gorm:"的 struct 字段行。 - 迁移线索评估 — 若 diff 里完全没有迁移线索(没动 migration 目录、没有
AutoMigrate相关字样),给出更强提醒。
退出码:
0— 没有检测到 gorm 字段变更(放行)2— 检测到字段变更,需人工确认
- 字段变更列表 — diff 里所有新增(
Claude 拿到输出后,应:
- 列出脚本找到的字段变更。
- 告知"是否在 diff 里看到迁移线索"。
- 如有线索,请用户确认对应 migration 文件里是否真的涵盖了这些列。
- 如无线索且项目不依赖 AutoMigrate,提醒用户补写 migration 文件。
确定性脚本做什么 / 不做什么
| 做 | 不做 |
|---|---|
扫 diff 中带 gorm:" 的新增/删除行 |
解析 SQL、运行数据库 |
| 检测 migration 目录是否有变动 | 验证 migration 内容是否正确 |
| 检测 AutoMigrate 字样 | 判断 AutoMigrate 是否在生产启用 |
| 给出字段名+所在文件 | 做 schema diff |
边界
- 只读 git diff,不改任何文件。
- 不与
commit-guard-zh/bin/gorm-mysql-check.sh重复:那个脚本扫"TEXT/JSON 带 DEFAULT"这一特定非法写法;本 skill 聚焦"模型字段有没有迁移覆盖"的更宏观问题。 - 依赖
git;不依赖其他外部工具。 - 误报优于漏报:宁可提醒多余,也不想漏掉迁移缺失。