AI-DLC 2.11.0 может остановить процесс Codex CLI до генерации кода, чтобы разработчик прочитал предложенный план и одобрил его. Руководство следует релизу v2.11.0 от 8 октября 2026 года и его версионным инструкциям для Codex CLI, профилей рабочего процесса и Plan Approval. BIG CHANGE изучил эти документы и справочник команд соответствующего тега. Мы не устанавливали и не запускали AI-DLC; все шаги ниже основаны только на документации.

Руководство адресовано разработчику с Git-проектом, который хочет изучить план кода до того, как ИИ-помощник создаст файлы. Ожидаемый результат — вопрос Plan Approval, в котором назван план, можно запросить изменения, а сборка остается в ожидании ответа разработчика. У AI-DLC есть и дальнейшие проверки; этот барьер относится именно к плану кода.

Перед началом

Привязанное к тегу руководство Codex требует Codex CLI 0.145.0 или новее, Git-репозиторий для хуков проекта и настроенного поставщика модели. Нативный релиз AI-DLC не требует Bun или Node.js. Используйте проект, код и план которого вам разрешено отправлять настроенному поставщику модели. Отдельно изучите его условия обработки данных и оплаты; репозиторий AI-DLC не устанавливает единую цену использования поставщика для этого процесса.

Подготовьте конкретную задачу разработки в качестве ввода. Здесь выбран профиль Feature, поскольку документация v2.11.0 указывает, что Plan Approval включен для Feature. 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

Релиз также предоставляет установщик Windows конкретной версии для PowerShell. Изучите установщик и выберите подходящий для компьютера путь до его запуска. Затем проверьте установленную версию и среду из проекта:

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. После подтверждения доверия запустите $aidlc --doctor в Codex. Если хуки не работают, следуйте восстановлению доверия в руководстве интеграционной среды; успешный установщик сам по себе не доказывает, что хуки проекта активны. Поставщик модели и его учетные данные задаются в пользовательских настройках Codex, а не предоставляются AI-DLC.

3. Запустите процесс Feature и проверьте настройки

Сначала запустите $aidlc --status в Codex и убедитесь, что нет активного процесса. Справочник команд тега говорит, что простая команда области без дополнительных параметров продолжает существующую работу, если процесс уже активен. Для этого руководства используйте проект без активного процесса.

В настроенном проекте 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 с помощью $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 показывает положение процесса. Эти записи служат проверкой успеха вместе с видимым появлением барьера перед сгенерированным кодом.

Если план или его инструкции тестирования меняются до сборки, строгая Guard Policy снова запрашивает одобрение. При ослабленной или выключенной политике изменение сообщается и записывается, но процесс может продолжиться без обязательного нового одобрения. Документация тега также отличает изменения несвязанных исходных файлов после одобрения: о них сообщается, тогда как одобрение плана по-прежнему касается плана и инструкций тестирования. Человек может сказать «вернись к одобренному плану», чтобы восстановить прежний план до сборки. Неизмененный план не должен задавать вопрос повторно только из-за сжатия чата.

Если пауза не появляется

Сначала прочитайте $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. Разработчик может выбрать строгий режим, чтобы снова останавливаться при изменении плана или инструкций тестирования.

Источники и дополнительные материалы