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 或更新版本、用于项目钩子的 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 并信任项目钩子 在 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 会询问是否信任项目钩子。选择**Trust all and continue（全部信任并继续）**之前，请审阅项目和生成的钩子。该标签版本的指南说明，已关闭的对话框可通过以下命令重新打开：`/hooks`，然后按 `t` 和 Esc。授予信任后，在 Codex 中运行 `$aidlc --doctor`。如果钩子没有运行，请遵循集成环境指南中的信任恢复流程；仅仅安装成功并不能证明项目钩子已启用。模型提供商及其凭据在 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` 会为下一个计划开启提问。机器级开关可以强制关闭它，团队记忆规则则可以要求开启；状态行标明实际生效的值。在本教程中，如需在已批准的计划或其测试说明被编辑后再次要求批准，请使用以下命令将 Guard Policy 设为 strict：`$aidlc --guard-policy strict`。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` 显示工作流所在位置。这些记录，加上在生成代码之前可见地出现的批准关卡，共同用于检查结果是否成功。 若计划或其测试说明在构建前发生变化，strict 模式的 Guard Policy 会再次要求批准。使用 relaxed 或 off 策略时，变化会被报告并记录，但工作流可继续，无须强制再次批准。该标签版本的文档还区分了批准后无关源文件的变动：此类变动会被报告，但计划批准仍然针对计划与测试说明。用户可以说“返回已批准的计划”，在构建之前恢复先前的计划。未发生变化的计划不应仅因聊天上下文被压缩就再次提问。 ## 如果没有出现暂停 首先读取 `$aidlc --status` 和 `$aidlc config get plan-approval`。检查选择的范围、实际生效的设置及其来源。Express 和 Proof of concept 默认关闭；请为该意图启用 Plan Approval，或者在完整生命周期适合任务时启动 Feature 工作流。如果配置或钩子似乎有问题，请运行 `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。开发者可以选择 strict，在计划或测试说明发生变化时再次暂停。 ### 来源与延伸阅读 - [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 与提供商的前置条件，项目配置、钩子信任及调用方式。 - [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 前置条件、项目设置、钩子信任及版本不一致恢复流程。 - [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 未运行任何命令。