مهارات Android هي تعليمات محسّنة باستخدام الذكاء الاصطناعي، ما يساعد أدوات الذكاء الاصطناعي والوكلاء في فهم وتنفيذ أنماط محدّدة بشكل أفضل تتّبع أفضل الممارسات والإرشادات المتعلّقة بتطوير تطبيقات Android. وهي مضمّنة في مستودع GitHub لمهارات Android.
يمكنك استخدام مهارة Android لتنفيذ مهام مثل ما يلي:
- نقل البيانات من XML إلى Compose
- الترقية إلى الإصدار 9 من "مكوّن Android Gradle الإضافي"
- إعداد أُطر عمل أحدث، مثل Navigation 3
- تحديث واجهة مستخدم تطبيقك من خلال جعلها تمتد من الحافة إلى الحافة
- تحسين الأداء من خلال تدقيق إعدادات R8
باستخدام مهارات Android، يمكنك مساعدة النماذج اللغوية الكبيرة في الاستفادة من أحدث المعارف والسياقات المتعلّقة بسير عمل Android المتخصّص.
تتّبع مهارات Android المعيار المفتوح لـ مهارات الوكلاء، لذا فهي متوافقة مع أي أداة ذكاء اصطناعي تتيح استخدام المهارات. توضّح هذه الصفحة كيفية استخدام المهارات في "استوديو Android" وكيفية استخدام Android CLI لتثبيت المهارات لاستخدامها مع أي وكيل وأي أدوات من اختيارك.
المزايا الرئيسية لمهارات Android
توفّر مهارات Android عددًا من المزايا الرئيسية التي تهدف إلى تسريع سير عملك المستند إلى الوكلاء من أجل إنتاج رمز Android عالي الجودة بشكل أكثر فعالية:
- الاستفادة من المعارف المتخصّصة: يمكنك تزويد الوكلاء بسياق أكثر تحديدًا لنظام Android، ما يساعدهم في الاستفادة من المعارف المتخصّصة عند الطلب وتوسيع نطاق معرفتهم وخبرتهم التلقائية خارج دورة تدريب النموذج العادية.
- سير عمل قابل للتكرار: يمكنك توفير تعليمات عادية للمساعدة في ضمان تنفيذ المهام المتعدّدة الخطوات في تطوير تطبيقات Android بشكل متّسق.
- تجميع الموارد: يمكنك تضمين النصوص البرمجية أو النماذج أو المستندات الإضافية إلى جانب التعليمات الرئيسية في ملف SKILL.md حتى يحصل الوكيل على كل ما يحتاج إليه في مكان واحد، ما يغنيك عن إرفاق الملفات يدويًا لطلب معيّن.
- الخبرة المشترَكة: يمكنك تجميع أنماط تطوير تطبيقات Android الخاصة بفريقك في مجلدات مشترَكة للوصول إليها والتعاون فيها بشكل موحّد.
استخدام مهارات Android
تكون مهارات Android مدمَجة في Android CLI، ويمكن استخدامها مع أي وكيل من اختيارك.
Android CLI
ننصحك بتثبيت مهارة Android باستخدام الـ Android CLI، ما يسهّل اكتشاف المهارات وتنزيلها و إدارتها لأي وكيل من اختيارك.
- للاطّلاع على قائمة المهارات المتاحة، شغِّل الأمر
android skills list. - لتثبيت مهارة، شغِّل الأمر
android skills add --skill skill-name. إذا سبق لك تثبيت المهارة، سيؤدي الأمرskills addإلى تحديثها إلى أحدث إصدار.
استوديو Android
يمكنك تنزيل مهارة من مستودع GitHub لمهارات Android و استيرادها إلى مشروعك في "استوديو Android".
تفعيل مهارة
يُفعِّل الوكيل تلقائيًا المهارات ذات الصلة بمهمتك. لاستخدام مهارة، اطلب من الوكيل إكمال مهمة ذات صلة بالمهارة، مثلاً "اجعل واجهة مستخدم تطبيقي تمتد من الحافة إلى الحافة". من المفترض أن يعثر الوكيل على المهارة ويستخدمها تلقائيًا إذا كانت متاحة.
في استوديو Android، يمكنك أيضًا استدعاء مهارة
يدويًا مباشرةً عن طريق كتابة @skill-name في نافذة المحادثة.
إنشاء مهاراتك الخاصة
يمكنك إنشاء مهاراتك الخاصة لتجميع ومشاركة سير عمل فريقك. لمزيد من المعلومات عن متطلبات المهارات، اطّلِع على مواصفات مهارات الوكلاء.
يبحث الوكيل عن المهارات بدءًا من الدليلَين .skills/ أو .agent/skills/ الموجودَين في الدليل الجذري لمشروعك. لإنشاء مهارة مخصّصة، اتّبِع الخطوات التالية:
- أنشئ دليلاً لمهارتك (مثلاً
my-new-skill/). - أنشئ ملفًا
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
إرشادات التنسيق
- الاسم: 64 حرفًا بحدّ أقصى (أحرف صغيرة وأرقام وواصلات فقط)
- الوصف: 1024 حرفًا بحدّ أقصى
- محتوى النص: يجب أن يتراوح بين 10 آلاف و20 ألف حرف (من 2,500 إلى 5,000 رمز مميّز تقريبًا) إذا تجاوزت التعليمات هذا الحد، ننصحك بنقل المستندات التفصيلية إلى ملف موارد كما هو موضّح في الأدلة الاختيارية للمهارات.
الأدلة الاختيارية للمهارات
للحفاظ على ملف SKILL.md موجزًا ووحدات، يمكنك تضمين موارد إضافية في الأدلة الاختيارية التالية ضمن مجلد مهارتك:
scripts/: يحتوي على رموز قابلة للتنفيذ (مثل Python أو Bash) يمكن للوكيل تشغيلها.references/: يحتوي على مستندات فنية تفصيلية أو مَراجع واجهة برمجة التطبيقات أو أدلة خاصة بالمجال.assets/: يحتوي على موارد ثابتة، مثل نماذج المستندات أو مخططات واجهة المستخدم أو مخططات JSON.
عند الإشارة إلى هذه الملفات ضمن تعليمات SKILL.md، استخدِم المسارات النسبية من جذر المهارة. مثلاً: Run the script at scripts/cleanup.py.
آلية عمل المهارات
تمثّل المهارات الخبرة عند الطلب. يسمح هذا الهيكل للوكيل بالاحتفاظ بعدد كبير من الإمكانات المتخصّصة بدون إشغال نافذة السياق المباشر للنموذج.
يقرّر النموذج بشكل مستقل متى يستخدم مهارة استنادًا إلى طلبك ووصف المهارة. عند تحديد مهارة ذات صلة، يجلب النموذج ديناميكيًا التعليمات والموارد الكاملة المطلوبة لإكمال المهمة.