Как собрать ИИ-продавца в Codex: от задания до проверяемого результата

Подготовьте пакет контекста проекта

Зафиксируйте назначение продукта, стек, готовые модули и запреты в файле правил проекта. Отдельно опишите архитектуру, актуальный план и пользовательский сценарий, который должен заработать после изменения.

Codex должен видеть не только желаемую функцию, но и границы: что переиспользовать, какие файлы разрешено менять, где хранятся данные, какие внешние действия требуют подтверждения и что нельзя переписывать.

Ставьте задачу как проверяемую карточку

Хорошая карточка содержит исходное состояние, видимый результат, разрешённые изменения, запреты и проверки. Например: «пользователь загружает один документ, задаёт вопрос и видит ответ с источником; не добавлять CRM и второй канал».

Просите агента сначала прочитать правила и текущий код, затем предложить короткий план. Одна карточка должна завершаться результатом, который можно открыть и проверить, а не набором подготовительных абстракций.

• переиспользовать существующие модули
• добавить только недостающий срез
• проверить положительный и два отрицательных пути
• зафиксировать evidence и список файлов

Собирайте продавца вертикальными срезами

Практичный порядок: вход и один сотрудник; загрузка одного знания; ответ с источником; Test Room; запреты и handoff; Telegram; Inbox. После каждого среза данные должны сохраняться после перезапуска.

Так Codex получает короткую обратную связь и не строит сразу большую систему на недоказанной основе. Инфраструктурная работа допустима, когда она прямо разблокирует следующий пользовательский шаг.

Задайте приёмку до реализации

Для изменённой логики нужны unit-тесты, интеграция с настоящей базой, browser smoke и проверка после restart. Положительный сценарий доказывает обычную продажу, отрицательные - отсутствие источника, запрещённое обещание и недоступность внешнего сервиса.

Скрин интерфейса показывает только внешний слой. Отдельно проверьте запись в базе, дедупликацию события, тайм-аут внешнего вызова и то, что секреты не попали в клиентский код или логи.

Ограничьте стоимость каждой итерации

Стоимость работы - это не только токены. Считайте время чтения контекста, запуска тестов, вашего ревью и исправления неверного направления. Короткая карточка с ясной приёмкой дешевле большого запроса «сделай ИИ-продавца целиком».

Если после одной итерации нет видимого результата, остановитесь и уточните границу. Не позволяйте агенту компенсировать неопределённость новой архитектурой или функциями «заодно».

Отделите разработку от публикации

Попросите показать diff, результаты тестов и точный список изменённых файлов. Коммит должен содержать только карточку. Push, деплой, DNS и работа с живыми ключами - отдельные действия после вашего разрешения.

Коробочное решение полезно, если вы не хотите заново проектировать этот базовый контур. Codex при этом остаётся помощником для настройки и будущих доработок, а не доказательством готовности сам по себе.