Внутри Android Skills — создано для устаревания

В апреле мы выпустили официальные Android Skills , и отклик превзошел все наши ожидания. В этом посте я расскажу о некоторых полученных отзывах, объяснив философию и методологию проекта. Надеюсь, это также поможет вам понять, что происходит за кулисами при установке и использовании навыков, что позволит вам более эффективно использовать токены и свое время.

Почему существует так мало официально признанных навыков?

В настоящее время мы рассматриваем новые навыки только в том случае, если в современных моделях (SOTA) существует подтвержденный пробел в знаниях. Проще говоря: вам не нужно обучать модель тому, что она уже знает. (Хотя есть несколько исключений — читайте дальше!)

На данный момент мы выпустили около 20 официальных навыков, и они целенаправленно ориентированы на узкоспециализированные, быстро развивающиеся области, в которых стандартные модели еще не полностью развиты — такие как AGP 9, Navigation 3, расширенные API камеры и Perfetto SQL.

А как насчет основных, более общих навыков? Каждый установленный навык добавляет 100–200 токенов в базовый контекст каждой начатой ​​вами задачи. Если этот навык действительно активируется, это количество может быстро возрасти до тысяч. В большинстве случаев накопление базовых навыков контрпродуктивно и дорого. Прежде чем устанавливать навык для написания базового кода на Kotlin или Compose, подумайте, действительно ли он нужен вашему выбранному магистру права, или он уже достаточно хорошо знаком с этими темами.

Оценка навыков

Перед выпуском каждый навык проходит всестороннее тестирование, которое доказывает его реальную ценность. Эти тесты должны проходить успешно, когда навык активен, и проваливаться в противном случае. Тесты для навыков — это то же самое, что интеграционные тесты для кода.

timeout_s: 1200
repository:
  url: [redacted - internal git repo]
  working_dir: wear_compose_m3_empty_app
category_ids:
  - wear
prompt: |-
  Add a horizontal pager to MainActivity.kt. Have three pages in the pager. Each page should contain
  the text "Page 1", "Page 2", and "Page 3" respectively in the center of the screen.
commands:
  build:
    - ./gradlew assembleDebug
acceptance_criteria:
  project_builds: true
  llm_diff_judge:
    - Must use `HorizontalPagerScaffold`.
    - Each page should use `AnimatedPage` to wrap a `ScreenScaffold`.

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

Как минимум, мы тестируем навык в Android Studio, используя последнюю версию Gemini Flash. В зависимости от навыка, мы также обеспечиваем совместимость с другими моделями, такими как Gemini Pro, и другими агентами, такими как Antigravity, а также сторонними системами.

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

Использование базы знаний Android (Android Studio или Android CLI)

Если вы разрабатываете приложения для Android, вам всегда следует использовать базу знаний Android, чтобы иметь доступ к официальной документации. Если вы используете агент в Android Studio, он уже доступен как инструмент, но если вы используете другой агент, установите Android CLI . Среди прочего, он содержит команду docs, которая предоставляет вашему агенту доступ к официальной документации Android. Наличие одного инструмента гораздо эффективнее, чем установка сотен навыков.

Если ваша модель ведет себя слишком самоуверенно, и вы хотите, чтобы она чаще обращалась к документации, очень распространенный способ мотивировать ее — добавить в файл AGENTS.md или аналогичный файл фразу «Всегда обращайтесь к официальной документации Android при работе с API Android». Конечно, вы также можете принудительно заставить ее проверять документацию непосредственно в ваших подсказках.

Почему запросы на слияние отключены?

Поскольку наша система оценки зависит от внутренней инфраструктуры, которая не может быть опубликована в открытом доступе, мы не можем принимать прямые запросы на добавление новых навыков — без этой инфраструктуры у нас не было бы возможности переоценивать поступающие изменения в запросах на слияние. Однако мы активно отслеживаем отзывы сообщества. Если вы хотите сообщить об ошибке, предложить оптимизацию или запросить новый официальный навык, пожалуйста, создайте заявку !

В каких случаях базовые или основные навыки имеют смысл?

Хотя современные модели, как правило, не требуют базовых навыков, существуют сценарии, в которых использование основных или разработанных сообществом навыков приносит реальную пользу. Например:

• Вы используете расплывчатые подсказки : навыки усиливают ваше намерение. Если вы дадите расплывчатую подсказку, например, «добавить анимацию на этот экран», конкретный навык анимации Compose может вдохновить модель, подтолкнув ее к использованию современных API или шаблонов тестирования скриншотов, которые она, возможно, иначе бы не рассматривала.
• Вы хотите использовать более компактные и дешевые модели : модели Frontier LLM дороги. Если вы перекладываете рутинные задачи на более компактные модели с открытыми весами, такие как Gemma 4, то включение базовых навыков заполняет пробелы в знаниях, которые не удается восполнить с помощью моделей с меньшим количеством параметров.
• Вы занимаетесь рефакторингом или проверкой устаревшего кода: модели отлично справляются с генерацией работающего кода, но при редактировании старых кодовых баз они часто отдают приоритет соответствию существующим шаблонам, а не переписыванию кода с учетом современных требований. Специализированный агент-рецензент, обладающий необходимыми навыками, может помочь преодолеть эту привычку.
• Вы отклоняетесь от нормы : магистры права любят стандартный «гугловский подход» к проектированию Android-приложений. Если ваша команда использует сильно кастомизированную архитектуру уровня представления, модели будет сложно оставаться согласованной. Создание пользовательского навыка, явно описывающего вашу архитектуру, значительно улучшит ситуацию.

Где я могу найти необходимые базовые навыки?

Сообщество Android всегда готово помочь. Крис Бейнс создал обширную коллекцию навыков для Compose и Kotlin , Иван Моргилло опубликовал навык для аудита проектов Compose , а Джевонг Ым разработал два навыка по тестированию и производительности .

Всегда загружайте навыки из надежных источников! Лично я бы не доверял репозиториям, содержащим десятки или сотни навыков для Android, поскольку они, вероятно, сгенерированы искусственным интеллектом и не протестированы, а также могут содержать вредоносные или предвзятые инструкции. Кроме того, не устанавливайте общие навыки разработки программного обеспечения вслепую; многие из них разработаны специально для веб-разработки.

Цель: амортизация

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