mastra
بناء تطبيقات الذكاء الاصطناعي مع إطار عمل Mastra
Mastra هو إطار عمل TypeScript لبناء وكلاء الذكاء الاصطناعي وسير العمل. توفر هذه المهارة استراتيجيات شاملة للبحث في التوثيق وأنماط الكود لضمان استخدامك لواجهات البرمجة الحالية وتجنب الأخطاء الشائعة.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "mastra". How do I set up a new Mastra project?
النتيجة المتوقعة:
لإعداد مشروع Mastra جديد: 1) قم بتشغيل `npm create mastra@latest` أو أنشئ يدوياً باستخدام `npm init`. 2) قم بتكوين TypeScript مع وحدات ES2022 (target: ES2022، module: ES2022، moduleResolution: bundler). 3) أضف 'type: module' إلى package.json. 4) ثبت @mastra/core. راجع references/create-mastra.md للحصول على إعدادات كاملة.
استخدام "mastra". What is the correct pattern for creating an agent with tools?
النتيجة المتوقعة:
النمط الصحيح: 1) أنشئ أداة باستخدام createTool(). 2) سجّلها في مثيل Mastra الخاص بك ضمن تكوين الأدوات. 3) مرر الأدوات إلى مُنشئ الوكيل. مثال: `const agent = new Agent({ id: 'my-agent', tools: { myTool } })`. راجع references/common-errors.md للحصول على أمثلة الكود الكاملة.
استخدام "mastra". How do I look up current Mastra API documentation?
النتيجة المتوقعة:
ترتيب الأولوية: 1) تحقق من المستندات المدمجة في node_modules/@mastra/*/dist/docs/ إذا كانت الحزم مثبتة. 2) جلب المستندات البعيدة من https://mastra.ai/llms.txt إذا كانت الحزم غير مثبتة. 3) استخدم SOURCE_MAP.json للعثور على تعريفات النوع الدقيقة. لا تعتمد أبداً على بيانات التدريب - تحقق دائماً من المستندات الحالية.
التدقيق الأمني
آمنThis is a documentation/reference skill providing guidance on the Mastra framework. All static findings are false positives: (1) Backtick patterns are markdown code block delimiters in documentation, not shell commands. (2) Hardcoded URLs are legitimate documentation links. (3) Environment variable patterns are code examples showing configuration. (4) Cryptographic references are documentation content. No actual security risks present.
الأنماط المكتشفة
درجة الجودة
ماذا يمكنك بناءه
إعداد مطور Mastra الجديد
يستخدم المطور الذي يبدأ مع Mastra هذه المهارة لفهم أولوية البحث في التوثيق (المستندات المدمجة أولاً، ثم البعيدة)، وإعداد تكوين TypeScript الصحيح، وإنشاء وكيله الأول مع الأدوات.
تصحيح أخطاء وقت التشغيل
يستخدم المطور الذي يواجه أخطاء 'الخاصية X غير موجودة على النوع Y' هذه المهارة لتحديد أن معرفته قديمة ويتعلم كيفية البحث عن واجهة البرمجة الحالية في المستندات المدمجة.
بناء سير العمل متعدد الخطوات
يستخدم المطور المتمرس هذه المهارة لفهم الفرق بين الوكلاء (ذوييين) وسير العمل (منظم)، ويتعلم النمط الصحيح لإنشاء وتنفيذ سير العمل باستخدام .commit().
جرّب هذه الموجهات
كيف أقوم بإعداد مشروع Mastra جديد وإنشاء وكيلي الأول مع أداة بسيطة؟
ما الفرق بين الوكيل وسير العمل في Mastra، ومتى يجب استخدام كل منهما؟
أحصل على أخطاء 'الخاصية X غير موجودة على النوع Y' في كود Mastra الخاص بي. كيف أجد واجهة البرمجة الصحيحة؟
كيف أقوم بإعداد الذاكرة والتخزين لوكيلي بحيث يتذكر سجل المحادثات عبر الجلسات؟
أفضل الممارسات
- تحقق دائماً من استخدام واجهة البرمجة مقابل الوثائق الحالية بدلاً من الاعتماد على بيانات التدريب
- استخدم المستندات المدمجة (node_modules) كمصدر أساسي عندما تكون الحزم مثبتة
- قم بتكوين إعدادات TypeScript ES2022 الصحيحة قبل كتابة أي كود Mastra
- استخدم threadId متسقا لمحادثات الوكيل للحفاظ على الذاكرة عبر الجلسات
تجنب
- افتراض أن بيانات التدريب حديثة - تتغير واجهات برمجة Mastra بشكل متكرر
- استخدام تكوين وحدة CommonJS بدلاً من وحدات ES2022
- نسيان استدعاء .commit() على سير العمل، مما يسبب فشل التنفيذ
- عد تسجيل الأدوات في مثيل Mastra قبل تعيينها للوكلاء