نظرة عامة على مهارات Android

مهارات Android هي تعليمات محسّنة باستخدام الذكاء الاصطناعي، وهي تساعد أدوات الذكاء الاصطناعي وبرامجه في فهم وتنفيذ أنماط محدّدة تتّبع أفضل الممارسات والإرشادات المتعلّقة بتطوير تطبيقات Android. وهي متوفّرة في مستودع GitHub الخاص بمهارات Android.

يمكنك استخدام مهارة Android لتنفيذ مهام مثل ما يلي:

• نقل البيانات من XML إلى Compose
• الترقية إلى الإصدار 9 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
• إعداد أُطر أحدث، مثل Navigation 3
• تطوير واجهة مستخدم تطبيقك من خلال جعلها تغطي الشاشة بالكامل
• تحسين الأداء من خلال تدقيق إعدادات R8

باستخدام مهارات Android، يمكنك مساعدة النماذج اللغوية الكبيرة في الحصول على معلومات وسياق أحدث بشأن مهام سير عمل Android المتخصّصة.

تتّبع مهارات Android معيار مهارات الوكيل المفتوح، لذا فهي متوافقة مع أي أداة تستخدم الذكاء الاصطناعي وتتيح استخدام المهارات. توضّح هذه الصفحة كيفية استخدام المهارات في "استوديو Android" وكيفية استخدام واجهة سطر الأوامر في Android لتثبيت المهارات لاستخدامها مع أي وكيل وأدوات من اختيارك.

المزايا الرئيسية لمهارات Android

توفّر مهارات Android عددًا من المزايا الرئيسية التي تهدف إلى تسريع سير عملك الذي يعتمد على الذكاء الاصطناعي الوكيل من أجل إنتاج رمز Android عالي الجودة بكفاءة أكبر:

• الاستناد إلى معرفة الخبراء: يمكنك تزويد الوكلاء بسياق أكثر تحديدًا لنظام Android، ما يتيح لهم الاستناد إلى المعرفة عند الطلب وتوسيع نطاق معرفتهم وخبرتهم التلقائية إلى ما هو أبعد من دورة التدريب العادية للنموذج.
• سير العمل القابل للتكرار: تقديم تعليمات موحّدة للمساعدة في ضمان تنفيذ المهام المتعددة الخطوات في عملية تطوير تطبيقات Android بشكل متسق
• تجميع الموارد: يمكنك تضمين نصوص برمجية أو نماذج أو مستندات إضافية مع تعليمات SKILL.md الرئيسية حتى يتوفّر لدى الوكيل كل ما يحتاج إليه في مكان واحد، ما يغنيك عن إرفاق الملفات يدويًا لطلب ما.
• الخبرة المشتركة: يمكنك تجميع أنماط تطوير تطبيقات Android التي يستخدمها فريقك في مجلدات مشتركة لتسهيل الوصول إليها والتعاون بشأنها.

استخدام مهارات Android

تم دمج مهارات Android في واجهة سطر الأوامر لنظام Android، ويمكن استخدامها مع أي وكيل تختاره.

واجهة سطر الأوامر في Android

ننصحك بتثبيت مهارة Android باستخدام Android CLI، ما يسهّل عليك العثور على المهارات وتنزيلها وإدارتها لأي وكيل من اختيارك.

• للاطّلاع على قائمة بالمهارات المتاحة، شغِّل الأمر android skills list.
• لتثبيت مهارة، شغِّل android skills add --skill skill-name.

استوديو Android

يمكنك تنزيل مهارة من مستودع GitHub الخاص بمهارات Android واستيرادها إلى مشروعك في "استوديو Android".

تفعيل مهارة

يفعّل الوكيل تلقائيًا المهارات ذات الصلة بمهمتك. لاستخدام إحدى المهارات، اطلب من الوكيل إكمال مهمة ذات صلة بالمهارة، مثل "اجعل واجهة المستخدم لتطبيقي تغطي الشاشة بالكامل". على الوكيل العثور على المهارة واستخدامها تلقائيًا إذا كانت متاحة.

في استوديو 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

إرشادات التنسيق

• الاسم: 64 حرفًا كحدّ أقصى (أحرف صغيرة وأرقام وواصلات فقط)
• الوصف: 1024 حرفًا بحدٍ أقصى
• محتوى النص الأساسي: استهدِف عددًا يتراوح بين 10,000 و20,000 حرف (حوالي 2,500 إلى 5,000 رمز مميّز). إذا تجاوزت التعليمات هذا الحد، ننصحك بنقل المستندات التفصيلية إلى ملف موارد كما هو موضّح في أدلة المهارات الاختيارية.

أدلة المهارات الاختيارية

للحفاظ على ملف SKILL.md الخاص بك موجزًا ومقسّمًا إلى وحدات، يمكنك تضمين موارد إضافية في الدلائل الاختيارية التالية ضمن مجلد المهارة:

• ‫scripts/: يحتوي على رمز قابل للتنفيذ (مثل Python أو Bash) يمكن للوكيل تشغيله.
• references/: يحتوي على مستندات فنية تفصيلية أو مراجع لواجهة برمجة التطبيقات أو أدلة خاصة بمجال معيّن.
• assets/: يحتوي على موارد ثابتة، مثل نماذج المستندات أو مخططات واجهة المستخدم أو مخططات JSON.

عند الإشارة إلى هذه الملفات ضمن تعليمات SKILL.md، استخدِم المسارات النسبية من جذر المهارة. على سبيل المثال: Run the script at scripts/cleanup.py.

طريقة عمل المهارات

تمثّل المهارات الخبرة عند الطلب. يتيح هذا الهيكل للوكيل الحفاظ على عدد كبير من الإمكانات المتخصصة بدون تشويش قدرة استيعاب النموذج المباشرة.

يقرّر النموذج بشكل مستقل متى يستخدم مهارة معيّنة استنادًا إلى طلبك ووصف المهارة. عند تحديد مهارة ذات صلة، يستخرج النموذج بشكل ديناميكي التعليمات الكاملة والموارد المطلوبة لإكمال المهمة.