Markdown 版本
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

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 未运行任何命令。
BIG CHANGE 新闻通讯
纵览全局,按自己的节奏。
关于人工智能和机器人技术的近期报道、值得关注的变化以及可采用的实用想法。选择每日简报、每周摘要或每月视角。
下次计划发送时间(UTC): . 确认订阅后,您将在下一个计划发送时间收到第一期通讯。