Codex 應用案例
執行程式碼遷移
分階段遷移舊技術堆疊,在每個檢查點驗證結果。
使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。
最適合的對象
- 將舊技術堆疊遷移至現代技術堆疊時,需要更換框架、執行環境或建置系統,或調整做法以符合新平台慣例的專案。
- 需要相容層、分階段切換,並在每個遷移檢查點明確驗證結果的團隊。
目錄
執行程式碼遷移
分階段遷移舊技術堆疊,在每個檢查點驗證結果。
使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。
使用 Codex 釐清舊系統與新技術堆疊的對應關係,分階段完成遷移,並在每次切換前確認新舊系統的行為一致。
最適合的對象
- 將舊技術堆疊遷移至現代技術堆疊時,需要更換框架、執行環境或建置系統,或調整做法以符合新平台慣例的專案。
- 需要相容層、分階段切換,並在每個遷移檢查點明確驗證結果的團隊。
技能與外掛程式
- 合併前,檢查高風險的遷移項目、相依套件的變更,以及系統對外開放的部分。
- 每完成一個遷移階段,就修正導致 CI 失敗的問題,避免留到最後才處理。
- 如果遷移涉及 ASP.NET Core 的應用程式模型、`Program.cs`、中介軟體、測試、效能或版本升級,請參考該框架的專屬指南。
| 技能 | 使用理由 |
|---|---|
| Security Best Practices | 合併前,檢查高風險的遷移項目、相依套件的變更,以及系統對外開放的部分。 |
| Gh Fix Ci | 每完成一個遷移階段,就修正導致 CI 失敗的問題,避免留到最後才處理。 |
| Aspnet Core | 如果遷移涉及 ASP.NET Core 的應用程式模型、`Program.cs`、中介軟體、測試、效能或版本升級,請參考該框架的專屬指南。 |
入門提示詞
簡介
從一套技術堆疊遷移到另一套時,可以用 Codex 釐清遷移範圍,分階段執行。遷移範圍可能涵蓋路由、資料模型、組態、驗證與授權、背景作業、建置工具、部署、測試,甚至包括程式語言與框架本身的慣例。
Codex 可以盤點舊系統,找出新舊概念的對應關係,再分階段完成變更,每個階段都能檢查結果,無須一次重寫整個系統。當你要汰換舊框架、將程式移植到新的執行環境,或逐步用新的技術堆疊取代舊堆疊,而產品又必須持續運作時,這種做法尤其重要。
使用方式
- 先盤點遷移涉及的項目,包括舊系統的套件、框架慣例、路由、資料存取、驗證與授權、組態、建置工具、測試、部署所依賴的假設,以及遷移後仍須遵守的所有對外契約。
- 請 Codex 找出舊系統的概念在目標技術堆疊中的對應項目,並指出哪些概念沒有直接對應的項目。
- 選擇漸進式遷移策略,例如加入相容層、逐一移植模組、透過抽象層建立分支,或採用絞殺者模式,每次沿著一個系統邊界替換舊實作。
- 維持既有行為,只有在遷移本身必然造成可觀察的變化時才改變行為,並明確列出這些例外。
- 每完成一個里程碑,就執行足以確認新舊行為一致的最小範圍驗證,例如靜態程式碼分析、型別檢查、針對特定功能的測試、契約測試、冒煙測試,或並行比對新舊執行路徑的結果。
- 每到一個檢查點,就檢視程式碼差異並評估剩餘的遷移風險,無須等到整個系統重寫完畢。
善用 ExecPlans
我們在程式碼現代化實作指南中介紹了 ExecPlans。這類文件讓 Codex 能掌握整體程式碼整理進度、說明預期的最終狀態,並在每一輪整理後記錄驗證結果。 請 Codex 執行複雜的遷移時,也請它為系統的每個部分各建立一份 ExecPlan,記錄每項決策與技術堆疊的選擇,方便日後檢視。
搭配目標使用
如果某個遷移階段需要較長時間,可以設定目標來引導 Codex 完成工作。設定目標時,請明確說明預期的最終狀態、如何確認新舊行為一致、需要回復舊版時應如何處理,以及何時停止。
相關應用案例
建立 Codex 可使用的 CLI
請 Codex 建立一套 CLI,讓它能在任何資料夾中執行 CLI 指令、搭配程式碼庫中的指令碼使用,也能下載檔案。再請它建立配套技能,讓 Codex 日後記得如何使用這套 CLI。
從議題到經過測試的 pull request
將範圍明確的議題交給 Codex,準備好雲端環境,並列出必要的檢查項目。Codex 會交付可供審查的程式碼變更,附上測試、文件,以及每項驗收條件的驗證依據。
朝目標持續推進
如果任務需要 Codex 在多輪對話中持續工作,直到符合可驗證的結束條件,就使用 `/goal`。