Обзор навыков Android

Навыки Android — это оптимизированные для ИИ инструкции, помогающие инструментам и агентам ИИ лучше понимать и выполнять определенные шаблоны, соответствующие передовым методам и рекомендациям по разработке под Android. Они размещены в репозитории Android skills на GitHub .

С помощью навыков Android можно выполнять такие задачи, как:

  • Переход с XML на Compose
  • Обновите до AGP 9
  • Установите более новые фреймворки, такие как Navigation 3.
  • Модернизируйте пользовательский интерфейс вашего приложения, сделав его безрамочным.
  • Повысьте производительность, проведя аудит конфигурации R8.

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

Навыки Android соответствуют открытому стандарту навыков агентов , поэтому они совместимы с любым инструментом ИИ, поддерживающим навыки. На этой странице объясняется, как использовать навыки в Android Studio и как использовать Android CLI для установки навыков для использования с любым агентом и инструментами по вашему выбору.

Основные преимущества навыков Android

Навыки работы с Android предоставляют ряд ключевых преимуществ, направленных на ускорение вашего рабочего процесса и более эффективное создание высококачественного кода для Android:

  • Оснастите модель экспертными знаниями: Предоставьте агентам больше контекста, специфичного для Android, обеспечивая им необходимую ориентацию и расширяя их знания и опыт по умолчанию за пределы обычного цикла обучения модели.
  • Повторяемые рабочие процессы: Предоставьте стандартные инструкции, чтобы обеспечить единообразное выполнение многоэтапных задач в разработке под Android.
  • Объединение ресурсов: Включайте скрипты, шаблоны или дополнительную документацию вместе с основными инструкциями в файле SKILL.md, чтобы у агента было все необходимое в одном месте, избегая необходимости вручную прикреплять файлы для запроса.
  • Обмен опытом: упакуйте разработанные вашей командой шаблоны разработки Android в общие папки для унифицированного доступа и совместной работы.

Используйте навыки Android

Навыки Android интегрированы в интерфейс командной строки Android и могут использоваться с любым агентом по вашему выбору.

gemini_cli_skills_demo.gif

Android CLI

Мы рекомендуем устанавливать навыки Android с помощью Android CLI , что упрощает поиск, загрузку и управление навыками для любого агента по вашему выбору.

Android Studio

Вы можете загрузить навык из репозитория Android skills на GitHub и импортировать его в свой проект в Android Studio .

Активировать навык

Агент автоматически активирует навыки, соответствующие вашей задаче. Чтобы использовать навык, предложите агенту выполнить задачу, связанную с этим навыком, например: «Сделать пользовательский интерфейс моего приложения сплошным». Агент должен автоматически найти и использовать навык, если он доступен.

В Android Studio вы также можете вызвать навык вручную, набрав @skill-name в окне чата.

Создавайте собственные навыки

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

Агент ищет навыки, начиная с каталогов .skills/ или .agent/skills/ расположенных в корневой директории вашего проекта. Чтобы создать собственный навык, выполните следующие шаги:

  1. Создайте директорию для вашего навыка (например, my-new-skill/ ).
  2. Создайте файл SKILL.md (с учетом регистра) в новой директории.

Навыки должны соответствовать следующим правилам:

  • Для каждого навыка требуется отдельная директория: каждый навык должен иметь свою собственную уникальную директорию, содержащую файл SKILL.md и любые дополнительные ресурсы .
  • Вложенность: Все навыки должны находиться в каталоге .skills/ или .agent/skills/ в корне проекта. Однако для лучшей организации можно использовать подкаталоги (например, skills/ui-flows/<skill name>/SKILL.md или skills/testing/<skill name>/SKILL.md ).
  • Область применения: В настоящее время поддерживаются только навыки, встроенные в кодовую базу проекта.

В файле SKILL.md для метаданных используется блок YAML, а для инструкций — стандартный Markdown.

  • name : Уникальный идентификатор навыка. Он должен совпадать с именем каталога.
  • description : Четкое объяснение того, что делает навык и когда агент должен его использовать.
  • Тело сообщения: Вложенный текст Markdown, расположенный под блоком YAML, содержит инструкции, определяющие поведение агента при активации навыка.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Рекомендации по форматированию

  • Имя: Максимум 64 символа (только строчные буквы, цифры и дефисы).
  • Описание: Максимальное количество символов — 1024.
  • Основной текст: стремитесь к объему в 10–20 тысяч символов (примерно 2500–5000 токенов). Если ваши инструкции превышают этот объем, рассмотрите возможность переноса подробной документации в файл ресурсов, как описано в разделе «Дополнительные каталоги навыков» .

Дополнительные каталоги навыков

Чтобы файл SKILL.md оставался лаконичным и модульным, вы можете включить дополнительные ресурсы в следующие необязательные каталоги внутри папки вашего навыка:

  • scripts/ : Содержит исполняемый код (например, Python или Bash), который может запустить агент.
  • references/ : Содержит подробную техническую документацию, справочники по API или руководства по конкретным областям.
  • assets/ : Содержит статические ресурсы, такие как шаблоны документов, диаграммы пользовательского интерфейса или JSON-схемы.

При указании этих файлов в инструкциях SKILL.md используйте относительные пути от корневой директории навыка. Например: Run the script at scripts/cleanup.py .

Как работают навыки

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

Модель автоматически принимает решение о том, когда использовать тот или иной навык, основываясь на вашем запросе и описании навыка. Когда определяется подходящий навык, модель динамически подтягивает полные инструкции и ресурсы, необходимые для выполнения задачи.