Ringkasan keterampilan Android

Keahlian Android adalah petunjuk yang dioptimalkan untuk AI, untuk membantu alat dan agen AI lebih memahami dan menjalankan pola tertentu yang mengikuti praktik terbaik dan panduan tentang pengembangan Android. Contoh ini ada di repositori GitHub Android skills.

Anda dapat menggunakan skill Android untuk melakukan tugas seperti berikut:

  • Bermigrasi dari XML ke Compose
  • Upgrade ke AGP 9
  • Menyiapkan framework yang lebih baru seperti Navigation 3
  • Memodernisasi UI aplikasi Anda dengan membuatnya ditampilkan dalam layar penuh
  • Meningkatkan performa dengan mengaudit konfigurasi R8

Dengan menggunakan kemampuan Android, Anda dapat membantu LLM mendapatkan 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 keterampilan di Android Studio dan cara menggunakan Android CLI untuk menginstal keterampilan yang akan digunakan dengan agen dan alat pilihan Anda.

Manfaat utama keterampilan Android

Keterampilan Android memberikan sejumlah manfaat utama yang bertujuan untuk mempercepat alur kerja agentic Anda dalam menghasilkan kode Android berkualitas tinggi secara lebih efisien:

  • Grounding dengan pengetahuan pakar: Berikan konteks khusus Android yang lebih banyak kepada agen, sehingga mereka dapat melakukan grounding sesuai permintaan dan memperluas pengetahuan serta 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: Sertakan 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: Kemas pola pengembangan Android tim Anda ke dalam folder bersama untuk akses dan kolaborasi yang terpadu.

Menggunakan keterampilan Android

Keterampilan Android terintegrasi di Android CLI, untuk digunakan dengan agen pilihan Anda.

gemini_cli_skills_demo.gif

Android CLI

Sebaiknya instal skill Android menggunakan Android CLI, yang mempermudah penemuan, download, dan pengelolaan skill untuk agen pilihan Anda.

Android Studio

Anda dapat mendownload skill dari repositori GitHub skill Android dan mengimpornya ke project Anda di Android Studio.

Mengaktifkan skill

Agen akan otomatis mengaktifkan kemampuan yang relevan dengan tugas Anda. Untuk menggunakan keterampilan, minta agen untuk menyelesaikan tugas yang terkait dengan keterampilan tersebut, misalnya "Buat UI aplikasi saya ditampilkan di layar penuh". Agen akan otomatis menemukan dan menggunakan skill jika tersedia.

Di Android Studio, Anda juga dapat memanggil skill secara manual langsung dengan mengetik @skill-name di jendela chat.

Membuat keterampilan Anda sendiri

Anda dapat membuat keterampilan sendiri untuk mengemas dan membagikan alur kerja tim Anda. Untuk mempelajari lebih lanjut persyaratan keterampilan, lihat spesifikasi keterampilan agen.

Agen mencari keterampilan yang dimulai dari direktori .skills/ atau .agent/skills/ yang terletak di root project Anda. Untuk membuat skill kustom, ikuti langkah-langkah berikut:

  1. Buat direktori untuk skill Anda (misalnya, my-new-skill/).
  2. Buat file SKILL.md (peka huruf besar/kecil) di dalam direktori baru.

Keterampilan harus mengikuti aturan berikut:

  • Satu direktori per skill: Setiap skill harus memiliki direktori uniknya sendiri yang menyertakan file SKILL.md dan resource tambahan.
  • Penyusunan: Semua keterampilan harus berada di direktori .skills/ atau .agent/skills/ di root project. Namun, Anda dapat menggunakan subdirektori untuk mengatur dengan lebih baik (misalnya, skills/ui-flows/<skill name>/SKILL.md atau skills/testing/<skill name>/SKILL.md).
  • Cakupan: Saat ini, hanya kemampuan yang berada dalam codebase project yang didukung.

File SKILL.md menggunakan blok YAML untuk metadata dan Markdown standar untuk petunjuk.

  • name: ID unik untuk skill. Nama ini harus cocok dengan nama direktori.
  • description: Penjelasan yang jelas tentang fungsi skill dan kapan agen harus menggunakannya.
  • Isi: Isi Markdown di bawah blok YAML berisi petunjuk yang memandu perilaku agen saat skill 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.
  • Isi teks: Usahakan 10.000–20.000 karakter (~2.500–5.000 token). Jika petunjuk Anda melebihi batas ini, pertimbangkan untuk memindahkan dokumentasi mendetail ke file resource seperti yang dijelaskan dalam Direktori keterampilan opsional.

Direktori kemampuan opsional

Agar file SKILL.md Anda tetap ringkas dan modular, Anda dapat menyertakan resource tambahan di direktori opsional berikut dalam folder skill 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 skill. Misalnya: Run the script at scripts/cleanup.py.

Cara kerja keterampilan

Keterampilan mewakili keahlian on-demand. Struktur ini memungkinkan agen mempertahankan sejumlah besar kemampuan khusus tanpa mengacaukan jendela konteks langsung model.

Model secara mandiri memutuskan kapan harus menggunakan keahlian berdasarkan permintaan Anda dan deskripsi keahlian. Saat keterampilan yang relevan diidentifikasi, model akan secara dinamis menarik petunjuk dan resource lengkap yang diperlukan untuk menyelesaikan tugas.