Les compétences Android sont des instructions optimisées par l'IA. Elles aident les outils et agents d'IA à mieux comprendre et exécuter des modèles spécifiques qui suivent les bonnes pratiques et les conseils sur le développement Android. Ils sont hébergés dans le dépôt GitHub des compétences Android.
Vous pouvez utiliser une skill Android pour effectuer des tâches telles que :
- Migrer d'XML vers Compose
- Passer à AGP 9
- Configurer des frameworks plus récents comme Navigation 3
- Moderniser l'UI de votre application en la rendant bord à bord
- Améliorer les performances en auditant votre configuration R8
En utilisant les compétences Android, vous pouvez aider à ancrer les LLM avec des connaissances et un contexte plus récents sur les workflows Android spécialisés.
Les compétences Android suivent la norme ouverte agent skills. Elles sont donc compatibles avec tous les outils d'IA qui prennent en charge les compétences. Cette page explique comment utiliser les compétences dans Android Studio et comment utiliser la CLI Android pour installer des compétences à utiliser avec l'agent et l'outil de votre choix.
Principaux avantages des compétences Android
Les compétences Android offrent plusieurs avantages clés qui visent à accélérer votre workflow agentique pour produire plus efficacement du code Android de haute qualité :
- Ancrage avec des connaissances d'expert : fournissez aux agents un contexte plus spécifique à Android, en les ancrant à la demande et en étendant leurs connaissances et leur expertise par défaut au-delà du cycle d'entraînement de modèle régulier.
- Workflows reproductibles : fournissez des instructions standards pour vous assurer que les tâches en plusieurs étapes du développement Android sont effectuées de manière cohérente.
- Regroupement des ressources : incluez des scripts, des modèles ou de la documentation supplémentaire avec vos instructions SKILL.md principales afin que l'agent dispose de tout ce dont il a besoin au même endroit, ce qui évite d'avoir à joindre manuellement des fichiers pour une requête.
- Expertise partagée : regroupez les modèles de développement Android de votre équipe dans des dossiers partagés pour un accès et une collaboration unifiés.
Utiliser les compétences Android
Les compétences Android sont intégrées à l'interface de ligne de commande Android et peuvent être utilisées avec l'agent de votre choix.
CLI Android
Nous vous recommandons d'installer une compétence Android à l'aide de la CLI Android, qui facilite la découverte, le téléchargement et la gestion des compétences pour l'agent de votre choix.
- Pour afficher la liste des compétences disponibles, exécutez la commande
android skills list. - Pour installer une compétence, exécutez
android skills add --skill skill-name.
Android Studio
Vous pouvez télécharger une compétence à partir du dépôt GitHub des compétences Android et l'importer dans votre projet dans Android Studio.
Activer une compétence
L'agent active automatiquement les compétences qui sont pertinentes pour votre tâche. Pour utiliser une compétence, demandez à l'agent d'effectuer une tâche liée à la compétence, par exemple "Rends l'UI de mon application bord à bord". L'agent doit trouver et utiliser automatiquement la compétence si elle est disponible.
Dans Android Studio, vous pouvez également appeler une compétence manuellement en saisissant @skill-name directement dans la fenêtre de chat.
Créer vos propres compétences
Vous pouvez créer vos propres compétences pour empaqueter et partager les workflows de votre équipe. Pour en savoir plus sur les compétences requises, consultez les spécifications des compétences des agents.
L'agent recherche des compétences à partir des répertoires .skills/ ou .agent/skills/ situés à la racine de votre projet. Pour créer une compétence personnalisée, procédez comme suit :
- Créez un répertoire pour votre skill (par exemple,
my-new-skill/). - Créez un fichier
SKILL.md(sensible à la casse) dans le nouveau répertoire.
Les skills doivent respecter les règles suivantes :
- Un répertoire par skill : chaque skill doit avoir son propre répertoire unique, qui inclut un fichier
SKILL.mdet toutes les ressources supplémentaires. - Emboîtement : toutes les compétences doivent se trouver dans le répertoire
.skills/ou.agent/skills/à la racine du projet. Toutefois, vous pouvez utiliser des sous-répertoires pour une meilleure organisation (par exemple,skills/ui-flows/<skill name>/SKILL.mdouskills/testing/<skill name>/SKILL.md). - Champ d'application : seules les compétences situées dans la base de code du projet sont acceptées.
Le fichier SKILL.md utilise un bloc YAML pour les métadonnées et le format Markdown standard pour les instructions.
name: identifiant unique de la skill. Il doit correspondre au nom du répertoire.description: explication claire de ce que fait la compétence et du moment où l'agent doit l'utiliser.- Corps : le corps Markdown situé sous le bloc YAML contient les instructions qui guident le comportement de l'agent lorsque la compétence est active.
---
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
Consignes relatives au format
- Nom : 64 caractères maximum (lettres minuscules, chiffres et traits d'union uniquement).
- Description : 1 024 caractères maximum.
- Contenu du corps : visez entre 10 000 et 20 000 caractères (environ 2 500 à 5 000 jetons). Si vos instructions dépassent cette limite, envisagez de déplacer la documentation détaillée vers un fichier de ressources, comme décrit dans Répertoires de compétences facultatifs.
Répertoires de compétences facultatifs
Pour que votre fichier SKILL.md reste concis et modulaire, vous pouvez inclure des ressources supplémentaires dans les répertoires facultatifs suivants du dossier de votre skill :
scripts/: contient le code exécutable (par exemple, Python ou Bash) que l'agent peut exécuter.references/: contient une documentation technique détaillée, des références d'API ou des guides spécifiques à un domaine.assets/: contient des ressources statiques telles que des modèles de documents, des diagrammes d'UI ou des schémas JSON.
Lorsque vous faites référence à ces fichiers dans vos instructions SKILL.md, utilisez des chemins relatifs à partir de la racine de la skill. Exemple : Run the script at scripts/cleanup.py.
Fonctionnement des compétences
Les compétences représentent une expertise à la demande. Cette structure permet à l'agent de conserver un grand nombre de capacités spécialisées sans encombrer la fenêtre de contexte immédiate du modèle.
Le modèle décide de manière autonome quand utiliser une compétence en fonction de votre demande et de la description de la compétence. Lorsqu'une compétence pertinente est identifiée, le modèle extrait de manière dynamique les instructions et les ressources complètes nécessaires pour accomplir la tâche.