Навыки Android – это оптимизированные инструкции, которые помогают ИИ-инструментам и агентам лучше понимать и выполнять определенные действия. Навыки создаются в соответствии с рекомендациями и руководством по разработке для Android. Они размещены в репозитории GitHub для навыков Android.
Навыки Android позволяют выполнять следующие задачи:
- Переход с XML на Compose
- Перейдите на AGP 9
- Настройте новые фреймворки, например Navigation 3.
- Как сделать интерфейс приложения современным, используя режим без полей
- Проверьте конфигурацию R8, чтобы повысить производительность
Навыки Android помогают LLM получать более актуальные знания и контекст о специализированных рабочих процессах Android.
Навыки Android соответствуют открытому стандарту навыков агентов, поэтому они совместимы с любым ИИ-инструментом, поддерживающим навыки. На этой странице рассказывается, как использовать навыки в Android Studio и как с помощью Android CLI устанавливать навыки для работы с любым агентом и инструментами по вашему выбору.
Основные преимущества навыков Android
Навыки Android дают ряд ключевых преимуществ, которые помогают ускорить рабочий процесс агента и повысить эффективность создания высококачественного кода Android:
- Обоснование на основе экспертных знаний. Предоставляйте агентам больше контекста, связанного с Android, чтобы обосновывать их ответы по запросу и расширять их знания и опыт за рамками обычного цикла обучения модели.
- Повторяющиеся рабочие процессы. Предоставляйте стандартные инструкции, чтобы многоэтапные задачи при разработке для Android выполнялись единообразно.
- Объединение ресурсов. Добавьте скрипты, шаблоны или дополнительную документацию к основным инструкциям в файле SKILL.md, чтобы у агента было все необходимое в одном месте и вам не приходилось вручную прикреплять файлы к запросу.
- Обмен опытом. Сохраняйте шаблоны разработки для Android в общих папках, чтобы у всех разработчиков Android в команде был к ним доступ.
Использовать навыки Android
Навыки Android интегрированы в Android CLI и могут использоваться с любым агентом по вашему выбору.
Android CLI
Рекомендуем устанавливать навыки Android с помощью Android CLI. Так вам будет проще находить, скачивать и настраивать навыки для любого агента.
- Чтобы посмотреть список доступных навыков, выполните команду
android skills list. - Чтобы установить навык, выполните команду
android skills add skill-name. Если навык уже установлен,skills addобновит его до последней версии.
Android Studio
Вы можете скачать навык из репозитория GitHub с навыками Android и импортировать его в свой проект в Android Studio.
Как активировать навык
Агент автоматически активирует навыки, которые подходят для вашей задачи. Чтобы использовать навык, попросите агента выполнить задачу, связанную с этим навыком, например "Сделай интерфейс моего приложения безрамочным". Агент должен автоматически найти и использовать навык, если он доступен.
В Android Studio вы также можете вызвать навык вручную, введя @skill-name в окне чата.
Создавайте собственные навыки
Вы можете создавать собственные навыки, чтобы упаковывать рабочие процессы своей команды и делиться ими. Подробнее о требованиях к навыкам…
Агент ищет навыки, начиная с каталогов .skills/ или .agent/skills/, расположенных в корне проекта. Чтобы создать собственный навык, выполните следующие действия:
- Создайте каталог для навыка, например
my-new-skill/. - В новом каталоге создайте файл
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.
Как работают навыки
Навыки – это знания и умения, которые агент может использовать по запросу. Такая структура позволяет агенту поддерживать большое количество специализированных возможностей, не загромождая непосредственное окно контекста модели.
Модель сама решает, когда использовать навык, на основе вашего запроса и описания навыка. Когда подходящий навык найден, модель динамически загружает все инструкции и ресурсы, необходимые для выполнения задачи.