用途:为架构迁移制定安全计划,从有证据的当前状态过渡到明确目标状态,并界定不可逆点与恢复动作。只改动获批的迁移文档,不执行迁移、不编辑产品代码、不生成通用任务计划、不审批交付、不隐藏不可逆步骤。
主要能力:建立迁移契约(范围、业务结果、当前/目标状态、非目标、期限、负责人、受保护用户旅程与SLO);构建差距与依赖图(模块、数据存储、模式、API、事件、配置、基础设施、内外部消费方与流量);设计兼容与数据安全(新旧契约兼容、版本协商、适配器、双读/双写、弃用策略、expand/migrate/contract、回填批处理与对账、真值源与并发写冲突);规划可逆阶段(准备、影子/共存、渐进迁移、切换、稳定、旧路径移除,每阶段含前置条件、入口门、成功观测、中止条件、回滚或前滚、退出证据);规划切换与移除(go/no-go权限、冻结条件、回滚边界、零使用证据、观察期与交接)。
使用方式:默认复用清晰的架构迁移文档,否则用 docs/architecture/migration-plan.md;运行保持只读,仅按授权对该文档做最小补丁;按检查清单逐项标记 PENDING、PROVEN、CLEARED 或 UNPROVEN 并附证据;无明确授权或路径不明时返回 BLOCKED。
适用场景:在线迁移、混合版本共存、有数据搬迁与外部效应的架构演进。
限制:不执行迁移;未提供定价、价格、平台支持信息;不要求特定工具链或完整生命周期;缺少当前/目标状态证据时应返回 BLOCKED 而非编造。