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

Codex 應用案例

朝目標持續推進

為 Codex 設定目標,讓它在執行長時間任務時始終有明確方向。

難度 Advanced
任務時間跨度 Long-running

如果任務需要 Codex 在多輪對話中持續工作,直到符合可驗證的結束條件,就使用 /goal。

最適合的對象

  • 耗時較長、有明確成功條件,且能反覆驗證結果的程式開發工作。
  • 可讓 Codex 在既定範圍內持續推進的工作,例如遷移程式碼、進行大規模重構、反覆嘗試部署、進行實驗、開發遊戲或投入業餘專案。
  • 需要依據明確的成功標準進行長時間實驗的團隊。

目錄

    ← 所有應用案例

    朝目標持續推進

    為 Codex 設定目標,讓它在執行長時間任務時始終有明確方向。

    如果任務需要 Codex 在多輪對話中持續工作,直到符合可驗證的結束條件,就使用 /goal。

    Advanced
    Long-running

    如果任務需要 Codex 在多輪對話中持續工作,直到符合可驗證的結束條件,就使用 /goal。

    Advanced
    Long-running

    最適合的對象

    • 耗時較長、有明確成功條件,且能反覆驗證結果的程式開發工作。
    • 可讓 Codex 在既定範圍內持續推進的工作,例如遷移程式碼、進行大規模重構、反覆嘗試部署、進行實驗、開發遊戲或投入業餘專案。
    • 需要依據明確的成功標準進行長時間實驗的團隊。

    入門提示詞

    /goal 完成 [objective],達到 [verifiable end state] 後才停止。
    /goal 完成 [objective],達到 [verifiable end state] 後才停止。

    簡介

    如果你希望 Codex 在一輪對話結束後,仍能朝同一個目標持續工作,可以使用 /goal。這適合目標明確、能反覆驗證成果,而且有足夠空間讓 Codex 自行推進的工作,你不必每一步都給指示。使用 /goal 時,Codex 可以獨立工作數小時,無需你介入。

    使用 /goal <objective> 設定目標,使用 /goal 查看目前的目標。需要控制執行狀態時,可以使用 /goal pause、/goal resume 或 /goal clear。

    如果斜線指令清單中沒有 /goal,請啟用 features.goals。在 config.toml 中設定如下:

    [features]
    goals = true

    你也可以在 CLI 中執行 codex features enable goals,或請 Codex 代為執行。

    選擇合適的工作

    合適的目標通常超出一則提示詞就能完成的工作範圍,但仍有明確界線,不宜涵蓋一份沒有盡頭的待辦清單。設定目標時,應說明 Codex 要達成什麼、哪些部分應維持原樣、如何驗證進度,以及何時停止。

    下列工作適合設定目標:

    • 遷移程式碼,且已明確指定目標技術堆疊、如何檢查遷移前後的行為是否一致,以及有哪些限制
    • 大規模重構,且 Codex 可以在每個檢查點完成後執行測試
    • 進行實驗、開發遊戲或製作原型,讓 Codex 持續改進已可運作的成果

    避免把一連串互不相關的工作列為同一個目標。

    設定工作流程

    1. 指定一個目標和一個停止條件。
    2. 告訴 Codex 必須先閱讀哪些檔案、文件、議題、日誌或計畫。
    3. 指定可用來驗證進度的指令或產出。
    4. 請 Codex 按檢查點分階段工作,並簡短記錄進度。
    5. 執行期間,使用 /goal 查看狀態。
    6. 工作完成、遇到阻礙或需要改變方向時,視情況暫停、繼續或清除目標。

    開始前,先和 Codex 約定怎樣才算「完成」。如果目標是遷移,「完成」可以是新路徑通過契約測試,而且仍能回復到舊路徑。如果目標是開發遊戲或製作原型,「完成」可以是應用程式能成功建置並啟動,而且符合提供的參考資料或預期行為。

    你可以請 Codex 協助設定目標。先和它討論你想做什麼,再請它直接設定目標並開始工作。

    讓 Codex 獨立工作

    Codex 朝目標工作時,可以請它簡短回報進度,讓你能放心交給它繼續執行。進度報告應說明目前的檢查點、已驗證的項目、剩餘工作,以及 Codex 是否遇到阻礙。 如果進度報告變得含糊,與其陸續補上零散的指示,不如把目標訂得更明確。告訴 Codex 下一個要達到的檢查點、用哪個指令驗證,以及什麼情況下應該暫停。

    Codex 可以朝著目標獨立工作好幾個小時,你不必定時查看。當 Codex 確信已達到停止條件,就會停止執行,因此你可以把 /goal 視為無需監控的背景任務。

    目標範例

    遷移

    無論是將遊戲遷移到新的技術堆疊、將行動應用程式遷移到新平台,還是將程式碼庫遷移到新框架,都可以使用 /goal 讓 Codex 執行遷移:

    /goal 將這個專案從 [legacy stack or system] 遷移到 [target stack or system]。確保所有畫面的外觀都與遷移前完全一致,並使用 playwright interactive 驗證結果。

    製作原型

    無論是從零開始製作應用程式、開發新遊戲,還是新增功能,都可以使用 /goal 讓 Codex 做出完成度高的第一版。你可以在 PLAN.md 檔案中明確描述想要製作的內容,作為開發第一版的依據。

    /goal 依照 PLAN.md 實作,為每個里程碑建立測試,並使用 playwright interactive 驗證結果。[include reference screens as needed]

    最佳化提示詞

    如果你有一套評估測試,可以使用 /goal 讓 Codex 根據評估結果最佳化提示詞。Codex 可以檢查未通過的案例、更新提示詞並重新執行評估,持續調整,直到分數提高或達到你設定的停止條件。

    /goal 最佳化 [prompt file or directory] 中的提示詞,直到整套評估測試達到 [target score or pass rate]。每次修改後,執行 [eval command] 並檢查未通過的案例。只針對具體問題修改提示詞,盡量縮小修改範圍。達到目標,或進一步修改提示詞需要產品或政策方面的指引時,就停止工作。

    相關應用案例