نمای کلی مهارت‌های Android

مهارت‌های Android دستورالعمل‌های بهینه‌شده با هوش مصنوعی هستند که به ابزارها و عوامل هوش مصنوعی کمک می‌کنند الگوهای خاصی را که از روال‌های مطلوب و راهنمایی‌های توسعه Android پیروی می‌کنند بهتر درک و اجرا کنند. این مهارت‌ها در مخزن GitHub مهارت‌های Android قرار دارند.

می‌توانید از مهارت Android برای انجام کارهایی مثل موارد زیر استفاده کنید:

  • انتقال از XML به Compose
  • ارتقا دادن به AGP 9
  • راه‌اندازی چارچوب‌های جدیدتر مثل Navigation 3
  • با لبه‌به‌لبه کردن واسط کاربر برنامه‌تان، آن را مدرن کنید
  • با ممیزی پیکربندی R8، عملکرد را بهبود دهید

بااستفاده از مهارت‌های Android، می‌توانید به مدل‌های زبانی بزرگ کمک کنید تا با دانش و بافت جدیدتر درباره گردش‌های کاری تخصصی Android زمینه‌سازی شوند.

مهارت‌های Android از استاندارد باز مهارت‌های عامل پیروی می‌کنند، بنابراین با هر ابزار هوش مصنوعی که از مهارت‌ها پشتیبانی می‌کند سازگار هستند. این صفحه نحوه استفاده از مهارت‌ها در Android Studio و نحوه استفاده از Android CLI برای نصب مهارت‌ها جهت استفاده با هر عامل و ابزار انتخابی شما را توضیح می‌دهد.

مزایای کلیدی مهارت‌های Android

مهارت‌های Android مزایای کلیدی متعددی را ارائه می‌دهند که هدف آن‌ها تسریع گردش کار عاملی شما برای تولید کارآمدتر کد Android با کیفیت بالا است:

  • پایه‌گذاری با دانش تخصصی: با ارائه بافت بیشتر مختص Android به عوامل، آن‌ها را براساس تقاضا پایه‌گذاری کنید و دانش و تخصص پیش‌فرض آن‌ها را فراتر از چرخه آموزش مدل معمولی گسترش دهید.
  • گردش‌های کاری تکرارپذیر: دستورالعمل‌های استانداردی ارائه دهید تا مطمئن شوید که تکالیف چندمرحله‌ای در توسعه Android به‌طور مداوم انجام می‌شوند.
  • دسته‌بندی منابع: اسکریپت‌ها، الگوها، یا اسناد اضافی را در کنار دستورالعمل‌های اصلی SKILL.md قرار دهید تا نماینده همه چیزهایی را که نیاز دارد در یک مکان داشته باشد و نیازی به پیوست کردن دستی فایل‌ها برای پیام‌واره نباشد.
  • تخصص مشترک: الگوهای توسعه Android تیمتان را در پوشه‌های مشترک بسته‌بندی کنید تا دسترسی و مشارکت یکپارچه داشته باشید.

استفاده از مهارت‌های Android

مهارت‌های Android در Android CLI ادغام شده‌اند تا با هر عاملی که انتخاب می‌کنید استفاده شوند.

gemini_cli_skills_demo.gif

Android CLI

توصیه می‌کنیم مهارت Android را بااستفاده از Android CLI نصب کنید، که کاوش، بارگیری، و مدیریت مهارت‌ها را برای هر عاملی که انتخاب می‌کنید آسان‌تر می‌کند.

  • برای دیدن فهرست مهارت‌های دردسترس، android skills list را اجرا کنید.
  • برای نصب مهارت، android skills add skill-name را اجرا کنید. اگر قبلاً مهارت را نصب کرده‌اید، skills add آن را به جدیدترین نسخه به‌روزرسانی می‌کند.

استودیو Android

می‌توانید مهارتی را از مخزن GitHub مهارت‌های Android بارگیری کنید و آن را به پروژه خود در Android Studio وارد کنید.

فعال کردن مهارت

عامل به‌طور خودکار مهارت‌هایی را که به تکلیف شما مربوط است فعال می‌کند. برای استفاده از یک مهارت، از نماینده بخواهید تکلیفی را که مربوط به آن مهارت است تکمیل کند، برای مثال «رابط کاربری برنامه‌ام را لبه‌به‌لبه کن». اگر مهارت دردسترس باشد، عامل باید به‌طور خودکار آن را پیدا کند و از آن استفاده کند.

در استودیو Android، می‌توانید با تایپ کردن @skill-name در پنجره گپ، مهارتی را به‌صورت دستی فراخوانی کنید.

مهارت‌های خودتان را بسازید

می‌توانید مهارت‌های خودتان را ایجاد کنید تا گردش‌های کاری تیمتان را بسته‌بندی و هم‌رسانی کنید. برای کسب اطلاعات بیشتر درباره الزامات مهارت، مشخصات مهارت‌های نماینده را ببینید.

عامل مهارت‌ها را از دایرکتوری‌های .skills/ یا .agent/skills/ واقع در ریشه پروژه شما جستجو می‌کند. برای ساختن مهارت سفارشی، این مراحل را دنبال کنید:

  1. فهرست راهنمایی برای مهارتتان ایجاد کنید (برای مثال، my-new-skill/).
  2. فایل SKILL.md (حروف‌حساس) را در فهرست راهنمای جدید ایجاد کنید.

مهارت‌ها باید از این قوانین پیروی کنند:

  • یک دایرکتوری برای هر مهارت: هر مهارت باید دایرکتوری منحصربه‌فرد خود را داشته باشد که شامل یک فایل SKILL.md و هرگونه منابع اضافی باشد.
  • تودرتو کردن: همه مهارت‌ها باید در فهرست راهنمای .skills/ یا .agent/skills/ در ریشه پروژه باشند. بااین‌حال، برای سازمان‌دهی بهتر می‌توانید از زیرفهرست‌های راهنما استفاده کنید (برای مثال، skills/ui-flows/<skill name>/SKILL.md یا skills/testing/<skill name>/SKILL.md).
  • محدوده: فقط مهارت‌هایی که در پایگاه کد پروژه قرار دارند پشتیبانی می‌شوند.
ساختار دایرکتوری که مکان فایل‌های مهارت را در پروژه نشان می‌دهد
ساختار فایل‌های مهارت.

فایل SKILL.md از بلوک YAML برای فراداده و از Markdown استاندارد برای دستورالعمل‌ها استفاده می‌کند.

  • ‫name: شناسه یکتای مهارت. این باید با نام دایرکتوری مطابقت داشته باشد.
  • description: توضیح واضحی درباره اینکه مهارت چه کاری انجام می‌دهد و چه زمانی نماینده باید از آن استفاده کند.
  • بدنه: بدنه Markdown زیر بلوک YAML حاوی دستورالعمل‌هایی است که رفتار نماینده را هنگام فعال بودن مهارت هدایت می‌کند.
---
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

دستورالعمل‌های قالب

  • نام: حداکثر ۶۴ نویسه (فقط حروف کوچک، اعداد، و خط تیره).
  • توضیحات: حداکثر ۱۰۲۴ نویسه.
  • محتوای اصلی: هدف‌گذاری برای ۱۰ تا ۲۰ هزار نویسه (حدود ۲۵۰۰ تا ۵۰۰۰ توکن). اگر دستورالعمل‌هایتان از این حد فراتر می‌رود، انتقال اسناد دقیق به فایل منبع را همان‌طور که در فهرست‌های راهنمای مهارت اختیاری شرح داده شده است درنظر بگیرید.

دایرکتوری‌های مهارت اختیاری

برای اینکه فایل SKILL.md شما مختصر و مدولار باشد، می‌توانید منابع اضافی را در دایرکتوری‌های اختیاری زیر در پوشه مهارت خود قرار دهید:

  • scripts/: حاوی کد اجرایی (برای مثال، Python یا Bash) است که نماینده می‌تواند اجرا کند.
  • ‫references/: حاوی اسناد فنی دقیق، مراجع میانای برنامه‌سازی کاربردی، یا راهنماهای مختص دامنه است.
  • assets/: حاوی منابع ایستا مانند الگوهای سند، نمودارهای واسط کاربر، یا طرح‌واره‌های JSON است.

هنگام ارجاع به این فایل‌ها در دستورالعمل‌های SKILL.md، از مسیرهای نسبی از ریشه مهارت استفاده کنید. برای مثال: Run the script at scripts/cleanup.py.

نحوه عملکرد مهارت‌ها

مهارت‌ها نشان‌دهنده تخصص درصورت درخواست است. این ساختار به عامل اجازه می‌دهد تعداد زیادی از قابلیت‌های تخصصی را بدون به‌هم ریختن پنجره بافت فوری مدل حفظ کند.

مدل به‌طور مستقل تصمیم می‌گیرد که چه زمانی از یک مهارت براساس درخواست شما و شرح مهارت استفاده کند. وقتی مهارت مربوطی شناسایی می‌شود، مدل به‌طور پویا دستورالعمل‌ها و منابع کامل موردنیاز برای تکمیل تکلیف را وارد می‌کند.