Настройка Codex для Android-проектов

Роли инструментов

• Codex CLI: изменения кода, команды, тесты, review и документация.
• Android Studio: SDK Manager, emulator/device, Logcat и профилировщики.
• Gitea: единственный Git-контур и CI/CD.
• CLI-скрипты: стабильный интерфейс между человеком, Codex и CI.
• MCP: не нужен на первом этапе; подключается только с least-privilege доступом.

Проектная конфигурация

.codex/config.toml:

model = "gpt-5.6-terra"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"

Terra/high используйте для реализации, тестов и review. Sol/high — для архитектуры, сложного планирования и проектирования данных.

Codex читает личный ~/.codex/config.toml, затем project overrides из .codex/config.toml доверенного проекта. CLI flags имеют более высокий приоритет. Config basics.

Что записать в AGENTS.md

Проектный файл должен содержать только устойчивые правила:

• layout и фактический stack;
• bootstrap/build/test/lint/smoke команды;
• Definition of Done;
• правила package ID, versioning и permissions;
• границы доступа к signing и publication;
• запрет на чтение/вывод секретов;
• обязательный diff/security check;
• разрешённые внешние действия.

Codex загружает AGENTS.md от корня проекта до текущей папки; более близкие инструкции имеют приоритет. AGENTS.md.

Готовый шаблон находится в project-instructions-template.md.

Формат задания Codex

Каждое содержательное задание формулируйте четырьмя блоками:

Goal: какой пользовательский результат нужен.
Context: конкретные файлы, ошибки, issue или reference.
Constraints: stack, permissions, policy, границы изменений.
Done when: команды и наблюдаемое поведение, подтверждающие готовность.

Пример для native API-клиента:

Goal: добавить экран списка заказов с локальным cache и retry.
Context: app module, OpenAPI contract и существующий repository.
Constraints: package ID не менять, без новых permissions/analytics; offline
показывает cache или явную ошибку.
Done when: unit/contract/UI tests, lint, assembleDebug и bundleRelease проходят;
clean install, timeout, 401, retry и background/resume проверены на AVD.

Автоматизация Codex

Для read-only анализа CI:

codex exec --ephemeral --json \
  "Проанализируй приложенный лог, назови первопричину и минимальный fix"

Для машинного результата используйте --output-schema. Codex job должен быть изолирован от signing key и Play service account. Не запускайте untrusted build scripts в окружении с CODEX_API_KEY. Non-interactive mode.

Повторяемый skill

Установленный $android-release:

1. определяет Native/Capacitor и capability gates;
2. проверяет JDK/SDK/Gradle/AVD и project commands;
3. реализует законченную вертикаль и релевантные failure states;
4. проверяет permissions/SDK/data inventory и текущую Play policy;
5. собирает APK/AAB и формирует release evidence;
6. останавливается на внешней публикации или фактах владельца без разрешения.

Юридические декларации, права на контент и факты о данных skill не угадывает.