android-app-factory
Android App Factory — это проверяемый рабочий маршрут для native Android-приложения от формулировки пользовательского результата до подготовки публикации в Google Play. Он ориентирован на Kotlin и Jetpack Compose и связывает продуктовый контракт, архитектуру, доказательства качества, требования магазина и release-артефакты в одну последовательность. В начале фиксируются поддерживаемые форм-факторы, устройства, локали, минимальный SDK, offline-поведение, application ID, модель владения и подписи, владелец релиза, данные, сторонние SDK, разрешения, аккаунты, удаление аккаунта, владелец privacy policy, Data Safety, монетизация и границы внешних мутаций. Неизвестные сведения должны оставаться неизвестными: skill не предлагает придумывать package name, product ID, ответы политики, URL политики конфиденциальности или состояние Play Console. Пайплайн начинается с проверки самого продукта и ожидаемого результата, затем переходит к актуальным требованиям Android и Google Play: target SDK, ограничениям форм-фактора, Data Safety, content rating, app access, account deletion, billing и декларациям разрешений. Архитектура выбирается минимальной, но должна сохранять однонаправленное состояние, безопасность жизненного цикла, состояния offline, ошибки и загрузки, тестируемые границы и принцип наименьших данных и разрешений. Для нового проекта рекомендуются native Kotlin и Jetpack Compose; до реализации функций нужно подтвердить стабильные версии Android и Jetpack, зафиксировать их в version catalog и доказать debug-сборку. Основной продуктовый slice должен закрывать один полный пользовательский сценарий на реальных или детерминированных demo-данных, а история, сохранённое состояние, синхронизация и аккаунты добавляются только по контракту продукта. Проверка качества может включать unit-, repository-, ViewModel-, Compose UI- и instrumented-тесты, end-to-end-проверку главного сценария, static analysis, release build, матрицу устройств и API, baseline profile и Macrobenchmark. Отдельно проверяются accessibility, крупный текст, TalkBack, клавиатура и switch access, контраст и reduced motion, а также startup и производительность ключевой задачи. Если приложение продаёт покрываемые политикой цифровые товары, безопасный маршрут использует Play Billing: обрабатывает pending purchase, выдаёт entitlement, подтверждает и acknowledge-покупку после обработки, восстанавливает владение и выполняет серверную проверку; секреты и серверные credentials не должны находиться на устройстве. Доверительные поверхности включают privacy policy, инвентаризацию данных и SDK для Data Safety, обоснование разрешений, удаление аккаунта в приложении и через web при наличии аккаунтов, content rating, объявление рекламы, инструкции app access и Play Integrity там, где оправдан риск злоупотреблений. Play Integrity рассматривается как сигнал злоупотребления, а не как authentication или единственное основание для постоянной блокировки. Для магазина нужны правдивое описание, иконка, feature graphic, скриншоты каждого заявленного форм-фактора, локализации, контакт поддержки, release notes и инструкции ревьюеру. Релизный контур включает подписанный AAB и Play App Signing, внутреннюю или закрытую проверку, pre-launch report, staged rollout и пострелизный мониторинг; upload, promotion и rollout остаются действиями, требующими явного подтверждения. Результатом должен быть не общий рекламный текст, а набор связных доказательств: понятный core loop, соответствующие коду disclosures, тесты, сборка, поведение ошибки и offline, accessibility-результаты, store-материалы и release gate. Skill не предназначен для iOS и для review-only аудита существующего приложения. Его policy- и release-gate формулировки требуют честно запускать проверки и передавать результаты с рекомендацией; они не заменяют живую проверку официальных требований Google, Play Console, безопасности, юридических условий или фактического поведения приложения. Готовность нельзя подтверждать только debug-сборкой, скриншотом, локальным чтением исходников или успешной загрузкой: нужны доказательства по заявленным устройствам, API, данным, entitlement, core task и процессу отката.
Для чего подходит
- Планирование Android-приложения на Kotlin
- Подготовка Google Play release и store assets
- Проверка privacy, accessibility и staged rollout
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/JasonColapietro/suede-creator-skills/tree/main/skills/android-app-factory