Локальный Android plugin для Codex

В codex/plugins/android-development хранится plugin без MCP, сетевых integrations и секретов. Он содержит два навыка и локальные обработчики событий.

Навык	Когда использовать
$android-release	Выбор native/PWA пути, создание приложения, среда, сборка APK/AAB и подготовка выпуска.
$android-iteration	Доработка существующего приложения: воспроизведение, минимальная правка, регрессионная проверка и запись результата.

Общие команды сборки находятся в scripts/, а пользовательский маршрут — в цикле APK. Навык не подменяет проектные команды и не объявляет пропущенные проверки успешными.

Состав

codex/
├── .agents/plugins/marketplace.json
└── plugins/android-development/
    ├── .codex-plugin/plugin.json
    ├── hooks/
    │   ├── hooks.json
    │   └── android-iteration-policy.py
    └── skills/
        ├── android-release/
        │   ├── SKILL.md
        │   ├── agents/openai.yaml
        │   ├── references/
        │   └── scripts/android-doctor.sh
        └── android-iteration/
            ├── SKILL.md
            └── agents/openai.yaml

Установка

Marketplace имеет стандартный layout внутри отдельного корня codex/, потому что служебный .agents самого рабочего корня смонтирован только для чтения.

codex plugin marketplace add ~/projects/android/codex
codex plugin add android-development@android-local

После установки начните новую сессию Codex и вызовите:

$android-release Создай или доработай приложение в текущей папке, проверь APK/AAB и подготовь Google Play handoff.

Для следующей правки:

$android-iteration Исправь <поведение> в <app-root>. Шаги воспроизведения: <шаги>.
Ожидаемый результат: <результат>. Пройди локальные проверки и сохрани evidence.

Обновление и включение hooks

21 сентября 2026 года локально установлен и включён plugin версии 0.2.0. Исходники и установленная копия проверены на совпадение. Этот факт относится к рабочей машине, а не означает установку на компьютере читателя.

В проверенной версии CLI нет plugin update. После изменения исходников обновите только этот пакет штатно:

codex plugin remove android-development@android-local
codex plugin add android-development@android-local

До переустановки сохраните сведения об установленной версии и источник для отката. Не редактируйте файлы в установленном plugin cache вручную.

Новая сессия должна загрузить обновлённые навыки. Для hooks дополнительно откройте /hooks, просмотрите определения android-development и подтвердите доверие только этому пакету. Это требование среды Codex для новых или изменённых plugin hooks: установка пакета и unit-тесты не подтверждают живое срабатывание.

Что именно делает hook

• Добавляет краткий протокол итерации только для cwd внутри /home/aleksey/projects/android.
• В перехватываемой shell-команде требует явный target для adb uninstall, adb shell pm clear и adb shell cmd package clear: -s, -d, -e или непустой ANDROID_SERIAL.
• Не вводит запрет на разрешённую пользователем публикацию или подпись. Разрешения на данные и внешние действия определяются задачей и AGENTS.md.

Это узкая проверка shell-команд, не полноценная граница безопасности. MCP, hosted tools, произвольные скрипты и вложенные вызовы не получают гарантированного покрытия. Проверены входные fixtures и установленный скрипт; реальное событие Codex после доверия hook в новой сессии остаётся отдельной проверкой.

Механизм загрузки hooks/hooks.json, переменная ${PLUGIN_ROOT} и доверие hooks описаны в официальной документации Codex.

Проверка исходников plugin

python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
  codex/plugins/android-development/skills/android-release
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
  codex/plugins/android-development/skills/android-iteration
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
  codex/plugins/android-development
node --test tests/android-hooks.test.mjs

Doctor можно запускать независимо от Codex:

codex/plugins/android-development/skills/android-release/scripts/android-doctor.sh \
  /path/to/android-project

Plugin не публикует приложение и не получает доступ к Play Console. Он останавливается на owner gates: production signing, юридические декларации, аккаунт разработчика и решение о rollout.

Skill поддерживает Native Kotlin/Compose, API/offline-first, device/background, media/game и Capacitor lanes. Новую сессию после обновления plugin нужно начать заново, чтобы Codex загрузил актуальную версию skill.