ecto-migrator

Ecto Migrator 是一款专为 Elixir/Phoenix 生态设计的智能数据库迁移生成工具，旨在通过自然语言描述或 Schema 定义自动化生成符合生产标准的 Ecto 迁移代码。该技能深度整合了 PostgreSQL 最佳实践，覆盖从基础表结构创建到复杂多租户架构设计的完整数据库生命周期管理。

核心用法方面，用户可通过自然语言指令（如"Create users table with email"）直接生成对应的迁移文件，支持包括列类型定义、索引策略、外键约束、检查约束、枚举类型及表分区在内的全功能 Schema 变更。特别针对多租户场景提供标准化模式（强制 tenant_id 字段及复合索引），并严格区分 Schema 迁移与数据迁移，确保数据库变更的可维护性。

显著优点体现在其内置的行业最佳实践：强制使用 UUID 主键、统一时间戳格式、Money 类型安全处理（整数分存储）、并发索引创建（避免表锁）以及可逆迁移模式。通过 change/0 与 up/down/0 的明确区分，配合 modify 的 from: 参数支持，大幅降低了迁移回滚失败的风险。此外，对 PostgreSQL 扩展（如 citext、pgcrypto）和 GIN 索引的原生支持，使其在复杂查询场景下具备专业级优化能力。

潜在局限主要包括来源可信度限制（T3 级个人/社区项目），尽管内容质量高但缺乏官方组织背书；生态局限性，仅适用于 Elixir/Ecto 技术栈；以及作为文档型工具，无法直接执行迁移，需要开发者具备 Ecto 基础知识才能正确使用生成的代码。

适合人群主要为 Elixir/Phoenix 全栈开发者、需要快速迭代数据库架构的初创团队、以及寻求多租户 Schema 标准化方案的技术负责人。对于缺乏 PostgreSQL 深度优化经验的中级开发者，该技能提供了可落地的权威参考。

使用风险需关注：虽然技能本身为纯文档，但生成的 execute/1 宏包含原始 SQL 执行能力，若在生成过程中混入恶意输入可能导致意外的数据库操作；生产环境执行不可逆迁移（如列删除）前必须完成数据备份；并发索引创建虽避免锁表但可能消耗大量 I/O 资源，需在低峰期执行。

核心功能与定位

Ecto Migrator 是一款面向 Elixir/Ecto 开发者的数据库迁移辅助工具，核心能力是将自然语言描述转化为标准化的 Ecto 迁移代码。其定位清晰：零执行代码的纯文档型 Skill，专注于迁移模板生成、命名规范约束及最佳实践传播。

显著优势

1. 自然语言到代码的精准映射

• 建立了一套完整的语义-代码转换规则，覆盖 DDL 全生命周期：创建表、增删列、建索引、改约束、重命名等操作
• 对多租户场景有深度支持：强制 tenant_id 模式、复合索引策略、迁移分片指导

2. 工程实践的严格规范

• 强制 UUID 主键（:binary_id）、微秒级时间戳（:utc_datetime_usec）、禁用 :float 存储货币
• 明确区分 schema 迁移与数据迁移（"Never mix" 原则），并提供批量数据回填的安全模式
• 可逆性设计指导：change vs up/down 的决策树，modify ... from: 的降级语法

3. PostgreSQL 特性深度整合

• 原生支持 GIN 索引、部分索引、排他约束（btree_gist）、并发索引创建（concurrently: true）
• 扩展管理（citext、pgcrypto、pg_trgm）的标准化语法
• 分区表、原生枚举（慎用）等高级场景的代码模板

潜在局限与风险

1. 无验证的执行风险
作为纯文档型 Skill，生成的代码未经语法校验、未连接实际数据库，开发者可能直接复制有问题的迁移（如拼写错误、类型不匹配）导致运行时失败。

2. 版本兼容性盲区
文档未明确标注 Ecto/PostgreSQL 的版本要求（如 from: 选项需 Phoenix 1.7+），新手可能在旧版本踩坑。

3. 多数据库支持缺失
完全聚焦 PostgreSQL，对 MySQL/MSSQL/SQLite 等 Ecto 支持的数据库无任何指导。

4. 复杂数据迁移的边界
对于亿级表的数据迁移，仅提及 "Task 或 Oban job"，缺乏具体实现模板和限流、断点续传等生产级方案。

适合人群

• Elixir 全栈开发者：需要快速生成符合团队规范的迁移代码
• DBA 与架构师：评审迁移脚本、建立团队 Checklist 基准
• 技术负责人：引入多租户架构时的标准化参考

常规风险提示

• 并发索引陷阱：文档提醒需用 @disable_ddl_transaction true，但新手易遗漏导致生产锁表
• 不可逆操作误用：remove 列在 change 中虽可逆，但数据已丢失；execute 裸 SQL 无自动回滚
• 外键级联策略：:delete_all 的误用可能导致级联数据灾难，需结合业务仔细选择 on_delete 策略