用途:当数据形状变化可能破坏读取、写入、报表、租户或集成时使用本技能,目标是产出明确的兼容与迁移计划,而不仅是 SQL 差异。
主要能力:覆盖数据契约设计、模式变更、迁移、回滚、回填、兼容窗口、租户隔离,以及 API 到数据库的字段映射。
使用方式:先做预检,收集当前模式、模型、序列化器、API 契约与持久化样本;确认每个字段的写入者与读取者;了解迁移工具与回滚支持;评估数据量、租户边界与回填成本;明确零停机或维护窗口约束;找出证明兼容性的现有测试或夹具。若当前数据不含某字段,应视为不存在,不得虚构回退字段。
迁移设计:生产系统采用 expand-migrate-contract:扩展阶段添加可空列、新表、新枚举值或版本化载荷,不破坏旧读取者;必要时双写或适配器同时写旧新两种形式;回填阶段分批迁移历史数据,带检查点与重试;验证后将读取切换到新契约;兼容窗口与回滚风险通过后再移除旧字段。小型系统仅在停机、回滚与数据丢失风险明确很低时可直接迁移。
必需检查:每个计划须包含前向迁移命令、回滚或前滚恢复命令、回填幂等性与续跑行为、迁移前后数据校验查询、存在租户时的租户隔离检查、API/序列化器兼容性测试,以及迁移进度与失败的可观测性。
输出结构:contract_change、affected_readers_writers、migration_strategy、backfill_plan、rollback_or_recovery、tenant_and_security_checks、verification_queries、test_commands、release_gate。关键数据缺失时应报错,而非警告后回退到不完整输出。
限制:资料未提供具体安装命令、平台支持、收费方式或效果数据。