Présentation des compétences Android

Les compétences Android sont des instructions optimisées par l'IA qui 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. Elles sont hébergées dans le dépôt GitHub des compétences Android.

Vous pouvez utiliser une compétence Android pour effectuer des tâches telles que les suivantes :

• Migrer d'XML vers Compose
• Passer à AGP 9
• Configurer des frameworks plus récents, comme Navigation 3
• Moderniser l'interface utilisateur 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 des compétences agentiques. 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'experts : 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 de formation régulier du modèle.
• 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 une 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 à la CLI 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, ce 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 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 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 "Rendre l'interface utilisateur de mon application bord à bord". L'agent doit automatiquement trouver et utiliser la compétence si elle est disponible.

Dans Android Studio, vous pouvez également appeler manuellement une compétence directement en saisissant @skill-name dans la fenêtre de chat.

Créer vos propres compétences

Vous pouvez créer vos propres compétences pour regrouper et partager les workflows de votre équipe. Pour en savoir plus sur les exigences concernant les compétences, consultez la spécification des compétences agentiques.

L'agent recherche les 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 :

1. Créez un répertoire pour votre compétence (par exemple, my-new-skill/).
2. Créez un fichier SKILL.md (sensible à la casse) dans le nouveau répertoire.

Les compétences doivent respecter les règles suivantes :

• Un répertoire par compétence : chaque compétence doit avoir son propre répertoire unique qui inclut un fichier SKILL.md et 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.md ou skills/testing/<skill name>/SKILL.md).
• Champ d'application : actuellement, seules les compétences situées dans la base de code du projet sont prises en charge.

Le fichier SKILL.md utilise un bloc YAML pour les métadonnées et le Markdown standard pour les instructions.

• name : identifiant unique de la compétence. 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 concernant le 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 compétence :

• scripts/: contient du 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'interface utilisateur ou des schémas JSON.

Lorsque vous faites référence à ces fichiers dans vos instructions SKILL.md, utilisez des chemins d'accès relatifs à partir de la racine de la compétence. Par 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 requête et de la description de la compétence. Lorsqu'une compétence pertinente est identifiée, le modèle extrait dynamiquement l'ensemble des instructions et des ressources nécessaires pour effectuer la tâche.