Warp Common Skills: تدفقات وكيل تُعاد استخدامها عبر المستودعات

لمن يناسب

استخدم هذا المستودع عندما تكون لديك مجموعة قابلة لإعادة الاستخدام من تدفقات وكيل أو اصطلاحات أو إجراءات تشغيل تفيد في أكثر من مستودع وتحتاج موضعًا مشتركًا بدل الربط بمستودع واحد. يخزّن agent skills «مشتركة عبر المستودعات»، لا سكربتات خاصة بمشروع.

شرط مسبق: الوكيل الحالي يتبع الملاحظات وهو Warp. أمر التثبيت الموصى به يحمل --agent warp --global؛ لا تعِد كتابة هذا الأمر لوكيل آخر غير مسمّى. يجب أن تفيد المهارة فعلًا أكثر من مستودع؛ إن احتاجها مستودع واحد فلا تحشرها في هذه المكتبة المشتركة.

جانب التأليف: كل مهارة تملك مجلدًا واحدًا تحت .agents/skills/، والملف المطلوب هو SKILL.md مع YAML frontmatter، على الأقل name بنمط kebab-case وdescription تقول ماذا تفعل ومتى تُستخدم. لا تخترع حقولًا إلزامية أخرى.

أنهِ أول محاولة في 3 دقائق

الصفحة الرسمية:

https://github.com/warpdotdev/common-skills

التثبيت الموصى به (--global يغيّر المهارات العامة لهذا الجهاز؛ أكّد المستودع و--agent warp قبل التنفيذ):

npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global

الملاحظات لا تقول في أي مجلد يكتب npx على القرص. بعد التثبيت عد إلى Warp وانظر هل يمكن اختيار هذه common skills. لا تعامل .agents/skills/ في المستودع كمسار التثبيت على جهازك.

في المرة الأولى لا تغيّر محتوى المهارات المشتركة ولا تعمل fork. اختر مهمة قراءة فقط منخفضة المخاطر ودع Warp يقرر من description مهارة مثبّتة ما إذا كان ينبغي استخدامها.

إشارة النجاح: يظهر Warp المهارات التي ثُبّتت للتو، ويقرر المساعد الاستدعاء حسب description. إن فشل الأمر فتوقف؛ لا تحذف --agent warp ولا تبدّل إلى مثبّت لم يظهر.

حالات استخدام

الحالة 1: تثبيت كل common skills في Warp على المستوى العام. نفّذ add ... --skill '*' --agent warp --global أعلاه. --skill '*' يعني مجموعة المهارات في هذه المكتبة المشتركة. بعد التثبيت تحقق فقط أن Warp يستطيع اختيارها؛ لا تثبّت في الوقت نفسه نسخة ثانية غير مسمّاة.

الحالة 2: لاحقًا تحديث مهارات Warp المثبّتة. أمر الملاحظات:

npx skills@latest update --global --agent warp

هذا أيضًا كتابة عامة. أكّد بيئة Warp الحالية ثم نفّذ ثم انظر هل ما زالت المهارات قابلة للاختيار. إن احتاجت مهارة مشتركة استثناء مستودع، تطلب الملاحظات إضافة local companion skill صغير بدل fork المهارة المشتركة، ما لم يفد التغيير كل المستودعات. لا تعمل fork في أول تحديث.

حدود الاستخدام

المسار الرئيسي مُستدل عليه لـ Warp فقط: add وupdate يحملان --agent warp --global. لا تطبّقهما على وكلاء آخرين.

التخطيط داخل المستودع مُستدل عليه فقط كـ .agents/skills/ وname / description على SKILL.md. لا تكتب ذلك المجلد كموضع تثبيت محلي لـ npx.

فضّل نسخ المهارات التي يحتاجها المستودع فعلًا؛ الاستثناءات تستخدم local companion، لا تعمل fork باستخفاف.

الملاحظات لا تعطي نطاق لغات ولا تسعيرًا ولا أوامر تثبيت لوكلاء آخرين. أبقِ ما بلا سند مجهولًا.