Le skill Android sono istruzioni ottimizzate per l'AI che aiutano gli strumenti e gli agenti di AI a comprendere ed eseguire meglio pattern specifici che seguono le best practice e le linee guida per lo sviluppo di Android. Sono ospitate nel repository GitHub delle skill Android.
Puoi utilizzare una skill Android per eseguire attività come le seguenti:
- Eseguire la migrazione da XML a Compose
- Eseguire l'upgrade ad AGP 9
- Configurare framework più recenti come Navigation 3
- Modernizzare l'interfaccia utente dell'app rendendola edge-to-edge
- Migliorare il rendimento eseguendo l'audit della configurazione di R8
Utilizzando le skill Android, puoi aiutare a basare gli LLM su conoscenze e contesti più recenti relativi ai flussi di lavoro Android specializzati.
Le skill Android seguono lo standard aperto delle skill degli agenti, quindi sono compatibili con qualsiasi strumento di AI che supporti le skill. Questa pagina spiega come utilizzare le skill in Android Studio e come utilizzare l' interfaccia a riga di comando Android per installare le skill da utilizzare con qualsiasi agente e strumento di tua scelta.
Vantaggi principali delle skill Android
Le skill Android offrono una serie di vantaggi chiave che mirano ad accelerare il flusso di lavoro degli agenti per produrre in modo più efficiente codice Android di alta qualità:
- Basare le skill su conoscenze di esperti: fornisci agli agenti un contesto più specifico per Android, basandoli on demand ed estendendo le loro conoscenze ed expertise predefinite oltre il normale ciclo di addestramento del modello.
- Flussi di lavoro ripetibili: fornisci istruzioni standard per garantire che le attività in più passaggi nello sviluppo di Android vengano eseguite in modo coerente.
- Raggruppamento delle risorse: includi script, modelli o documentazione aggiuntiva insieme alle istruzioni principali di SKILL.md in modo che l'agente abbia tutto ciò di cui ha bisogno in un unico posto, evitando la necessità di allegare manualmente i file per un prompt.
- Expertise condivisa: raggruppa i pattern di sviluppo di Android del tuo team in cartelle condivise per un accesso e una collaborazione unificati.
Utilizzare le skill Android
Le skill Android sono integrate nell'interfaccia a riga di comando Android e possono essere utilizzate con qualsiasi agente di tua scelta.
Interfaccia a riga di comando Android
Ti consigliamo di installare una skill Android utilizzando l' interfaccia a riga di comando Android, che semplifica l'individuazione, il download, e la gestione delle skill per qualsiasi agente di tua scelta.
- Per visualizzare l'elenco delle skill disponibili, esegui
android skills list. - Per installare una skill, esegui
android skills add --skill skill-name.
Android Studio
Puoi scaricare una skill dal repository GitHub delle skill Android e importarla nel tuo progetto in Android Studio.
Attivare una skill
L'agente attiva automaticamente le skill pertinenti alla tua attività. Per utilizzare una skill, chiedi all'agente di completare un'attività correlata alla skill, ad esempio "Make my app UI edge-to-edge". L'agente dovrebbe trovare e utilizzare automaticamente la skill, se disponibile.
In Android Studio, puoi anche richiamare una skill
manualmente digitando direttamente @skill-name nella finestra di chat.
Creare le proprie skill
Puoi creare le tue skill per raggruppare e condividere i flussi di lavoro del tuo team. Per saperne di più sui requisiti delle skill, consulta le specifiche delle skill degli agenti.
L'agente cerca le skill a partire dalle directory .skills/ o .agent/skills/ che si trovano nella root del progetto. Per creare una skill personalizzata:
- Crea una directory per la skill (ad esempio
my-new-skill/). - Crea un file
SKILL.md(con distinzione tra maiuscole e minuscole) all'interno della nuova directory.
Le skill devono rispettare queste regole:
- Una directory per skill: ogni skill deve avere la propria directory univoca
che include un file
SKILL.mde qualsiasi risorsa aggiuntiva. - Nesting: tutte le skill devono trovarsi nella directory
.skills/o.agent/skills/nella root del progetto. Tuttavia, puoi utilizzare le sottodirectory per una migliore organizzazione (ad esempioskills/ui-flows/<skill name>/SKILL.mdoskills/testing/<skill name>/SKILL.md). - Ambito: sono supportate solo le skill che si trovano all'interno della codebase del progetto.
Il file SKILL.md utilizza un blocco YAML per i metadati e Markdown standard per le istruzioni.
name: un identificatore univoco per la skill. Deve corrispondere al nome della directory.description: una spiegazione chiara di cosa fa la skill e quando l'agente deve utilizzarla.- Corpo: il corpo Markdown sotto il blocco YAML contiene le istruzioni che guidano il comportamento dell'agente quando la skill è attiva.
---
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
Linee guida sul formato
- Nome: massimo 64 caratteri (solo lettere minuscole, numeri e trattini).
- Descrizione: massimo 1024 caratteri.
- Contenuto del corpo: punta a 10.000-20.000 caratteri (~2500-5000 token). Se le istruzioni superano questo limite, valuta la possibilità di spostare la documentazione dettagliata in un file di risorse come descritto in Directory delle skill facoltative.
Directory delle skill facoltative
Per mantenere il file SKILL.md conciso e modulare, puoi includere risorse aggiuntive nelle seguenti directory facoltative all'interno della cartella della skill:
scripts/: contiene codice eseguibile (ad esempio Python o Bash) che l'agente può eseguire.references/: contiene documentazione tecnica dettagliata, riferimenti API o guide specifiche per il dominio.assets/: contiene risorse statiche come modelli di documenti, diagrammi dell'interfaccia utente o schemi JSON.
Quando fai riferimento a questi file nelle istruzioni SKILL.md, utilizza i percorsi relativi dalla root della skill. Ad esempio: Run the script at scripts/cleanup.py.
Come funzionano le skill
Le skill rappresentano competenze on demand. Questa struttura consente all'agente di mantenere un numero elevato di funzionalità specializzate senza ingombrare la finestra contestuale immediata del modello.
Il modello decide autonomamente quando utilizzare una skill in base alla tua richiesta e alla descrizione della skill. Quando viene identificata una skill pertinente, il modello recupera dinamicamente le istruzioni e le risorse complete necessarie per completare l'attività.