code-review-testing

Официальный skill Codex — это краткая инструкция по авторству тестов для изменений агентной логики. Его главный выбор — integration-тесты вместо unit-тестов, когда меняется поведение агента. В исходнике прямо сказано, что такие тесты находятся в core/suite и используют test_codex для подготовки тестового экземпляра Codex. Поэтому карточка относится к изменениям самого агентного поведения и не является общим руководством по тестированию любого TypeScript-, Python- или Rust-проекта. Критическое правило источника сформулировано однозначно: feature, которая меняет agent logic, MUST добавить integration test. При планировании такого изменения нужно перечислить основные изменения логики и пользовательские сценарии, которые должны быть проверены. Этот список не заменяет тест: он делает ожидаемое поведение явным и помогает связать каждое изменение с проверяемым результатом. В практической работе сначала следует определить, какие именно решения агента, вызовы инструментов или видимое для пользователя поведение поменяются, затем добавить интеграционную проверку в существующую структуру core/suite. Подход полезен там, где изолированный вызов функции не показывает реальный путь через тестовый экземпляр Codex. Источник не предлагает подменять этот путь набором test-only функций в основной реализации. Напротив, он требует не добавлять тестовые вспомогательные функции в production-код. Такая граница сохраняет разницу между кодом агента и кодом, который нужен только для проверки, и не превращает тестовый сценарий в новую часть публичной логики. Если unit-тест действительно нужен, skill указывает отдельный формат: dedicated test file с именем *_tests.rs. Это не разрешение переносить всю проверку поведения в unit-слой; основной приоритет остаётся за integration-тестом для изменений логики агента. Перед написанием нового helper-а также нужно проверить существующие помощники: исходник отдельно советует искать уже имеющиеся utilities, чтобы сделать тесты более короткими и читаемыми. Карточка тем самым задаёт несколько ограничений одновременно — место интеграционных тестов, способ создания экземпляра Codex, отдельный файл для unit-теста и запрет тестовых функций в основном коде. Типовой сценарий применения выглядит так: зафиксировать major logic changes и user-facing behaviors, найти подходящий набор тестов в core/suite, использовать test_codex для поднятия тестового экземпляра, добавить integration test, а затем при необходимости вынести узкую изолированную проверку в отдельный *_tests.rs. Если существующий helper уже решает задачу настройки или проверки, его следует переиспользовать. Skill не обещает автоматическую генерацию полного набора тестов, не описывает конкретные assertions для каждого feature и не утверждает, что unit-тест сам по себе покрывает изменение агентного поведения. Его проверяемая ценность — в выборе уровня теста и сохранении пользовательского сценария в качестве обязательного критерия.