build-loop-codex

build-loop-codex

熱門

當在任何程式碼庫中使用 **Codex**(OpenAI Codex CLI)建置功能,且工作應遵循嚴謹的建置 → 審查 → 測試 → 修正迴圈時使用。觸發詞包括「執行建置迴圈」、「建置下一個任務」、「繼續計畫」、「妥善建置此功能」,或任何要求從計畫檔案或直接功能提示實作工作的請求。從計畫(若無計畫則從提示)建置,對未提交的變更執行 Codex 的 `/review` 並修正所有發現的問題,端對端測試並驗證功能,修正測試發現的任何問題,完成後回報。重複直到所有計畫任務都被勾選。

210星標
41分支
更新於 2026/7/7
SKILL.md
唯讀
名稱
build-loop-codex
描述

當在任何程式碼庫中使用 **Codex**(OpenAI Codex CLI)建置功能,且工作應遵循嚴謹的建置 → 審查 → 測試 → 修正迴圈時使用。觸發詞包括「執行建置迴圈」、「建置下一個任務」、「繼續計畫」、「妥善建置此功能」,或任何要求從計畫檔案或直接功能提示實作工作的請求。從計畫(若無計畫則從提示)建置,對未提交的變更執行 Codex 的 `/review` 並修正所有發現的問題,端對端測試並驗證功能,修正測試發現的任何問題,完成後回報。重複直到所有計畫任務都被勾選。

Codex 建置迴圈

品質把關的功能工作:沒有東西會因為「它能編譯」就出貨——每個增量都必須經過建置、審查、端對端測試,並在使用者聽到「完成」之前修正完畢。

工作來源

  • 存在計畫檔案(路線圖、重構計畫,或帶有 - [ ] 核取方塊的任務清單——搜尋儲存庫):處理第一個未勾選的任務。任務是有順序的——絕不跳過。如果計畫引用了規格文件,只閱讀與目前任務相關的章節。
  • 沒有計畫(或請求超出計畫範圍): 根據使用者的提示建置。將其重新表述為可驗證的目標,包含 2–4 個成功標準,並在建置前用一則訊息確認範圍。

迴圈

每個任務(或每個提示的功能)執行一次。在每個步驟通過之前,不要前進。

  1. 建置。 精確實作任務指定的內容。滿足任務的最簡單實作,外科手術式的變更,不做投機性擴充。符合現有專案慣例。

  2. 審查。 執行 /review 並選擇 「審查未提交的變更」。如果變更涉及驗證、付款、使用者輸入或資料存取,請透過 「自訂審查指示」 進行第二輪(例如「專注於安全漏洞和未驗證的輸入」)。修正所有範圍內的發現——錯誤、安全問題、邊界情況、效能、你碰過的檔案中的風格。如果專案有設計系統規格(設計代碼檔案、DESIGN.md、主題設定),請根據它檢查 UI 變更——不得有繞過代碼的硬編碼顏色、字型或間距。注意未碰過程式碼中已存在的問題,在報告中提出,而不是默默修正。重新執行 /review 直到乾淨。如果發現與任務或規格矛盾,以規格為準——標記分歧。

  3. 端對端測試。 執行任務的驗證步驟(或成功標準)。執行完整測試套件——之前通過的所有測試必須仍然通過。為新邏輯新增測試。然後以使用者方式操作功能:執行應用程式,走過真實流程,包括空狀態、載入狀態和錯誤狀態。

  4. 修正。 測試發現的任何問題都回到迴圈:修正 → /review → 重新測試。絕不將失敗的任務標記為完成;絕不在應用程式損壞時開始下一個任務。

  5. 繼續。 將任務標記為 - [x],更新計畫中的任何進度/狀態行,並迴圈到下一個任務,直到請求的範圍完成。

  6. 回報。 完成時,告訴使用者:建置了什麼以及計畫進度、審查發現已修正和任何延後的事項、如何驗證(測試 + 走過的流程),以及接下來需要他們注意的事項。對任何不穩定或部分驗證的事誠實。

規則

  • 跳過審查或未測試的工作 = 未完成的工作。
  • 不要重新爭論計畫決策;如果任務似乎有誤,提出一個具體問題,而不是猜測。
  • 發現沒有任務涵蓋的工作?提出來並建議一個任務——絕不默默擴大範圍。