AI-translated from English; not yet reviewed by a fluent editor. # 設定 AI-DLC 2.11.0，讓它暫停等待程式碼計畫核准 > 這份固定版本、僅依據文件的指南，說明如何啟用並確認 AI-DLC 2.11.0 在產生程式碼前的人為計畫核准關卡。 By BIG CHANGE Editorial Published: 2026-10-15T18:54:16.360Z Updated: 2026-10-15T18:54:16.360Z Canonical: https://bigchange.ai/blog/aidlc-2-11-plan-approval-guide ![Conceptual charcoal illustration of one developer reading abstract plan-like lines on an unbranded desktop monitor while the keyboard sits untouched.](https://bigchange.ai/api/media/file/aidlc-human-plan-review-hero-v1.png) AI-generated conceptual illustration by BIG CHANGE; no actual AI-DLC interface, user session or observed test result is depicted. AI-DLC 2.11.0 能在產生程式碼前暫停 Codex CLI 工作流程，讓開發者閱讀並核准提出的計畫。本指南依據[2026 年 10 月 8 日發布的 v2.11.0](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0)，以及該版本的[Codex CLI](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md)、[工作流程設定檔](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md)與[Plan Approval](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval)說明。BIG CHANGE 查閱了這些文件及該版本標籤的指令參考。我們並未安裝或執行 AI-DLC；以下每一步都僅依據文件。 本指南適合擁有 Git 專案、希望在 AI 程式設計助理產生檔案前檢查程式碼計畫的開發者。預期結果是一個 Plan Approval 問題，會標明計畫、讓開發者要求修改，並在開發者回答前讓建置保持等待。AI-DLC 後續仍有其他檢查；此關卡專門針對程式碼計畫。 ## 開始之前 該版本標籤的[Codex 指南](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md)要求 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 發布頁提供以下限定版本的安裝指令： ```bash curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/download/v2.11.0/install.sh | sh -s -- --version 2.11.0 ``` 發布頁也提供供 PowerShell 使用的[限定版本 Windows 安裝程式](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0)。執行前先檢查安裝程式，並選擇適合自己電腦的方式。接著從專案中檢查安裝版本及環境： ```bash 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 設定流程](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#install)： ```bash 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`，確認沒有進行中的工作流程。[該版本標籤的指令參考](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md)表示，若已有進行中的工作流程，單獨的範圍指令會接續既有工作。本示範請使用沒有進行中工作流程的專案。 在已設定的 Codex 專案輸入 `$aidlc feature`，並回答想要建置什麼任務的問題。輸入應描述功能及限制；最終計畫會從這項工作產生。在建立程式碼計畫之前，使用[v2.11.0 指令參考](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md)檢查實際生效的控制設定： ```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` 流程恢復建置。發布說明表示，未變更的已核准計畫，在對話壓縮或擱置後仍會保留。[該版本標籤的指令參考](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md#read-earlier-questions-and-the-audit-timeline)記載了唯讀指令 `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 整合執行環境復原說明](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md#refresh-and-version-skew)處理。變更進行中專案的執行環境前，先檢查版本是否不符。不要假定沒有問題就代表核准已被記錄：關閉設定時，AI-DLC 會寫入 `PLAN_APPROVAL_SKIPPED` 紀錄列，該版本文件明確區分這與人為核准的差異。 ## 重大變化 - AI-DLC 2.11.0 將計畫問題放入引擎，由引擎記錄決定，並在工作階段擱置或壓縮後保留未變更的已核准計畫。 - 執行 Codex CLI Feature 工作流程時，開發者可確認 Plan Approval 實際生效的設定，在產生程式碼前閱讀計畫，並在關卡要求修改。 - 計畫編輯後是否再次核准取決於 Guard Policy。開發者可選擇嚴格模式，在計畫或測試說明變更時再次暫停。 ### 資料來源與延伸閱讀 - [AI-DLC 2.11.0 發布頁](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0)——有日期的版本、固定版本安裝程式，以及說明中的 Plan Approval 行為。發布說明是在描述功能，並不代表 BIG CHANGE 執行過本指南。 - [v2.11.0 的 Codex CLI 指南](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md)——Codex 版本、Git 與供應商先決條件、專案設定、hook 信任及呼叫方式。 - [v2.11.0 的工作流程設定檔](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md)——設定檔預設值，以及 Feature 與 Express／Proof of concept 的差別。 - [v2.11.0 的 Plan Approval 與 Guard Policy](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md#plan-approval)——首次核准關卡、跳過紀錄，以及已核准計畫變更後的行為。 - [v2.11.0 指令參考](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md)——狀態、設定與稽核歷史指令。 ## Sources - [AI-DLC 2.11.0 發布頁](https://github.com/awslabs/aidlc-workflows/releases/tag/v2.11.0) — 固定版本安裝程式，以及專案對引擎 Plan Approval 的說明；BIG CHANGE 未實際執行。 - [v2.11.0 的 AI-DLC README](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/README.md) — 10 月 8 日版本標籤中的整合執行環境及設定概述。刻意未使用通用的最新版安裝程式。 - [v2.11.0 的 AI-DLC Codex CLI 指南](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/harnesses/codex-cli.md) — 10 月 8 日版本標籤中的 Codex 先決條件、專案設定、hook 信任及版本不符復原方式。 - [v2.11.0 的 AI-DLC 工作流程設定檔](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/workflow-profiles.md) — 10 月 8 日版本標籤中的 Feature、Express 及 Proof of concept 範圍行為與核准預設值。 - [v2.11.0 的 AI-DLC Plan Approval 與 Guard Policy](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/13-customization.md) — 10 月 8 日版本標籤中的計畫問題、跳過紀錄，以及計畫或測試說明變更後的再次核准行為。 - [v2.11.0 的 AI-DLC CLI 指令參考](https://github.com/awslabs/aidlc-workflows/blob/v2.11.0/docs/guide/12-cli-commands.md) — 10 月 8 日版本標籤中的版本、狀態、設定及稽核歷史指令；BIG CHANGE 未執行任何指令。