Install
npx skills add mastra-ai/skillsلمن يناسب
يناسب من سيكتب تطبيقات أو وكلاء ذكاء بإطار Mastra ويريد أن يتبع مساعد البرمجة المهارات الرسمية. النص الرسمي: هذه مهارات رسمية للوكلاء الذين يستخدمون إطار Mastra. Mastra إطار لبناء تطبيقات ووكلاء ذكاء على مكدس TypeScript حديث. موقع الإطار:
https://mastra.ai/
الأنسب: من لديه أصلًا مشروع TypeScript / Mastra، أو يستعد للتطوير بالمهارة الرسمية الشاملة. المصدر يصف المحتوى بأنه «مهارة شاملة واحدة» تغطي موضوعات لاحقة بـ progressive disclosure وملفات مرجع؛ هذه الفقرة لا تسمي تلك الملفات.
قبل البدء يجب أن تستطيع تشغيل npx skills add. لا تبدّل المسار الرئيسي بمثبّت آخر غير متحقَّق.
إكمال أول محاولة في 3 دقائق
اتبع أمر التثبيت الرئيسي المعطى في المستودع فقط. أول محاولة مقابلة للقراءة فقط؛ لا تولّد وكيل إنتاج جديد بعد.
شرط مسبق: هذا الجهاز فيه npm/npx أصلًا، ولديك مشروع TypeScript لك أو كود Mastra على وشك التهيئة. لا تخترع عنوان مستودع مثال.
موضع التثبيت: نفّذ في مساحة العمل:
npx skills add mastra-ai/skills
المستودع الرسمي:
https://github.com/mastra-ai/skills
مشغّل منخفض المخاطر: بعد التثبيت اجعل المساعد يفحص بنية كود Mastra الموجودة مقابل هذه المهارة الشاملة، ويذكر فقط أي صيغ رسمية سيراجعها، دون تغيير الملفات بعد. إن بدأ ينشئ وكيلًا جديدًا أو يكتب استدعاءات شبكة فأكّد الآثار أولًا.
علامة النجاح: أُضيفت المهارة، ويناقش المساعد تطوير Mastra كـ «مهارة شاملة واحدة»، ولم تُكتب ملفات غير مؤكدة. إن لم تظهر المهارة فافحص أولًا اكتمال أمر التثبيت؛ لا تبدّل إلى اسم حزمة غير مسمّى.
حالات الاستخدام
الحالة الأولى: فحص تطوير Mastra داخل مشروع TypeScript موجود. استخدم المهارة الرسمية الشاملة. تناسب من لديه هيكل تطبيق أصلًا ويريد إكمال قدرات الوكيل حسب المهارة الرسمية. الدليل يذكر فقط progressive disclosure وملفات المرجع ولا يسمي الملفات. افحص أولًا ثم قرر هل تغيّر الكود.
الحالة الثانية: اكتشف عبر .well-known. يدعم Mastra معيار الاكتشاف ذاك أيضًا؛ أمر الزيادة الرسمي كالتالي.
npx skills add https://mastra.ai/
المستودع يقدّم المهارات عبر RFC 8615 Well-Known URI:
https://mastra.ai/.well-known/skills/
شرح المعيار:
https://github.com/cloudflare/agent-skills-discovery-rfc
تناسب من يريد اكتشاف المهارات من موقع الإطار. هذا مسار تثبيت ثانٍ؛ لا تخلطه مع الأمر الرئيسي في العملية نفسها. الدليل لا يكتب أي ملفات تُثبَّت بعد الاكتشاف.
حدود الاستخدام
أمر التثبيت الرئيسي هو npx skills add mastra-ai/skills. مسار .well-known زيادة، وليس أول محاولة افتراضية.
المصدر يصف فقط «مهارة شاملة واحدة» ولا يسمي مجلد مهارة. لا تضف مسار skills/ أو أسماء ملفات مرجع.
هذه مهارات رسمية على إطار TypeScript؛ لا خطوات تثبيت للغات أخرى ولا مجموعة مساعدين حصرية.
لا تخترع عناوين خارج وثائق الزيادة؛ خارج موقع الإطار وصفحة المستودع استخدم فقط عنوان الاكتشاف ورابط RFC من المصدر.