opencode-workflow/skills/migration-rollout-design

遷移與上線設計 (Migration Rollout Design) 知識合約指南

概述

migration-rollout-design 是知識合約，用來提供遷移與上線設計的原則與模式。涵蓋向後相容、上線策略、Canary Deployment、Feature Flags、Schema Evolution 與 Rollback。供 design-architecture 在定義 Migration & Rollout Strategy 時參考。

核心原則

向後相容優先

• 新版本必須與舊版本共存於遷移期間
• API 必須向後相容直到所有消費者都遷移完成
• 資料庫結構必須同時支援舊版和新版程式碼

增量勝過 Big-Bang

• 增量遷移，一步一步來
• 每步必須可獨立部署與逆轉
• Big-Bang 遷移風險高，逆轉困難

預設 Rollback

• 每個遷移步驟必須有明確的 rollback 計畫
• Feature Flags 可實現即時 rollback，無需重新部署

設計重點

• 上線策略：Blue-Green Deployment、Canary Deployment、Rolling Deployment、Feature Flag Deployment
• Feature Flags：Release flags、Operational flags、Experiment flags、Permission flags
• Schema Evolution：Additive Changes（安全）vs Destructive Changes（需遷移）
• Migration Strategy：Expand → Migrate → Contract 三階段
• Rollback：Application Rollback、Database Rollback 與決策矩陣

知識合約職責

• 提供遷移與上線設計的理論指引
• 不直接產生遷移腳本或上線腳本

不應做的事

• 不替系統選擇特定部署策略
• 不定義具體的 Feature Flag 名稱或值
• 不產生遷移或部署腳本