Keahlian Android adalah petunjuk yang dioptimalkan AI, untuk membantu alat dan agen AI memahami dan menjalankan pola tertentu yang mengikuti praktik terbaik dan panduan tentang pengembangan Android dengan lebih baik. Keahlian ini ditempatkan di repositori GitHub keahlian Android.
Anda dapat menggunakan keahlian Android untuk melakukan tugas seperti berikut:
- Bermigrasi dari XML ke Compose
- Mengupgrade ke AGP 9
- Menyiapkan framework yang lebih baru seperti Navigation 3
- Memodernisasi UI aplikasi dengan membuatnya ditampilkan dalam layar penuh
- Meningkatkan performa dengan mengaudit konfigurasi R8
Dengan menggunakan keahlian Android, Anda dapat membantu LLM dengan pengetahuan dan konteks yang lebih baru tentang alur kerja Android khusus.
Keahlian Android mengikuti standar terbuka keahlian agen, sehingga kompatibel dengan alat AI apa pun yang mendukung keahlian. Halaman ini menjelaskan cara menggunakan keahlian di Android Studio dan cara menggunakan Android CLI untuk menginstal keahlian yang akan digunakan dengan agen dan alat pilihan Anda.
Manfaat utama keahlian Android
Keahlian Android memberikan sejumlah manfaat utama yang bertujuan untuk mempercepat alur kerja agen Anda agar dapat menghasilkan kode Android berkualitas tinggi dengan lebih efisien:
- Grounding dengan pengetahuan pakar: Memberikan konteks khusus Android yang lebih banyak kepada agen, melakukan grounding sesuai permintaan, dan memperluas pengetahuan dan keahlian default mereka di luar siklus pelatihan model reguler.
- Alur kerja yang dapat diulang: Memberikan petunjuk standar untuk membantu memastikan bahwa tugas multi-langkah dalam pengembangan Android dilakukan secara konsisten.
- Penggabungan resource: Menyertakan skrip, template, atau dokumentasi tambahan bersama petunjuk SKILL.md utama Anda sehingga agen memiliki semua yang diperlukan di satu tempat, sehingga tidak perlu melampirkan file secara manual untuk perintah.
- Keahlian bersama: Mengemas pola pengembangan Android tim Anda ke dalam folder bersama untuk akses dan kolaborasi terpadu.
Menggunakan keahlian Android
Keahlian Android diintegrasikan dalam Android CLI, untuk digunakan dengan agen pilihan Anda.
Android CLI
Sebaiknya instal keahlian Android menggunakan Android CLI, yang memudahkan Anda menemukan, mendownload, dan mengelola keahlian untuk agen pilihan Anda.
- Untuk melihat daftar keahlian yang tersedia, jalankan
android skills list. - Untuk menginstal keahlian, jalankan
android skills add --skill skill-name. Jika Anda sudah menginstal keahlian,skills addakan mengupdatenya ke versi terbaru.
Android Studio
Anda dapat mendownload keahlian dari repo GitHub keahlian Android dan mengimpornya ke project Anda di Android Studio.
Mengaktifkan keahlian
Agen akan otomatis mengaktifkan keahlian yang relevan dengan tugas Anda. Untuk menggunakan keahlian, minta agen untuk menyelesaikan tugas yang terkait dengan keahlian tersebut, misalnya "Buat UI aplikasi saya ditampilkan dalam layar penuh". Agen akan otomatis menemukan dan menggunakan keahlian jika tersedia.
Di Android Studio, Anda juga dapat memanggil keahlian
secara manual langsung dengan mengetik @skill-name di jendela chat.
Membuat keahlian Anda sendiri
Anda dapat membuat keahlian Anda sendiri untuk mengemas dan membagikan alur kerja tim Anda. Untuk mempelajari persyaratan keahlian lebih lanjut, lihat spesifikasi keahlian agen.
Agen akan mencari keahlian yang dimulai dari direktori .skills/ atau .agent/skills/ yang terletak di root project Anda. Untuk membuat keahlian kustom, ikuti langkah-langkah berikut:
- Buat direktori untuk keahlian Anda (misalnya,
my-new-skill/). - Buat file
SKILL.md(sensitif huruf besar/kecil) di dalam direktori baru.
Keahlian harus mengikuti aturan berikut:
- Satu direktori per keahlian: Setiap keahlian harus memiliki direktori uniknya sendiri
yang menyertakan file
SKILL.mddan resource tambahan apa pun. - Nesting: Semua keahlian harus berada di direktori
.skills/atau.agent/skills/di root project. Namun, Anda dapat menggunakan subdirektori untuk organisasi yang lebih baik (misalnya,skills/ui-flows/<skill name>/SKILL.mdatauskills/testing/<skill name>/SKILL.md). - Cakupan: Hanya keahlian yang berada dalam codebase project yang didukung.
File SKILL.md menggunakan blok YAML untuk metadata dan Markdown standar untuk petunjuk.
name: ID unik untuk keahlian. ID ini harus cocok dengan nama direktori.description: Penjelasan yang jelas tentang fungsi keahlian dan kapan agen harus menggunakannya.- Isi: Isi Markdown di bawah blok YAML berisi petunjuk yang memandu perilaku agen saat keahlian aktif.
---
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
Panduan format
- Nama: Maksimum 64 karakter (hanya huruf kecil, angka, dan tanda hubung).
- Deskripsi: Maksimum 1.024 karakter.
- Konten isi: Targetkan 10 ribu–20 ribu karakter (~2.500–5.000 token). Jika petunjuk Anda melebihi jumlah ini, pertimbangkan untuk memindahkan dokumentasi mendetail ke file resource seperti yang dijelaskan dalam Direktori keahlian opsional.
Direktori keahlian opsional
Agar file SKILL.md Anda ringkas dan modular, Anda dapat menyertakan resource tambahan di direktori opsional berikut dalam folder keahlian Anda:
scripts/: Berisi kode yang dapat dieksekusi (misalnya, Python atau Bash) yang dapat dijalankan oleh agen.references/: Berisi dokumentasi teknis mendetail, referensi API, atau panduan khusus domain.assets/: Berisi resource statis seperti template dokumen, diagram UI, atau skema JSON.
Saat merujuk ke file ini dalam petunjuk SKILL.md, gunakan jalur relatif dari root keahlian. Contoh: Run the script at scripts/cleanup.py.
Cara kerja keahlian
Keahlian mewakili keahlian sesuai permintaan. Struktur ini memungkinkan agen mempertahankan sejumlah besar kemampuan khusus tanpa mengacaukan jendela konteks langsung model.
Model secara mandiri memutuskan kapan akan menggunakan keahlian berdasarkan permintaan Anda dan deskripsi keahlian. Saat keahlian yang relevan diidentifikasi, model akan secara dinamis menarik petunjuk dan resource lengkap yang diperlukan untuk menyelesaikan tugas.