---
name: migration-pipeline
type: pipeline_procedure
when: '技术迁移, 框架升级, 技术栈迁移, 版本升级, 迁移, migration, 系统迁移, 组件替换'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-迁移流水线
asset_kind: pipeline_procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-knowledge-asset-governance
routes:
  - code_change
primary_triggers:
  - 迁移流水线
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-knowledge-asset-governance
emits:
  - migration_assessment
  - migration_plan
  - migration_result
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["编码与单元测试", "联调验证"]
---

# 技术迁移管线

### 第1步：迁移评估
评估迁移范围和影响（模块数、代码量、依赖链）。评估迁移路径（渐进式/一次性）。评估兼容性风险（API 变更、行为差异、性能差异）。制定回滚方案。
模版：迁移评估模版.md
产出保存到：.soloforge/output/01-迁移评估.md
工具：sf_classify, sf_analyze

### 第2步：方案设计
制定分阶段迁移计划（每阶段可独立验证和回滚）。识别兼容层需求（适配器/Shim/Feature Flag）。定义每个阶段的完成标准和验证方式。
产出保存到：.soloforge/output/02-迁移方案.md

### 第3步：渐进迁移
按计划逐步迁移，每阶段完成后全量测试。保持双写/双读过渡期（如需要）。记录每阶段发现的行为差异和兼容性问题。
工具：sf_expand, sf_verify

### 第4步：清理验证
移除兼容层和废弃代码。全量功能验证。性能对比确认无退化。更新文档和依赖配置。
工具：sf_verify, sf_review, sf_deliver, sf_learn
