"مهارات Android" هي تعليمات محسَّنة بالذكاء الاصطناعي تساعد أدوات الذكاء الاصطناعي والوكلاء على فهم وتنفيذ أنماط معيّنة تتّبع أفضل الممارسات والإرشادات المتعلّقة بتطوير تطبيقات Android. وهي موجودة في الـ مستودع مهارات Android على GitHub.
يمكنك استخدام مهارة 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-name. إذا كانت المهارة مثبّتة من قبل، سيؤدي الأمرskills addإلى تحديثها إلى أحدث إصدار.
استوديو Android
يمكنك تنزيل مهارة من مستودع مهارات Android على GitHub و استيرادها إلى مشروعك في "استوديو 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.
آلية عمل المهارات
تمثّل المهارات الخبرات عند الطلب. يسمح هذا الهيكل للوكيل بالاحتفاظ بعدد كبير من الإمكانات المتخصّصة بدون إشغال قدرة استيعاب النموذج المباشرة.
يقرّر النموذج بشكل مستقل متى يستخدم مهارة استنادًا إلى طلبك ووصف المهارة. عند تحديد مهارة ذات صلة، يجلب النموذج ديناميكيًا التعليمات والمَراجع الكاملة المطلوبة لإكمال المهمة.