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

Codex 應用案例

重構程式碼庫

移除無作用的程式碼,更新老舊寫法,同時維持既有行為。

難度 Advanced
任務時間跨度 1h

使用 Codex 將重構拆成易於審查的小步驟,逐步移除無作用的程式碼、理清大型檔案的結構、整合重複邏輯,並更新過時的寫法。

最適合的對象

  • 因無作用的程式碼、過大的模組、重複邏輯或過時的抽象設計而難以進行日常修改的程式碼庫。
  • 需要在現有框架與技術堆疊內逐步更新程式碼的團隊。

目錄

    ← 所有應用案例

    重構程式碼庫

    移除無作用的程式碼,更新老舊寫法,同時維持既有行為。

    使用 Codex 將重構拆成易於審查的小步驟,逐步移除無作用的程式碼、理清大型檔案的結構、整合重複邏輯,並更新過時的寫法。

    Advanced
    1h

    使用 Codex 將重構拆成易於審查的小步驟,逐步移除無作用的程式碼、理清大型檔案的結構、整合重複邏輯,並更新過時的寫法。

    Advanced
    1h

    最適合的對象

    • 因無作用的程式碼、過大的模組、重複邏輯或過時的抽象設計而難以進行日常修改的程式碼庫。
    • 需要在現有框架與技術堆疊內逐步更新程式碼的團隊。

    技能與外掛程式

    • 每次合併程式碼現代化變更前,先審查可能影響安全性的清理作業、相依套件的變更、身分驗證與授權流程,以及對外開放的介面。
    • 將經過驗證的現代化做法、審查清單或行為一致性驗證流程,整理成可在程式碼庫或團隊中重複使用的技能。
    技能 使用理由
    Security Best Practices 每次合併程式碼現代化變更前,先審查可能影響安全性的清理作業、相依套件的變更、身分驗證與授權流程,以及對外開放的介面。
    Skill Creator 將經過驗證的現代化做法、審查清單或行為一致性驗證流程,整理成可在程式碼庫或團隊中重複使用的技能。

    入門提示詞

    請重構這個程式碼庫,並更新其中的老舊寫法。 需求: - 除非我明確要求變更功能,否則請維持既有行為。 - 先找出拖慢修改進度的問題,包括無作用的程式碼、重複的執行路徑、過大的模組、過時的抽象設計及老舊寫法。 - 針對每個建議步驟,說明程式目前的行為、預計如何改善結構,以及如何驗證重構前後的行為一致。 - 將重構拆成易於審查的小步驟,例如刪除無作用的程式碼、簡化控制流程、抽出輔助函式,或依照程式碼庫目前的慣例改寫過時的程式碼。 - 除非重構確實需要變更公開 API,否則請保持公開 API 不變。 - 指出哪些框架遷移、相依套件升級、API 變更或架構調整應拆成獨立的遷移任務。 - 如果工作範圍較廣,請建議在實作前應撰寫哪些文件與規格,以及應設計哪些檢查來驗證重構前後的行為一致。 請依照上述需求提出重構計畫。
    請重構這個程式碼庫,並更新其中的老舊寫法。 需求: - 除非我明確要求變更功能,否則請維持既有行為。 - 先找出拖慢修改進度的問題,包括無作用的程式碼、重複的執行路徑、過大的模組、過時的抽象設計及老舊寫法。 - 針對每個建議步驟,說明程式目前的行為、預計如何改善結構,以及如何驗證重構前後的行為一致。 - 將重構拆成易於審查的小步驟,例如刪除無作用的程式碼、簡化控制流程、抽出輔助函式,或依照程式碼庫目前的慣例改寫過時的程式碼。 - 除非重構確實需要變更公開 API,否則請保持公開 API 不變。 - 指出哪些框架遷移、相依套件升級、API 變更或架構調整應拆成獨立的遷移任務。 - 如果工作範圍較廣,請建議在實作前應撰寫哪些文件與規格,以及應設計哪些檢查來驗證重構前後的行為一致。 請依照上述需求提出重構計畫。

    簡介

    如果程式碼庫累積了未使用的程式碼、重複的邏輯、過時的抽象設計、過大的檔案或老舊的寫法,讓每次修改都得花費過多心力,就該考慮透過重構減少技術債。重構的重點在於改善現有系統的結構,無須更換整套技術堆疊。

    Codex 可以先釐清結構混亂的部分,再把清理工作拆成幾個小步驟,方便逐一審查。它可以刪除不再使用的程式碼路徑、理順大型模組的邏輯、合併重複的程式碼路徑、更新過時的框架用法,並加強每個步驟的驗證。

    目標是直接改善現有的程式碼庫:

    1. 移除未使用的程式碼、過時的輔助函式、舊旗標,以及不再需要的相容層。
    2. 精簡內容繁雜的模組,例如抽出輔助函式、拆分元件,或把會產生副作用的程式碼移到職責更明確的位置。
    3. 依照程式碼庫現行的慣例改寫老舊的程式碼,例如採用框架較新的基本構件、更清楚的型別、更簡單的狀態傳遞方式,或標準函式庫提供的工具。
    4. 維持對外行為穩定,同時降低後續修改的成本。

    使用方式

    1. 編輯前,先請 Codex 盤點要重構的範圍,找出內容繁雜的模組、重複的邏輯、未使用的程式碼、相關測試、對外介面契約,以及已不適合這個程式碼庫的舊寫法。
    2. 每次只選一項清理重點,例如移除未使用的程式碼、簡化控制流程、更新過時的寫法,或將大型檔案拆成較小且維護責任明確的單元。
    3. 在 Codex 修改檔案前,先請它說明目前的行為、打算如何改善結構,以及哪項最小範圍的檢查足以確認行為維持不變。
    4. 每完成一輪就審查變更,並執行足以驗證結果的最小範圍檢查,避免把整次清理的變更集中在同一份差異檔中。
    5. 除非清理工作必須涵蓋技術堆疊變更、相依套件遷移或架構調整,否則請將這些工作分別列為獨立任務。

    開始重構前,可以使用規劃模式擬定重構計畫。

    運用 ExecPlans

    程式碼現代化實作指南 介紹了 ExecPlans。Codex 可以透過這類文件掌握清理工作的全貌、說明預期的最終狀態,並在每輪清理後記錄驗證結果。 如果重構涉及多個模組,或需要分多個工作階段才能完成,ExecPlans 就很實用。可以用這類文件記錄刪除了哪些內容、更新了哪些寫法、哪些介面契約必須維持不變,以及哪些工作仍待日後處理。

    使用技能處理重複出現的清理工作

    當多個程式碼庫、服務或團隊反覆使用同一套清理規則時,就可以運用技能。如果有適用於特定框架的技能,請使用該技能。清理工作風險較高時,請搭配資安和 CI 技能。如果團隊已有經過驗證的檢查清單,用於移除未使用的程式碼、抽出模組或更新老舊寫法,請據此建立團隊技能。 如果需要在多個程式碼庫進行相同的現代化工作,Codex 可以協助你將第一次成功的做法整理成可重複使用的技能。

    相關應用案例