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 或更新版本、用于项目钩子的 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 并信任项目钩子

在 Git 项目根目录中，使用该标签版本的 Codex 设置流程：

Terminal
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，确认没有活动工作流。该标签版本的命令参考说明，已有活动工作流时，单独输入范围命令会继续现有工作。请使用没有活动工作流的项目进行本教程。

在已配置好的 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 会为下一个计划开启提问。机器级开关可以强制关闭它，团队记忆规则则可以要求开启；状态行标明实际生效的值。在本教程中，如需在已批准的计划或其测试说明被编辑后再次要求批准，请使用以下命令将 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 流程继续构建。版本说明指出，未经修改的已批准计划会在聊天上下文压缩或会话停放后保留。该标签版本的命令参考记载了只读命令 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 集成环境恢复流程。更改活动项目的运行时之前，先检查版本是否不一致。不要认为未出现提问就能证明批准已被记录：设置关闭时，AI-DLC 会写入一条 PLAN_APPROVAL_SKIPPED 记录，文档明确将其与人工批准区分开来。

重大变化

  • AI-DLC 2.11.0 将计划提问纳入引擎，由引擎记录决定，并在会话停放或上下文压缩后保留未经修改的已批准计划。
  • 对于 Codex CLI 的 Feature 运行，开发者可以检查 Plan Approval 的实际生效设置，在生成代码前阅读计划，并在关卡处要求修改。
  • 编辑计划后是否需要重新批准取决于 Guard Policy。开发者可以选择 strict，在计划或测试说明发生变化时再次暂停。

来源与延伸阅读