migration-architect

迁移架构师

为数据库、服务、基础设施和 API 迁移生成分阶段迁移计划，其中包含风险评估、兼容性分析和回滚操作手册。验证架构兼容性、检测破坏性变更，并生成包含触发条件和沟通模板的回滚流程。

核心能力

• 分阶段规划 — 根据 JSON 规范生成经过风险评估、包含验证关卡、时间线和利益相关方结构的多阶段迁移计划。
• 兼容性分析 — 对比迁移前后的数据库或 REST/JSON 架构，检测破坏性变更、类型不匹配和约束违规，并生成迁移和回滚脚本。
• 回滚操作手册 — 包含逐阶段回退步骤、自动触发条件、数据恢复计划、升级处理矩阵和沟通模板。
• 模式目录 — Expand-Contract、Dual-Write、CDC、Strangler Fig、Parallel Run、Canary、Blue-Green。
• 风险框架 — 技术、业务、运营和合规风险类别。

适用场景

• 在不同平台或版本之间迁移数据库、API、基础设施或服务。
• 在切换前验证架构/API 兼容性并检测破坏性变更。
• 制定回滚操作手册和零停机执行计划。

首先澄清

规划迁移前，请确认以下输入。如果有任何信息未知或含糊不清，请先询问，不要自行假设：

• 迁移对象 — 数据库、API、基础设施或服务（用于设置 --type 并确定适用的模式目录）
• 交付内容 — 分阶段计划、兼容性差异或回滚操作手册（决定使用 migration_planner.py、compatibility_checker.py 还是 rollback_generator.py）
• 停机预算和模式 — 是否要求零停机，以及采用哪种模式（expand-contract、dual-write、strangler fig、blue-green）（决定阶段划分和切换技术）

停止规则：只询问最可能影响输出的 2-3 项。如果用户说“直接起草”，就继续执行，并在交付内容开头列出你的假设。

工具

工具	用途	命令
migration_planner.py	生成经过风险评估的分阶段迁移计划	python scripts/migration_planner.py --input spec.json --output plan.json --format both
compatibility_checker.py	对比架构/API 并标记破坏性变更	python scripts/compatibility_checker.py --before v1.json --after v2.json --type database
rollback_generator.py	根据计划生成回滚操作手册	python scripts/rollback_generator.py --input plan.json --output runbook.json --format both

参考资料

按任务加载相应参考资料 — 保持此文件精简，按需查阅详细内容：

• references/workflows-patterns-and-quality.md — 快速入门命令、包含验证检查点的三个核心工作流、迁移模式目录表、反模式、故障排查和成功标准。规划迁移时阅读。
• references/tool-reference.md — 三个脚本的详细用途、用法、标志表、输入格式和输出结构。运行或调试脚本前阅读。
• references/migration_patterns_catalog.md — 深入介绍迁移模式的目录，包含运作机制和权衡。选择模式时阅读。
• references/zero_downtime_techniques.md — 实现无停机切换的技术（expand-contract、dual-write、流量切换）。停机预算接近零时阅读。
• references/data_reconciliation_strategies.md — 用于确认迁移后数据完整性的校验和/业务逻辑验证策略。验证迁移数据时阅读。

范围与限制

此技能涵盖：

• 为数据库、服务、基础设施和 API 制定端到端迁移计划，包含分阶段执行和验证关卡。
• 自动分析不同架构版本（SQL 和 REST/JSON）之间的兼容性，包括检测破坏性变更和生成迁移脚本。
• 生成回滚操作手册，包括触发条件、数据恢复计划、升级矩阵和沟通模板。
• 涵盖技术、业务、运营和合规风险类别的风险评估框架。

此技能不涵盖：

• 针对线上系统实际执行迁移——这些工具会生成计划、报告和脚本，但不会连接数据库或云 API。
• 为支持新架构或 API 而进行的应用层代码重构；有关 API 合约变更，请参阅 engineering/api-design-reviewer；有关架构设计，请参阅 engineering/database-designer。
• 迁移执行期间的实时监控、告警或仪表板配置；有关可观测性设置，请参阅 engineering/observability-designer。
• 目标基础设施的云成本优化或容量规划；有关部署流水线配置，请参阅 engineering/ci-cd-pipeline-builder。

集成点

技能	集成方式	数据流
engineering/database-designer	在迁移规划前设计目标架构	目标架构 JSON 输入 compatibility_checker.py --after
engineering/api-design-reviewer	验证服务迁移中的 API 合约变更	OpenAPI 规范差异输入 compatibility_checker.py --type api
engineering/observability-designer	设置迁移操作手册中引用的监控仪表板	迁移计划的成功指标为告警规则定义提供依据
engineering/ci-cd-pipeline-builder	将迁移验证纳入 CI/CD 阶段	compatibility_checker.py 作为流水线阶段运行；migration_planner.py --validate 用于部署关卡
engineering/runbook-generator	通过操作流程扩展回滚操作手册	rollback_generator.py 的输出作为详细操作手册的输入
engineering/release-manager	协调迁移切换与发布计划	迁移计划的阶段和时间线与发布窗口及功能标志推出阶段保持一致