还在手写Django迁移？Cursor配合generate-migration简直是降维打击！😭-Skill优仓

在Sentry这样的大型Django项目中进行数据库变更，往往是让开发者头皮发麻的时刻。手动编写迁移文件不仅效率低下，稍有不慎还可能导致生产环境锁表甚至数据丢失。generate-migration 这个Agent Skill正是为此而生，它不仅仅是一个简单的命令封装，更是一套深谙数据库安全变更之道的智能专家系统。

核心功能

这就好比给你的IDE装上了一个资深的DBA大脑。它主要解决以下几个核心痛点：

智能生成迁移文件：能够根据模型变更自动生成标准的Django迁移文件，支持针对特定App或生成空迁移用于数据清洗。
安全删除机制：引入了独特的两步删除法（Safe Delete），防止因直接删除字段或表而导致的代码崩溃。
生产环境友好：针对大表索引添加提供了超时处理建议，以及强制使用数据库级默认值（db_default）而非应用级默认值。
冲突自动修复：当多人协作导致迁移文件冲突时，提供了一键修复依赖和锁文件的方案。

适用平台

无论你习惯使用哪种AI编程助手，这款Skill都能成为你的最强外挂。它完美适配 Cursor, GitHub Copilot, Claude Code, OpenAI Codex, Gemini Code Assist, 文心快码, 腾讯云 CodeBuddy, 华为云 CodeArts 等主流工具。在这些IDE中加载该Skill，AI就能准确理解Sentry特定的数据库变更规范，不再生成那些可能搞挂生产库的通用Django代码，显著提升AI对项目上下文的理解能力。

实操代码示例

不用再翻文档查命令了，看看它是如何简化操作的：

1. 自动生成迁移文件

# 自动检测所有变更
sentry django makemigrations

# 仅针对特定App（如projects）
sentry django makemigrations projects

2. 生成数据迁移模板

# 生成一个空的迁移文件，适合写自定义SQL或数据清洗逻辑
sentry django makemigrations projects --empty

3. 解决合并冲突

# 当migrations_lockfile.txt报错时
bin/update-migration 0123_migration_name

优势分析

相比于原生Django的 makemigrations，这个Skill不仅是自动化，更是规范化。普通的Django迁移很容易忽略大表加索引会导致数据库超时的问题，而此Skill明确指引在添加索引时设置 is_post_deployment = True，避免阻塞部署流程。此外，它对字段重命名的处理也非常老道——建议使用 db_column 保持数据库层面名称不变，仅修改代码层面的变量名，从而避免了Postgres重命名操作可能带来的风险。

应用场景

想象一下这些让人抓狂的场景，现在都能轻松搞定：

重构老旧模块：需要废弃一张存有千万级数据的表。直接删除会报错？Skill引导你先使用 SafeDeleteModel 将其标记为 MOVE_TO_PENDING，部署后再执行真正的删除，确保服务零中断。
添加非空字段：需要给核心表加一个非空字段。Skill会提醒你必须设置 db_default，避免锁表时间过长。
团队协作冲突：早上一拉代码，发现迁移文件锁冲突了。直接运行提供的冲突解决脚本，自动重命名并修复依赖关系，无需手动修改文件名。

最佳实践

为了让数据库变更更加稳健，在使用此Skill时，建议遵循以下工程化规范：

字段删除两步走：永远不要一次性删除字段。第一步先将字段设为 null=True 并移除代码引用，使用 SafeRemoveField 标记为Pending；部署验证无误后，再创建第二个迁移进行物理删除。
慎用默认值：对于新列，尽量使用 db_default=<value> 而不是Django层面的 default=<value>，这样数据库能更高效地处理默认填充。
事后验证：生成迁移后，务必运行 sentry django sqlmigrate <app_name> <migration_name> 检查生成的原生SQL语句，确保没有意外的锁表操作。

掌握了这些数据库变更的高级技巧，你的开发效率将提升一个量级。为了在项目中更方便地获取和管理这类专业的开发辅助工具，建议前往 Skill优仓获取更多类似的优质资源，让你的Agent变得更懂业务，更懂工程。