تثبيت المهارات وإدارتها

يبيّن هذا الدليل كيف تملأ مساحة عمل بمهارات من GitHub: تضيف مستودعًا مصدرًا، وتثبّت منه المهارات التي تريدها، وتبقيها محدَّثة مع الوقت.

قبل أن تبدأ، هذا ما يلزم معرفته: مستودع المصدر غير موثوق. يكتب مالكه اسمه ووصفه وعدد نجومه. إشارة الأمان الوحيدة التي يثق بها Control Center هي حكم فحص مكافحة الفيروسات، وكل تثبيت يعبر هذا الحكم قبل أن يصل شيء إلى القرص أو إلى مطالبة وكيل. إن أردت التعليل، اقرأ قسم المهارات في نموذج الوكيل، وهذه الصفحة تبقى عند التنفيذ.

تجد المهارات في الإعدادات ← مساحة العمل ← المهارات (/workspaces/<id>/settings/workspace/skills). نطاقها مساحة العمل: ما تثبّته هنا يخص مساحة العمل هذه وحدها. للصفحة علامتان: المثبتة (المهارات المحلية، ومنها محرّر مهارة جديدة) والمصادر (كتالوجات GitHub). كلتا عمليتي الكتابة تعبران بوابة الفحص نفسها.

إضافة مستودع مهارات

1. افتح الإعدادات ← مساحة العمل ← المهارات وانتقل إلى علامة تبويب المصادر.
2. اضغط إضافة مستودع.
3. الصق عنوان مستودع على GitHub، مثل https://github.com/anthropics/skills، ثم أكّد.

يتحقق الخادم من أن المستودع موجود ومرئي ببيانات اعتماده، ثم يضيفه إلى الشريط الأيسر. لا يوجد متجر مُنتقى في الوسط: أي مستودع GitHub يصلح، فتقدير السمعة عليك. عدد النجوم قرينة، ولا يقوم مقام الضمان.

مهارات المستودع هي المجلدات التي تحتوي SKILL.md (بعمق يصل إلى ثلاثة مستويات، إضافة إلى تخطيط سوق الإضافات في Claude plugins/<plugin>/skills/<skill>، مع تخطي أشجار التبعيات والمورّدين). إن أظهرت الشبكة لاحقًا أن المستودع بلا مهارات، فالمعنى أنه لا مجلد فيه يطابق اصطلاح المهارة.

فحص مهارة قبل تثبيتها

اختر مستودعًا في الشريط، فتظهر مهاراته شبكة على اليمين، وفوقها حقل تصفية يضيّق الكتالوج بالاسم أو الوصف أو المعرّف. انقر بطاقة لفتح عرض التفاصيل. يعرض ثلاثة أشياء:

• README، يُعرَض بصيغة markdown — ملف README.md في مجلد المهارة، أو متن SKILL.md حين لا يوجد README.
• معاينة الفحص — الحكم (pass أو warn أو quarantine)، والقدرات التي يعلنها محتوى المهارة (تشغيل الصدفة، وكتابة الملفات، والوصول إلى الشبكة…)، وكل نتيجة سجّلها الماسح.
• عدد الملفات — التثبيت يكتب مجلد المهارة كاملًا، لا SKILL.md وحده.

تمسح المعاينة البايتات نفسها التي سيكتبها التثبيت، فالحكم الذي تراه هو الحكم الذي يناله التثبيت، ولا يُعاد الحكم من دونك.

تثبيت مهارة

1. افتح عرض تفاصيل المهارة.
2. اقرأ حكم الفحص. مع حكم warn أو pass، اضغط تثبيت.
3. مع حكم quarantine يبقى التثبيت معطّلًا حتى تضع علامة على أفهم المخاطرة — التثبيت على أي حال. يُسجَّل هذا التجاوز، ولا يُفترَض حصوله.

يكتب التثبيت مجلد المهارة في مساحة العمل، ويسجّل تثبيت الإيداع في skills-lock.json (مستودع المصدر، والمسار، والإيداع الذي جاءت منه، وتجزئة المحتوى)، وتصير المهارة متاحة للوكلاء في مساحة العمل. البطاقة التي تحمل الاسم مستخدم تعني أن مهارة أخرى تملك هذا الاسم محليًا — ألغِ تثبيت تلك أولًا.

تحديث المهارات مع الوقت

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

إلغاء تثبيت مهارة، وإزالة مستودع

إلغاء التثبيت (في عرض تفاصيل مهارة مثبّتة، أو حذف في علامة تبويب المثبتة) يزيل مجلد المهارة وسطر تثبيتها في القفل معًا — المهارة بعد إلغاء تثبيتها لا تخلّف شيئًا.

إزالة مستودع من الشريط تزيل الكتالوج وحده: المهارات التي ثُبِّتت منه تبقى مثبّتة ويستمر تحديثها، لأن سطر التثبيت يسجّل المستودع بالاسم لا بإحالة إلى مدخل المصدر. أعد إضافة المستودع إن أردت تصفّحه من جديد.

استدعاء مهارة

تُستدعى المهارات تحت نطاقها الخاص، فلا تتصادم مع أوامر الشرطة المائلة المضمّنة (/plan و/goal و/loop و/compact):

• /skill:<name> — مهارة مثبّتة في مساحة العمل هذه، أو مرفقة بالوكيل
• /skill:<repo>:<name> — مهارة يشحنها مستودع مُخرَج في هذه المساحة

الاسم المجرّد، إن لم يكن أمرًا مضمّنًا، يظل يُحَل في الرسائل المكتوبة قبل وجود النطاق. /skill:plan هو ما يصل إلى مهارة اسمها plan، و/plan هو الأمر المضمّن دائمًا.

مهارات على نطاق المستودع

يستطيع المستودع المُخرَج أن يشحن مهاراته في .agents/skills/ أو .agent/skills/ أو .claude/skills/ أو .opencode/skills/ أو skills/. هذه لا تُثبَّت من هذه الصفحة. لا يحمل الوكيل إلا مهارات المستودع الذي يعمل فيه الآن، وتتبدل حين ينتقل. حقل الكتابة ليس محصورًا كذلك: يصل /skill:<repo>:<name> إلى أي مستودع في المساحة.

تمر مهارات المستودع بالفحص المغلق عند الفشل نفسه (pass / warn / quarantine) قبل أن تصل بياناتها الأمامية إلى مطالبة. يُقبَل warn، ويُحجَب quarantine، بلا تجاوز للمشغّل على هذا المسار.

انظر مهارات على نطاق المستودع وأوامر الشرطة المائلة.

أدلة ذات صلة

• الدردشة مع وكيل
• إنشاء وكيل وتهيئته

مفاهيم ذات صلة

• نموذج الوكيل