مروری بر مهارت‌های اندروید

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

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

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

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

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

مزایای کلیدی مهارت‌های اندروید

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

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

از مهارت‌های اندروید استفاده کنید

مهارت‌های اندروید در رابط خط فرمان اندروید (Android CLI) ادغام شده‌اند تا با هر عامل دلخواه شما مورد استفاده قرار گیرند.

gemini_cli_skills_demo.gif

رابط خط فرمان اندروید

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

اندروید استودیو

شما می‌توانید یک مهارت را از مخزن مهارت‌های اندروید در گیت‌هاب دانلود کنید و آن را به پروژه خود در اندروید استودیو وارد کنید .

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

عامل به طور خودکار مهارت‌هایی را که مربوط به وظیفه شما هستند فعال می‌کند. برای استفاده از یک مهارت، از عامل بخواهید کاری را که مربوط به مهارت است انجام دهد، به عنوان مثال "رابط کاربری برنامه من را لبه به لبه کن". عامل باید به طور خودکار مهارت مورد نظر را در صورت موجود بودن پیدا کرده و از آن استفاده کند.

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

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

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

عامل (agent) به دنبال مهارت‌هایی می‌گردد که از دایرکتوری‌های .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/ : شامل کد اجرایی (مثلاً پایتون یا بش) است که عامل می‌تواند آن را اجرا کند.
  • references/ : شامل مستندات فنی دقیق، ارجاعات API یا راهنماهای خاص هر حوزه است.
  • assets/ : شامل منابع استاتیک مانند قالب‌های سند، نمودارهای رابط کاربری یا طرح‌های JSON است.

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

مهارت‌ها چگونه کار می‌کنند

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

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