AI-DLC 2.11.0 能在產生程式碼前暫停 Codex CLI 工作流程，讓開發者閱讀並核准提出的計畫。本指南依據2026 年 10 月 8 日發布的 v2.11.0，以及該版本的Codex CLI、工作流程設定檔與Plan Approval說明。BIG CHANGE 查閱了這些文件及該版本標籤的指令參考。我們並未安裝或執行 AI-DLC；以下每一步都僅依據文件。

本指南適合擁有 Git 專案、希望在 AI 程式設計助理產生檔案前檢查程式碼計畫的開發者。預期結果是一個 Plan Approval 問題，會標明計畫、讓開發者要求修改，並在開發者回答前讓建置保持等待。AI-DLC 後續仍有其他檢查；此關卡專門針對程式碼計畫。

開始之前

該版本標籤的Codex 指南要求 Codex CLI 0.145.0 或更新版本、供專案 hook 使用的 Git 儲存庫，以及已設定的模型供應商。原生 AI-DLC 發行版不需要 Bun 或 Node.js。請使用你有權將其程式碼及計畫傳送給已設定模型供應商的專案。另行查閱供應商的資料處理及計費條款；AI-DLC 儲存庫並未為此工作流程列出統一的供應商使用價格。

先準備一項具體開發任務作為輸入。本示範選擇Feature設定檔，因為 v2.11.0 文件說明 Feature 預設開啟 Plan Approval。Express與Proof of concept開始時關閉 Plan Approval，但使用者仍可要求審查特定計畫。選用的設定檔，比籠統期待每次執行 AI-DLC 都會暫停更重要。

1. 安裝並確認固定的版本

在 macOS、Linux 或 WSL，v2.11.0 發布頁提供以下限定版本的安裝指令：

Terminal
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/download/v2.11.0/install.sh | sh -s -- --version 2.11.0

發布頁也提供供 PowerShell 使用的限定版本 Windows 安裝程式。執行前先檢查安裝程式，並選擇適合自己電腦的方式。接著從專案中檢查安裝版本及環境：

Terminal
aidlc --version
aidlc doctor
codex --version

預期 aidlc --version 會回報 2.11.0。aidlc doctor 會回報設定及執行階段問題，而 codex --version 可用來確認 Codex CLI 的最低版本。若安裝版本不同，請先停在此處，依照 v2.11.0 發布頁的安裝或更新說明處理；以下步驟固定適用於該版本。

2. 設定 Codex 並信任專案 hook

從 Git 專案根目錄使用該版本標籤的 Codex 設定流程：

Terminal
aidlc config --harness codex
aidlc doctor
codex

Codex 會詢問是否信任專案 hook。選擇以下項目前，先檢查專案及產生的 hook：Trust all and continue（全部信任並繼續）。該版本指南表示，已關閉的對話框可使用 /hooks，接著 t 和 Esc 重新開啟。信任之後，在 Codex 執行 $aidlc --doctor。若 hook 沒有運作，請依整合執行環境指南的信任復原方式處理；安裝程式成功本身，無法證明專案 hook 已啟用。模型供應商及其憑證是在 Codex 的使用者層級設定中設定，並非由 AI-DLC 提供。

3. 啟動 Feature 工作流程並檢查設定

先在 Codex 執行 $aidlc --status，確認沒有進行中的工作流程。該版本標籤的指令參考表示，若已有進行中的工作流程，單獨的範圍指令會接續既有工作。本示範請使用沒有進行中工作流程的專案。

在已設定的 Codex 專案輸入 $aidlc feature，並回答想要建置什麼任務的問題。輸入應描述功能及限制；最終計畫會從這項工作產生。在建立程式碼計畫之前，使用v2.11.0 指令參考檢查實際生效的控制設定：

Text
$aidlc --status
$aidlc config get plan-approval
$aidlc config get guard-policy

查看 Plan Approval 是否為on（開啟），以及標示的設定來源。若此項工作意圖的設定是關閉，$aidlc --plan-approval on 會為下一個計畫開啟問題。機器層級的開關可以強制關閉，而團隊記憶規則可以要求開啟；狀態列會標明實際生效的值。若也希望已核准計畫或其測試說明經編輯後需要再次核准，本示範請使用 $aidlc --guard-policy strict 將 Guard Policy 設為嚴格。開啟 Plan Approval 控制的是第一個問題；Guard Policy 控制的是已核准計畫變更後的處理。

4. 在關卡審查程式碼計畫

繼續工作流程，直到 Code Generation 準備好計畫。啟用 Plan Approval 時，v2.11.0 引擎會顯示計畫摘要及路徑，並提供以下選項：Approve Plan（核准計畫）、Request Changes（要求修改），或I'll edit the files（我會編輯檔案）。開啟所指的 code-generation-plan.md，閱讀計畫中的檔案、順序及測試說明。核准前，檢查所有指令、對專案資料的存取，以及可能變更儲存庫的動作。

若計畫需要不同的實作或測試，選擇Request Changes（要求修改）。若要自行編輯檔案，使用引擎的I'll edit the files（我會編輯檔案）流程，不要將編輯視為核准。只有你的回答能核准計畫；模型無法代你核准。啟用關卡時，產生程式碼會等待該回答。發布說明表示，建置等待期間仍可進行審查、設定、提交或其他獲允許的請求。

5. 核准、檢查紀錄並處理變更的計畫

計畫可接受時，在開啟的問題中回答Approve Plan（核准計畫）。引擎會針對該計畫記錄核准，並經由正常的 next 流程恢復建置。發布說明表示，未變更的已核准計畫，在對話壓縮或擱置後仍會保留。該版本標籤的指令參考記載了唯讀指令 aidlc engine audit history，可檢查已記錄的時間軸，而 $aidlc --status 會顯示工作流程的位置。這些紀錄，以及產生程式碼前確實出現關卡，都是成功檢查的依據。

若建置前計畫或其測試說明改變，嚴格的 Guard Policy 會再次要求核准。使用寬鬆或關閉的政策時，變更會被回報及記錄，但工作流程可不經強制的新核准繼續。該版本文件也區分了核准後無關原始碼檔案的變動：那些變動會被回報，而計畫核准仍針對計畫及測試說明。使用者可以說「回到已核准的計畫」，在建置前還原先前計畫。未變更的計畫不應只因對話壓縮而再次提問。

若沒有出現暫停

先閱讀 $aidlc --status 和 $aidlc config get plan-approval。檢查所選範圍、實際生效的設定及其來源。Express 和 Proof of concept 預設關閉；請為該工作意圖啟用 Plan Approval，或在完整生命週期適合任務時，啟動 Feature 工作流程。若設定或 hook 看似異常，請執行 aidlc doctor 並依照Codex 整合執行環境復原說明處理。變更進行中專案的執行環境前，先檢查版本是否不符。不要假定沒有問題就代表核准已被記錄：關閉設定時，AI-DLC 會寫入 PLAN_APPROVAL_SKIPPED 紀錄列，該版本文件明確區分這與人為核准的差異。

重大變化

  • AI-DLC 2.11.0 將計畫問題放入引擎，由引擎記錄決定，並在工作階段擱置或壓縮後保留未變更的已核准計畫。
  • 執行 Codex CLI Feature 工作流程時，開發者可確認 Plan Approval 實際生效的設定，在產生程式碼前閱讀計畫，並在關卡要求修改。
  • 計畫編輯後是否再次核准取決於 Guard Policy。開發者可選擇嚴格模式，在計畫或測試說明變更時再次暫停。

資料來源與延伸閱讀