database-migrations

数据库迁移是生产环境架构演进的高危操作，本 Skill 提供了一套完整的零停机数据库迁移策略体系，帮助技术团队在不中断服务的前提下安全地演进数据库架构。

核心用法

本 Skill 作为数据库架构变更的决策指南，主要用于规划阶段的风险评估和方案选择。它系统性地整理了从简单到复杂的多种迁移策略：从风险最低的"仅增量化"（Additive-Only）模式，到处理复杂重构的"扩展-收缩"（Expand-Contract）模式，再到应对海量数据的"惰性迁移"策略。文档详细对比了 Prisma、Alembic、Flyway 等主流迁移工具的特性，并提供了可落地的回滚方案，包括双写期管理、蓝绿部署实施步骤，以及数据备份的具体 SQL 实践。无论是添加索引、重命名列，还是拆分表结构，都能找到对应的零停机实现路径。

显著优点

内容的专业性和实用性是最大亮点。文档不仅提供了策略矩阵帮助快速决策，还包含了完整的"迁移检查清单"（Pre/During/Post-Migration），确保关键环节不被遗漏。特别 valuable 的是明确列出了 8 条"绝对禁止"的反模式，如"切勿在未移除应用引用前直接删除列"、"切勿在单条语句中对大表添加非空约束"等，这些都是生产事故的高发区。此外，提供的批处理 SQL 示例采用了 SKIP LOCKED 和节流机制，体现了对高并发场景的深刻理解。

潜在缺点与局限性

作为纯文档型 Skill，它不提供自动化执行能力，所有策略都需要工程师手动实施或通过其他工具（如 Flyway、Liquibase）落地。来源为个人开发者（T3），虽然内容质量高，但缺乏官方组织背书。此外，文档主要基于 PostgreSQL 生态（从 SQL 示例中的 pg_sleep、NOT VALID 等语法可见），对于 MySQL、MongoDB 等其他数据库的针对性指导相对有限。部分高级策略（如蓝绿部署）需要额外的基建支持，对中小团队而言实施成本较高。

适合的目标群体

主要面向后端开发工程师、数据库管理员（DBA）、DevOps 工程师和系统架构师。特别适合负责高可用在线服务的技术团队，以及需要建立数据库变更规范的中大型组织。对于正在经历微服务拆分、数据模型重构或遗留系统现代化的团队尤为实用。

使用风险

尽管文档本身安全，但误用其中的技术方案可能带来风险：直接复制示例 SQL 到生产环境而未根据实际数据量调整批次大小，可能导致锁表；忽略"双写期"的必要性直接切换读流量，可能引发数据不一致；低估迁移执行时间而在高峰期部署，可能影响系统性能。建议严格遵循文档中的测试流程：必须在生产规模的数据集上验证迁移脚本，并确保 WAL 归档和备份策略到位。

核心用法

该 Skill 是一套完整的数据库迁移安全知识库，主要解决生产环境中 schema 变更的可靠性与可用性问题。核心用法包括：

1. 策略选型：根据风险承受能力选择迁移模式——Additive-Only（低风险）、Expand-Contract（中等风险）、Big Bang（仅用于开发环境）。

2. 零停机操作：针对常见 DDL 操作（添加/删除列、修改类型、建索引等）提供具体执行模式，如 CREATE INDEX CONCURRENTLY、两阶段约束变更、延迟删除等。

3. 工具匹配：覆盖主流技术栈的迁移工具选型建议——Prisma/Drizzle 适合 TypeScript 生态、Flyway/golang-migrate 适合云原生部署、Atlas 适合 Schema-as-Code 场景。

4. 数据迁移与回滚：详细说明 Backfill 策略（批量处理、后台任务、延迟填充）、双写模式执行步骤，以及可逆迁移与向前修正的选择标准。

显著优点

• 系统性完整：从预迁移检查、执行监控到事后清理形成闭环，配套详尽的 Checklist 可直接纳入团队 Runbook。
• 实战导向：提供可直接使用的 SQL 批处理模板、CI 流水线配置、蓝绿数据库切换流程，降低落地成本。
• 风险分级明确：通过表格对比不同策略的风险等级与适用场景，帮助决策者快速匹配方案。
• 工具生态覆盖广：兼顾 ORM 原生方案（Prisma、Django）与独立迁移工具（Flyway、Atlas），适应异构技术栈。

潜在缺点与局限性

• 数据库类型侧重：示例以 PostgreSQL 为主（如 pg_sleep、FOR UPDATE SKIP LOCKED），MySQL 或 SQL Server 用户需自行调整语法细节。
• 复杂场景简化：对于分片数据库、多主复制、跨云迁移等高级场景覆盖有限。
• 性能基线依赖：建议“在生产规模数据上测试”，但未提供具体容量规划公式或硬件配置参考。

适合人群

• SRE / 平台工程师：负责设计 CI/CD 中的数据库变更流水线。
• 后端技术负责人：评估迁移风险、制定团队规范。
• 资深开发者：执行高风险 schema 变更前查阅安全模式。

常规风险

• 误用 SQL 模板：直接复制示例代码而未调整 batch size 或 sleep 间隔，可能导致锁竞争或复制延迟。
• 跳过验证环节：未执行 up → down → up 的 CI 测试，可能遗漏不可逆变更。
• 工具版本差异：Atlas、Prisma 等工具迭代快，部分语法可能与 Skill 描述版本不完全一致。

使用建议

建议将该 Skill 作为迁移方案评审的参考标准而非执行脚本，结合实际数据库版本、数据量、复制拓扑进行定制后再实施。