如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

執行程式碼遷移

分階段遷移舊技術堆疊,在每個檢查點驗證結果。

難度 Advanced
任務時間跨度 1h

使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。

最適合的對象

  • 將舊技術堆疊遷移至現代技術堆疊時,需要更換框架、執行環境或建置系統,或調整做法以符合新平台慣例的專案。
  • 需要相容層、分階段切換,並在每個遷移檢查點明確驗證結果的團隊。

目錄

    ← 所有應用案例

    執行程式碼遷移

    分階段遷移舊技術堆疊,在每個檢查點驗證結果。

    使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。

    Advanced
    1h

    使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。

    Advanced
    1h

    最適合的對象

    • 將舊技術堆疊遷移至現代技術堆疊時,需要更換框架、執行環境或建置系統,或調整做法以符合新平台慣例的專案。
    • 需要相容層、分階段切換,並在每個遷移檢查點明確驗證結果的團隊。

    技能與外掛程式

    • 合併前,檢查高風險的遷移項目、相依套件的變更,以及系統對外開放的部分。
    • 每完成一個遷移階段,就修正導致 CI 失敗的問題,避免留到最後才處理。
    • 如果遷移涉及 ASP.NET Core 的應用程式模型、`Program.cs`、中介軟體、測試、效能或版本升級,請參考該框架的專屬指南。
    技能 使用理由
    Security Best Practices 合併前,檢查高風險的遷移項目、相依套件的變更,以及系統對外開放的部分。
    Gh Fix Ci 每完成一個遷移階段,就修正導致 CI 失敗的問題,避免留到最後才處理。
    Aspnet Core 如果遷移涉及 ASP.NET Core 的應用程式模型、`Program.cs`、中介軟體、測試、效能或版本升級,請參考該框架的專屬指南。

    入門提示詞

    將這套程式碼從 [legacy stack or system] 遷移至 [target stack or system]。 遷移要求: - 先盤點舊系統在路由、資料模型、身分驗證與授權、設定、建置工具、測試、部署及對外介面契約等方面的既有假設。 - 列出舊技術堆疊各項目在新堆疊中的對應項目,並標明哪些項目沒有直接對應的替代方案。 - 提出漸進式遷移計畫,採用相容層或設置檢查點,避免一次重寫整套系統。 - 維持既有行為,除非遷移明確要求變更使用者可觀察到的行為。 - 分階段遷移。每完成一個階段,就執行 lint 檢查、型別檢查,以及針對該階段變更的測試。 - 在切換完成前,持續列明可用的回復方式或備援方案。 - 如果驗證失敗,請先修正問題再繼續。 - 請先列出遷移會影響哪些部分,並提出各階段的檢查點規劃。
    AstraMedium
    將這套程式碼從 [legacy stack or system] 遷移至 [target stack or system]。 遷移要求: - 先盤點舊系統在路由、資料模型、身分驗證與授權、設定、建置工具、測試、部署及對外介面契約等方面的既有假設。 - 列出舊技術堆疊各項目在新堆疊中的對應項目,並標明哪些項目沒有直接對應的替代方案。 - 提出漸進式遷移計畫,採用相容層或設置檢查點,避免一次重寫整套系統。 - 維持既有行為,除非遷移明確要求變更使用者可觀察到的行為。 - 分階段遷移。每完成一個階段,就執行 lint 檢查、型別檢查,以及針對該階段變更的測試。 - 在切換完成前,持續列明可用的回復方式或備援方案。 - 如果驗證失敗,請先修正問題再繼續。 - 請先列出遷移會影響哪些部分,並提出各階段的檢查點規劃。
    AstraMedium

    簡介

    從一套技術堆疊遷移到另一套時,可以用 Codex 釐清遷移範圍,分階段執行。遷移範圍可能涵蓋路由、資料模型、組態、驗證與授權、背景作業、建置工具、部署、測試,甚至包括程式語言與框架本身的慣例。

    Codex 可以盤點舊系統,找出新舊概念的對應關係,再分階段完成變更,每個階段都能檢查結果,無須一次重寫整個系統。當你要汰換舊框架、將程式移植到新的執行環境,或逐步用新的技術堆疊取代舊堆疊,而產品又必須持續運作時,這種做法尤其重要。

    使用方式

    1. 先盤點遷移涉及的項目,包括舊系統的套件、框架慣例、路由、資料存取、驗證與授權、組態、建置工具、測試、部署所依賴的假設,以及遷移後仍須遵守的所有對外契約。
    2. 請 Codex 找出舊系統的概念在目標技術堆疊中的對應項目,並指出哪些概念沒有直接對應的項目。
    3. 選擇漸進式遷移策略,例如加入相容層、逐一移植模組、透過抽象層建立分支,或採用絞殺者模式,每次沿著一個系統邊界替換舊實作。
    4. 維持既有行為,只有在遷移本身必然造成可觀察的變化時才改變行為,並明確列出這些例外。
    5. 每完成一個里程碑,就執行足以確認新舊行為一致的最小範圍驗證,例如靜態程式碼分析、型別檢查、針對特定功能的測試、契約測試、冒煙測試,或並行比對新舊執行路徑的結果。
    6. 每到一個檢查點,就檢視程式碼差異並評估剩餘的遷移風險,無須等到整個系統重寫完畢。

    善用 ExecPlans

    我們在程式碼現代化實作指南中介紹了 ExecPlans。這類文件讓 Codex 能掌握整體程式碼整理進度、說明預期的最終狀態,並在每一輪整理後記錄驗證結果。 請 Codex 執行複雜的遷移時,也請它為系統的每個部分各建立一份 ExecPlan,記錄每項決策與技術堆疊的選擇,方便日後檢視。

    搭配目標使用

    如果某個遷移階段需要較長時間,可以設定目標來引導 Codex 完成工作。設定目標時,請明確說明預期的最終狀態、如何確認新舊行為一致、需要回復舊版時應如何處理,以及何時停止。

    相關應用案例