ecto-migration

用途：为任意 schema 变更（表、列、索引、约束）提供可执行的 Ecto 迁移流程，强调生产安全与可回滚性。主要能力包括硬性关卡（HARD-GATE）与生产影响锁的人工审批（HITL）。流程分四阶段：Phase 1 规划，评估锁风险、expand-contract 需求、回滚策略与索引并发，生产影响锁需 HITL 审批；Phase 2 实现，schema 变更与数据回填严禁放在同一迁移，外键需建索引，尽量使用可逆的 change/0 或单独 up/down；Phase 3 迁移循环，运行 mix ecto.migrate、mix ecto.rollback、mix ecto.migrate；Phase 4 验证，运行 mix test，列变更时更新 schema 与 typespecs，并要求 mix format --check-formatted 与 mix credo --strict 通过。硬性关卡包括：迁移前记录规划与回滚、schema 与数据回填分离、迁移-回滚-迁移循环成功、格式/Credo/全量测试绿灯、生产高风险锁有 HITL。限制与错误恢复：不可逆迁移应停止、编写补偿迁移，不得强行上生产。该手册会加载 ecto-essentials（迁移/schema）与 apply-ecto-conventions（Repo/查询约定）两个原子技能，并输出包含计划、迁移文件名、各关卡 PASS/FAIL、命令退出码与 APPROVE/REQUEST_CHANGES 结论的迁移报告。