الإضافات والمهارات

الإضافات

ما هي الإضافات؟

الإضافات هي وحدات TypeScript تمتد وظائف Neotask في وقت التشغيل. يمكنها إضافة قنوات رسائل جديدة وأدوات وكلاء وطرق RPC وأوامر CLI وخدمات خلفية ومهارات.

الإضافات الرسمية

قنوات الرسائل:

• Microsoft Teams وMatrix وNostr وZalo وFeishu/Lark وLINE وNextcloud Talk وMattermost وTlon وTwitch

الميزات:

• مكالمة صوتية, دعم هاتفية SIP للمكالمات الصوتية الواردة/الصادرة
• ذاكرة (LanceDB), ذاكرة طويلة الأمد مع بحث التشابه المتجهي
• MCP Native, تكامل خادم Model Context Protocol لربط الأدوات الخارجية

موفرو المصادقة:

• Google Antigravity OAuth وGemini CLI OAuth وQwen OAuth وMinimax OAuth وVS Code Copilot Proxy

إمكانيات الإضافات

يمكن للإضافات تسجيل:

• طرق RPC, طرق WebSocket مخصصة للعملاء للاستدعاء
• معالجات HTTP, نقاط نهاية HTTP مخصصة على البوابة
• أدوات الوكيل, أدوات جديدة بمخططات مكتوبة يمكن للوكلاء استدعاؤها
• أوامر CLI, أوامر سطر أوامر إضافية
• الخدمات الخلفية, عمليات طويلة الأمد تديرها البوابة
• المهارات, أدلة مهارات مجمّعة مع الإضافة
• أوامر الرد التلقائي, أوامر تنفّذ دون تدخل وكيل الذكاء الاصطناعي

أمان الإضافات

يفحص Neotask الإضافات على عدة مستويات قبل تشغيلها:

• موقّعة ومُتحقَّق منها. ينشر Neotask الحزم الموجودة في كتالوج Construct العام، وتُفحص تلقائيًا قبل الإصدار وتُوقَّع بمفتاح الإصدار الخاص بـ Neotask. قبل التثبيت، يتحقق Neotask من التوقيع باستخدام مفاتيح مضمّنة في Neotask ويتحقق من تجزئة SHA-256 للملف الذي تم تنزيله.
• لا توجد سكربتات تثبيت. تأتي حزم Construct مع اعتمادياتها مضمّنة، لذلك لا يشغّل تثبيتها أي مدير حزم أو سكربت تثبيت أبدًا. وعندما يستخدم تثبيت إضافة أخرى npm، تكون سكربتات التثبيت معطّلة.
• فحص عند التثبيت. تُفحص الإضافات المثبّتة من خارج Construct بحثًا عن تعليمات برمجية خطرة، وتمنع النتائج الحرجة التثبيت.
• ترخيص لكل إصدار. لا تُحمَّل إضافة Construct إلا ما دام حسابك يملك إذنًا ساريًا لذلك الإصدار. الإصدارات المسحوبة لا تُحمَّل.
• موافقات على إجراءات الوكيل. تُفحص استدعاءات الأدوات التي يجريها الوكيل، بما فيها الأدوات التي تضيفها الإضافات، وفق سياسة الموافقة لديك، وتنتظر الإجراءات التي تتطلب موافقتك حتى توافق عليها. وأي برنامج يريد الوكيل تثبيته خارج وصفات التثبيت المضمّنة في Neotask يعرض لك دائمًا الأمر الدقيق وينتظر موافقتك.
• صندوق حماية اختياري. يمكنك تشغيل أدوات الوكيل داخل حاوية Docker معزولة بدلًا من تشغيلها مباشرة على جهازك. صندوق الحماية معطّل افتراضيًا؛ راجع الأمان لتفعيله.

تعمل الإضافات الأصلية داخل عملية البوابة، لذا فإن الإضافة التي تثبّتها من خارج Construct هي تعليمات برمجية تختار أنت تشغيلها. استخدم plugins.allow لتحديد الإضافات المسموح بتحميلها.

المهارات

ما هي المهارات؟

المهارات هي إمكانيات معيارية تعلّم الوكلاء سير عمل جديدة. كل مهارة هي ملف markdown (SKILL.md) بتعليمات تُحقن في سياق الوكيل عند الصلة.

مواقع المهارات (ترتيب الأولوية)

1. مهارات مساحة العمل, <workspace>/skills/ (أعلى أولوية)
2. المهارات المُدارة, ~/.neotask/skills/
3. المهارات المجمّعة, مشحونة مع Neotask
4. مهارات الإضافات, مهارات معبّأة مع الإضافات المثبتة
5. أدلة إضافية, مسارات مكوّنة إضافية (أدنى أولوية)

عندما تشترك مهارات متعددة في نفس الاسم، يفوز الموقع ذو الأولوية الأعلى.

ميزات المهارات

• قابلة لاستدعاء المستخدم, تشغيل المهارات مباشرة بأوامر الشرطة المائلة (مثلاً /docker-build)
• قابلة لاستدعاء النموذج, مهارات يمكن للوكيل استدعاؤها من تلقاء نفسه عند الصلة
• إرسال الأوامر, مهارات تُعيَّن لأدوات محددة
• بوابة المتطلبات, تحمّل المهارات فقط عندما تكون متطلباتها مستوفاة (الثنائيات المطلوبة ومفاتيح الإعداد والمتغيرات البيئية والإضافات)

إنشاء المهارات

أنشئ ملف SKILL.md مع frontmatter YAML تحدد بيانات المهارة وتعليماتها:

حقول Frontmatter:

• name, معرف المهارة
• description, ما تفعله المهارة
• homepage, رابط للوثائق
• user-invocable, ما إذا كان المستخدمون يمكنهم تشغيلها مباشرة
• disable-model-invocation, منع الوكيل من استدعائها بشكل مستقل
• command-dispatch, الأداة المراد الإرسال إليها
• metadata.neotask.requires, المتطلبات المسبقة (bins وconfig وenv والإضافات)

الجسم: تعليمات Markdown تعلّم الوكيل كيفية استخدام المهارة، بما في ذلك الأمثلة والإرشادات.

كتالوج المهارات

تصفح المهارات المتاحة في كتالوج المهارات.

فئات المهارات

تغطي المهارات مجموعة واسعة من الإمكانيات: