استخدام skill-creator: استخدم مهارة لتصنع مهاراتك الخاصة
📚 تنقل السلسلة: المقال السابق [27 أمثلة عملية على استخدام Skills] علمك كيفية استخدام المهارات التي صممها الآخرون - كيفية تركيبها وتفعيلها واستخدامها بسلاسة. في هذا المقال، سنقوم بالعكس: سنتعلم كيفية صناعة مهاراتك الخاصة. ولن نعتمد على الكتابة اليدوية بالكامل، بل سنستعين بمهارة رسمية مخصصة لصناعة المهارات وهي مهارة
skill-creator.
يقول البعض أن ملف SKILL.md هو مجرد ملف Markdown بسيط، ويمكن كتابته يدوياً دون حاجة لأداة مساعدة، فهل نحتاج حقاً لأداة؟
بصراحة، هذا الرأي صحيح في جانبه الظاهري فقط. فكتابة الملف بسيطة فعلاً، ولكن تصميم مهارة قابلة للتفعيل والعمل بدقة أمر غاية في الصعوبة - فمعظم الأخطاء عند الكتابة اليدوية تعود لسبب واحد: كتابة حقل description بشكل غير دقيق، مما يؤدي لعجز Claude عن استدعاء المهارة وتفعيلها أبداً.
لقد واجهت هذه المشكلة في أول مهارة كتبتها يدوياً. كنت أرغب في تصميم مهارة لـ "توليد رسائل التزام (commit messages) مطابقة لمعايير الفريق"، فأنشأت المجلد وكتبت الخطوات بوضوح، وكتبت في حقل description عبارة "Commit message helper". ولكن عندما كنت أطلب من Claude رفع التعديلات، كان يتجاهل المهارة بالكامل ويكتب رسالة الالتزام بالطريقة العامة. وظننت حينها أن المشكلة في التركيب، وأضعت الكثير من الوقت في فحص /doctor وإعادة التشغيل وإعادة التركيب دون جدوى. واكتشفت لاحقاً أن المشكلة لم تكن في التركيب، بل في غياب الكلمات التي يستخدمها المستخدم في حقل الوصف. وهذه المشاكل قد تعجز عن اكتشافها بمفردك عند الكتابة اليدوية، ويجب توفر أداة تساعدك على صياغتها بشكل صحيح.
مهارة skill-creator هي الأداة التي تحتاجها.
بعد قراءة هذا المقال، ستحصل على:
- لماذا تعد الكتابة اليدوية لملف
SKILL.mdسهلة ظاهرياً وصعبة واقعياً، وما الذي تقدمه لك أداةskill-creatorلإتمام المهمة بنجاح. - دورة العمل الكاملة لصناعة المهارة عبر
skill-creator: بدء المشروع ← كتابة الاسم والوصف والخطوات عبر الحوار الموجه ← ترتيب الملفات المرجعيةreferencesوالبرمجياتscripts← التعبئة والضغط. - القسم الأهم في المقال: كيفية كتابة حقل
descriptionلضمان تفعيل المهارة بدقة (تضمين الكلمات المفتاحية وصياغتها بأسلوب مبادر ونشط). - تحديد الدليل المناسب لحفظ المهارة: مهارة شخصية (Personal) أم مهارة مشروع (Project) ومن يمكنه استخدامها.
- تطبيق عملي مباشر: استخدام
skill-creatorلإنشاء مهارة بسيطة والتحقق من عملها وتفعيلها تلقائياً.
01 الحقيقة غير المتوقعة: كتابة ملف SKILL.md سهلة، وصعوبتها تكمن في تفعيلها
دعنا نربط هذا بأساسيات المقال السابق. فقد عرفت في المقال 27 أن المهارة عبارة عن مجلد يحتوي على ملف SKILL.md كمدخل رئيسي، ويتكون من قسم YAML في الأعلى (frontmatter) لتحديد الاسم والوصف، وقسم Markdown للتعليمات والخطوات التي يتبعها Claude. ويذكر التوثيق الرسمي:
يتطلب كل مهارة وجود ملف
SKILL.mdيتكون من قسمين: قسم YAML frontmatter (بين علامتي---) يوضح لـ Claude شروط استخدام المهارة، وقسم Markdown يحتوي على التعليمات والخطوات التي يتبعها Claude عند تشغيل المهارة.
تبدو العملية بسيطة جداً، أليس كذلك؟ مجلد وملف وينتهي الأمر. ولذا يعتقد المبتدئون أن الكتابة اليدوية كافية.
ولكن الحقيقة غير المتوقعة هي: أن كتابة الملف سهلة، وصعوبته تكمن في جعل المهارة قابلة للاستدعاء والتفعيل تلقائياً عند الحاجة إليها - فمعظم المهارات المكتوبة يدوياً ينتهي بها الأمر منسية في الزاوية دون تفعيل.
تشبيه: معالج إعداد البرمجيات (Setup Wizard). عندما تقوم بتركيب برنامج جديد، تظهر لك واجهة ترشدك خطوة بخطوة وتطلب منك تحديد اسم الأداة وشروط استخدامها والمدخلات والمخرجات المطلوبة، وتقوم في الخلفية بترتيب بنية الملفات والرموز بشكل صحيح. مهارة skill-creator هي هذا المعالج في عالم المهارات: تسألك وتأخذ إجاباتك لترتب لك الملفات والحقول التي قد تغفل عنها عند الكتابة اليدوية.
يوضح الجدول التالي المشاكل الشائعة عند الكتابة اليدوية وكيفية علاجها عبر skill-creator:
| المشاكل الشائعة عند الكتابة اليدوية | ❌ الكتابة اليدوية | ✅ استخدام skill-creator |
|---|---|---|
حقل description | صياغته بشكل عام مثل "Commit helper" وغياب الكلمات المفتاحية مما يعطل التفعيل | إرشادك لصياغته بطريقة واضحة (ماذا تفعل + متى تفعل) متضمنة الكلمات الشائعة للمستخدم |
| ترتيب الملفات والمجلدات | تكديس البرمجيات والوثائق المرجعية داخل ملف SKILL.md مما يجعله طويلاً ومربكاً | عزل الوثائق في مجلد references/ والبرمجيات في scripts/ مع إبقاء الملف الرئيسي بسيطاً |
| اختبار وتجربة التفعيل | صعوبة التحقق من تفعيل المهارة وتجربتها | توليد حالات اختبار لتجربتها والتحقق من التفعيل التلقائي مباشرة |
| التحسين والتطوير | صعوبة معرفة الخطأ وتصحيحه عند توقف المهارة | توفير خيارات لتحسين الأوصاف وضبط نسب التفعيل ومستواها |
هل لاحظت الفرق؟ الأخطاء عند الكتابة اليدوية تعود لغياب المراجعة والتحقق مما نكتب. تكمن قيمة skill-creator في إرشادك وتدقيق الخطوات والملفات للتأكد من سلامتها.
💡 خلاصة سريعة: تكمن صعوبة المهارة في جعلها قابلة للتفعيل تلقائياً؛ وتعمل مهارة
skill-creatorكمعالج لإرشادك وبناء المجلدات وتدقيق الصياغات لتجنب المشاكل والأخطاء الشائعة.
02 ما هي مهارة skill-creator وكيفية تفعيلها
لنبدأ بالخلاصة: مهارة skill-creator هي مهارة متخصصة لصناعة وتعديل المهارات الأخرى. قد تبدو الفكرة غريبة ولكنها منطقية - فما دامت المهارات تهدف لتسهيل المهام وتوفير الوقت، فإن عملية "صناعة المهارة" بحد ذاتها مهمة متكررة تستحق البناء كمهارة مستقلة.
هذه المهارة ليست مدمجة افتراضياً في Claude Code، بل يجب تركيبها يدوياً - عبر وضع مجلد المهارة في مسار المهارات الشخصية ~/.claude/skills/ أو مهارات المشروع .claude/skills/ (كما شرحنا في المقال 27). ويحتوي دليل الإضافات الرسمي (claude-plugins-official) على حزمة لتطوير الملحقات تدعى plugin-dev， وتتوفر skill-creator كمهارة مستقلة يمكن نسخ مجلدها إلى مسار المهارات:
# نسخ مجلد المهارة إلى مسار المهارات الشخصية
cp -r skill-creator ~/.claude/skills/النتيجة المتوقعة: ظهور المهارة skill-creator في قائمة /skills مع وصف يوضح دورها "Create new skills, modify and improve existing skills...".
بعد التركيب، يمكنك استدعاؤها بطريقتين، كأي مهارة أخرى:
الطريقة الأولى: الاستدعاء المباشر بالاسم.
/skill-creatorالطريقة الثانية: التحدث بعبارة عادية توضح حاجتك (للتفعيل التلقائي). وهي الطريقة المفضلة - لأن وصف skill-creator مصمم بشكل ممتاز ويستجيب للعبارات المرتبطة بصناعة المهارات:
أريد إنشاء مهارة لتلخيص تعديلات git وصياغة رسالة التزام متوافقة مع المعاييروبعد استدعاء المهارة، لن تقوم بتوليد الملف فوراً، بل ستبدأ بالحوار معك كالمعالج وتطرح عليك مجموعة من الأسئلة. يوضح دليل المهارة الخطوة الأولى وهي "Capture Intent (تحديد الاحتياجات)"، وتسألك عما يلي:
- ما هي المهمة التي تريد من المهارة تنفيذها؟
- متى يجب تفعيل هذه المهارة وتطبيقها؟ (ما هي العبارات والكلمات المفتاحية التي تستخدمها)
- ما هي الصيغة والمخرجات المطلوبة بعد انتهاء المهارة؟
- هل تريد إنشاء حالات اختبار للتحقق من عمل المهارة وتجربتها؟
يرجى التركيز على السؤال الثاني - "متى يجب تفعيل المهارة". فهذا هو الفارق الجوهري عن الكتابة اليدوية: عند الكتابة اليدوية قد تتجاهل هذا السؤال وتكتب وصفاً عاماً؛ بينما تعتبره skill-creator الخطوة الأهم للبدء، لأنه غياب دقة التفعيل يعني فشل المهارة برمتها.
تشبيه: منظم الحفلات والمناسبات الذي يطرح عليك الكثير من الأسئلة قبل البدء. لن يبدأ المنظم بالعمل وتجهيز المكان دون أن يعرف تفاصيل الميزانية وعدد الحضور ونوع الحفل والترتيبات المفضلة لديك. تحديد الاحتياجات في skill-creator يمثل هذا الحوار - توضيح وتحديد المتطلبات أولاً قبل البدء بالبناء.
💡 خلاصة سريعة: مهارة
skill-creatorهي مهارة متخصصة لبناء المهارات، ويتم تركيبها في مجلد المهارات؛ وتُفعل تلقائياً بعبارات عادية أو بالاسم عبر/مباشرة، وتبدأ عملها بطرح أسئلة لتحديد الاحتياجات وشروط التفعيل.
03 مراحل العمل الكاملة التي تقودك إليها الأداة
لا تقتصر مهمة skill-creator على توليد ملف واحد فقط، بل ترافقك في كافة مراحل بناء المهارة وتجربتها. دعنا نستعرض دورة العمل التي تتبعها الأداة:
- فهم وتحديد الفكرة: الحوار معك لتحديد فكرة المهارة ومهامها (مرحلة تحديد الاحتياجات).
- كتابة النسخة الأولى: توليد ملف
SKILL.mdوكتابة الاسم والوصف والخطوات بناءً على إجاباتك. - تجهيز حالات الاختبار: توليد 2-3 عبارات واقعية وتنبيهات لاختبار المهارة ومراجعتها معك وتأكيدها.
- التشغيل والتقييم: تشغيل المهارة الفعلي بحالات الاختبار وعرض النتائج أمامك للتأكد من سلامة المخرجات والتفعيل التلقائي.
- التعديل والتحسين: تعديل المهارة وتحسين خطواتها بناءً على ملاحظاتك ونتائج الفحص، وتكرار عملية الاختبار.
- تحسين حقل الوصف (اختياري): مراجعة وتحسين كلمات حقل
descriptionلضمان دقة وسهولة التفعيل التلقائي. - الضغط والتعليب: جمع وضغط ملفات المهارة في ملف واحد بامتداد
.skillلتسهيل مشاركته وتركيبه.
تلاحظ هنا أهمية دورة العمل وتكاملها - فكتابتك اليدوية تقتصر على الخطوة الثانية فقط وتتجاهل بقية الخطوات، مما يعرض المهارة للفشل. تضمن skill-creator تكملة هذه الخطوات وخاصة الفحص والتحسين لضمان تفعيل وعمل المهارة.
دعنا نلقي نظرة على بنية المجلد التي ترتبها الأداة. يوضح التوثيق البنية المفضلة كالتالي:
my-skill/
├── SKILL.md # الملف الرئيسي للمهارة (مطلوب)
├── reference.md # وثائق مرجعية تفصيلية (تحمل عند الحاجة)
├── examples.md # أمثلة للمخرجات والنتائج (تحمل عند الحاجة)
└── scripts/
└── helper.py # برمجيات مساعدة قابلة للتشغيل بواسطة Claudeقاعدة أساسية: أبقِ ملف SKILL.md قصيراً ومختصراً، وانقل التفاصيل للخارج. ويوضح التوثيق صراحة:
يفضل إبقاء ملف
SKILL.mdأقل من 500 سطر. ونقل الوثائق والتفاصيل الطويلة لملفات مستقلة.
لماذا يوصى بذلك؟ لأن تفعيل المهارة يعني تحميل وقراءة كامل محتويات ملف SKILL.md وإرسالها مع كل طلب في المحادثة - مما يستهلك جزءاً كبيراً من نافذة السياق ويزيد من تكلفة استهلاك الرموز (tokens). بينما لا يتم تحميل محتويات مجلد scripts/ وتُقرأ وثائق references/ عند الحاجة فقط. ومن الأخطاء الشائعة عند الكتابة اليدوية كتابة وثائق واجهات البرمجة (APIs) بالكامل داخل ملف SKILL.md， مما يثقل المحادثة ويستهلك الذاكرة. ترشدك skill-creator لتوزيع الملفات بشكل صحيح - إبقاء الملف الرئيسي مختصراً، ونقل الوثائق الكبيرة لملفات مرجعية، والبرمجيات لمجلد scripts.
تشبيه: الفهرس والملاحق في الكتب. لن تكتب تفاصيل الفصول والقصص في الفهرس، بل تكتفي بكتابة عناوين الفصول وأرقام صفحاتها، وتترك التفاصيل لمتن الكتاب والملاحق في النهاية. ملف SKILL.md هو الفهرس - يوضح لـ Claude الأدوات المتاحة ومتى يقرأ الوثائق المرجعية في المجلدات الأخرى.
💡 خلاصة سريعة: ترافقك
skill-creatorفي دورة متكاملة (الفكرة ← البناء ← الفحص ← التحسين ← التعبئة)； وتضمن توزيع الملفات وعزل الوثائق في مجلدات مرجعية لإبقاء ملفSKILL.mdخفيفاً ومختصراً لتوفير الذاكرة.
04 القسم الأهم: صياغة حقل description لضمان التفعيل
إذا كنت تريد تذكر فكرة واحدة من هذا المقال، فتذكر هذه: يمثل حقل description المفتاح والمحرك الأساسي لتفعيل المهارة تلقائياً.
لماذا يعد هذا الحقل مهماً؟ لأن Claude لا يقرأ نصوص المهارة بالكامل في بداية الجلسة - بل يكتفي بقراءة قائمة تحتوي على "اسم المهارة ووصفها فقط"، ويقرر بناءً على هذا الوصف ما إذا كان يحتاج لتفعيل المهارة وتحميل ملفاتها أم لا. صياغة هذا الحقل تحدد نجاح المهارة أو فشلها. ويشير التوثيق الرسمي في خطوات الفحص أولاً إلى هذا الحقل:
تحقق من احتواء الوصف على الكلمات المفتاحية الشائعة التي تستخدمها عند الطلب.
هذا ما تسبب في فشل مهارة رسائل الالتزام التي أشرت إليها سابقاً. فقد كتبت لها وصفاً عاماً "Commit message helper" - ولم تتضمن هذه الجملة أي كلمات أستخدمها عند كتابة الطلب. فأنا أكتب عادة "ساعدني في رفع التعديلات" أو "اكتب رسالة التزام" أو "جهة commit". وعند صياغة الوصف بالاستعانة بـ skill-creator وتضمين هذه الكلمات، نجح التفعيل التلقائي بمجرد كتابة "ساعدني في رفع التعديلات".
دعنا نقارن بين الصياغة العامة والصياغة الدقيقة:
| الصياغة العامة وغير المفيدة | الصياغة الدقيقة والمقترحة من skill-creator |
|---|---|
Commit message helper | يلخص تعديلات git الحالية غير الملتزم بها وعرضها في نقاط مبسطة. ويتم تفعيله عندما يطلب المستخدم "اكتب رسالة التزام" أو "جهز commit" أو "ساعدني في رفع التعديلات" أو عند مراجعة التعديلات للرفع. |
| تقتصر على كتابة وظيفة عامة | توضح وظيفة المهارة بالتفصيل، وتحدد شروط التفعيل والكلمات الشائعة للطلب |
| تفتقد للكلمات المفتاحية وتفشل في التفعيل | تحتوي على كلمات مفتاحية واضحة وتعمل بدقة |
إليك القاعدة الذهبية للصياغة: الوصف الناجح = ما تقوم به المهارة + شروط التفعيل (مع تضمين العبارات الشائعة التي تستخدمها في المحادثة). يمثل قسم "ما تقوم به" شرحاً للوظيفة لـ Claude، ويمثل قسم "شروط التفعيل" المفتاح الحقيقي للتشغيل - ويجب كتابته بلغة طبيعية بسيطة تطابق أسلوب حديثك المعتاد في المحادثة.
هناك فكرة إضافية ترشدك إليها أداة skill-creator وهي: صياغة الوصف بأسلوب مباذر ونشط. لأن Claude يميل أحياناً لعدم تفعيل المهارات تلقائياً (undertrigger) ويفضل العمل بالطرق العامة حتى مع توفر مهارة مناسبة لمساعدته. وتوصي إرشادات skill-creator بالصياغة النشطة لمواجهة هذا السلوك:
يميل Claude أحياناً لعدم تفعيل المهارات تلقائياً حتى مع ملاءمتها للمهمة. ولمواجهة ذلك، يفضل صياغة الوصف بأسلوب نشط ومبادر.
ماذا نعني بالأسلوب النشط؟ إليك مثالاً: بدلاً من كتابة وصف عام مثل "تصميم مخططات لعرض البيانات"، صغ الوصف كالتالي: "إذا أشار المستخدم إلى مخططات، أو أشكال توضيحية، أو مؤشرات أداء، أو رغب في عرض البيانات بصورة بصرية، حتى لو لم يطلب كلمة 'مخطط' صراحة، فيجب تفعيل هذه المهارة". تحديد حالات تفعيل المهارة حتى عند غياب الطلب الصريح يساعد في تحسين نسبة رصد وتفعيل المهارة بشكل كبير.
تشبيه: لوحة المحل التجاري. إذا كتبت على اللوحة كلمة "مكتبة" فقط، فلن يعرف المارة ما تبيعه تحديداً وقد يترددون في الدخول؛ أما إذا كتبت "مكتبة القرطاسية - طباعة وتصوير - أدوات مدرسية ومكتبية"، فستجذب الزبائن وتسهل عليهم معرفة ما تقدمه مباشرة. حقل description هو اللوحة التجارية لمهارتك - يجب أن يحتوي على الكلمات التي يفكر بها الزبائن وأن يكون واضحاً ومرحباً.
💡 خلاصة سريعة: حقل
descriptionهو مفتاح التفعيل التلقائي للمهارة، والصياغة الصحيحة تعتمد على معادلة "ما تقوم به المهارة + متى تفعل (مع تضمين كلماتك الشائعة للطلب)"، وتُكتب بأسلوب نشط لتشمل الحالات غير المباشرة لضمان نجاح التفعيل.
05 أين يتم حفظ الملفات: مهارات شخصية أم مهارات مشاريع
بعد الانتهاء من بناء المهارة، أين يتم حفظها？ تحديد مكان الحفظ يحدد من يمكنه الوصول للمهارة واستخدامها. ستطرح عليك skill-creator هذا السؤال، ويجب عليك معرفة الفرق لتحديد الخيار الصحيح.
يوضح الجدول التالي الفروق بين الدليلين المتاحين للحفظ:
| نوع المهارة | دليل الحفظ | من يمكنه استخدامها |
|---|---|---|
| مهارة شخصية (Personal) | مجلد ~/.claude/skills/<skill-name>/SKILL.md | جميع مشاريعك على جهازك الحالي |
| مهارة مشروع (Project) | مجلد المشروع .claude/skills/<skill-name>/SKILL.md | هذا المشروع الحالي فقط ولجميع أعضاء الفريق |
كيف تختار؟ اسأل نفسك: هل هذه المهارة تمثل أسلوب عملك الشخصي، أم أنها قاعدة والتزام خاص بهذا المشروع؟
- المهارات الشخصية المرافقة لك في كل مكان - مثل مهارات الترجمة، أو صياغة رسائل الالتزام الخاصة بك - يتم حفظها في مسار المهارات الشخصية (
~/.claude/skills/) لتعمل في كافة مشاريعك وجلساتك تلقائياً. - المهارات المرتبطة بمتطلبات هذا المشروع تحديداً - مثل فحص معايير برمجة المشروع، أو تشغيل أوامر النشر المخصصة له - يتم حفظها في مجلد المشروع (
.claude/skills/) ويتم رفعها ومشاركتها عبر Git لتتوفر وتعمل لدى كافة أعضاء الفريق تلقائياً عند سحب الكود.
تشبيه: حقيبة أدواتك الخاصة مقابل خزانة الأدوات في الورشة. أدواتك الشخصية وسكينك المفضل تحمله معك أينما ذهبت وتستخدمه في أي مكان (المهارات الشخصية)؛ بينما الأجهزة الكبيرة والقطع المخصصة للورشة تتركها في مكانها بالورشة لتخدم هذا المكان ولتكون متاحة لجميع العاملين فيه (مهارات المشاريع). تحديد الخيار يعتمد على طبيعة الأداة ومكان عملها.
قاعدة مبسطة: المهارات العامة المشتركة تُحفظ في ~/.claude/skills/، والمهارات الخاصة بالمشاريع تُحفظ في .claude/skills/ للمستودع وتُرفع مع الكود. وتوفر مهارات المشاريع ميزة قراءة المهارات المضافة في الأدلة الأبوية، مما يتيح تفعيلها حتى عند تشغيل البرنامج من أدلة فرعية داخل المشروع، وتدعم المشاريع الكبيرة (monorepo) تفعيل مهارات فرعية مخصصة لكل جزء دون تداخل.
💡 خلاصة سريعة: تُحفظ المهارات الشخصية في
~/.claude/skills/وترافقك في جميع المشاريع؛ وتُحفظ مهارات المشاريع في.claude/skills/وتُرفع إلى git لتتوفر وتعمل لدى كافة أعضاء الفريق في هذا المشروع؛ والاختيار يعتمد على ارتباط المهارة بالشخص أو بالمشروع.
06 تطبيق عملي: بناء أول مهارة وتجربة تفعيلها
سنقوم الآن بتجربة عملية لبناء مهارة شخصية وتفعيلها باستخدام مهارة skill-creator للتحقق من مراحل العمل وصياغة الوصف واختبار التفعيل بأنفسنا.
الهدف: بناء مهارة تدعى summarize-changes تقوم بتلخيص تعديلات git غير المرفوعة وعرضها في نقاط مبسطة.
الخطوة الأولى: التحقق من توفر مهارة skill-creator
افتح جلسة Claude Code واكتب:
/skillsالنتيجة المتوقعة: ظهور المهارة skill-creator في قائمة المهارات المتاحة. وإذا لم تجدها، يرجى مراجعة خطوات التركيب الموضحة في القسم 02.
الخطوة الثانية: طلب البناء بعبارات عادية
اكتب الطلب التالي في صندوق الإدخال (مع تحديد وظيفة المهارة وشروط التفعيل لتسهيل عمل المعالج):
ساعدني باستخدام skill-creator في إنشاء مهارة جديدة.
الوظيفة: تلخيص تعديلات git الحالية غير الملتزم بها وعرضها في نقاط مبسطة.
شروط التفعيل: عندما أكتب "ما هي التعديلات الحالية" أو "ماذا عدلت" أو "لخص التعديلات".
اسم المهارة: summarize-changes.النتيجة المتوقعة: سيتم تفعيل مهارة skill-creator والبدء بالحوار معك لتأكيد البيانات، وقد يطلب منك تحديد صيغة المخرجات أو تجهيز حالات الاختبار. تفاعل مع الأسئلة، وتأكد من كتابة الكلمات المفتاحية في حقل description للمهارة الناتجة.
الخطوة الثالثة: حفظ الملف في مسار المهارات الشخصية
أكد له حفظ المهارة كمهارة شخصية في مسار ~/.claude/skills/summarize-changes/. وسيقوم بتوليد ملف SKILL.md بمحتوى مشابه للتالي:
---
name: summarize-changes
description: يلخص تعديلات git الحالية غير الملتزم بها وعرضها in نقاط مبسطة. ويتم تفعيله عندما يطلب المستخدم "ما هي التعديلات الحالية" أو "ماذا عدلت" أو "لخص التعديلات" أو عند فحص حالة مستودع git وتعديلاته.
---
## التعديلات الحالية
!`git diff HEAD`
## المهمة المطلوبة
قم بتلخيص تعديلات git الموضحة أعلاه في 2-3 نقاط مبسطة وواضحة. وإذا كانت التعديلات فارغة، فقل صراحة "لا توجد تعديلات غير ملتزم بها حالياً".تلاحظ استخدام الصيغة الديناميكية
!`git diff HEAD`: حيث يقوم Claude Code بتشغيل هذا الأمر مسبقاً واستبدال السطر بالنتائج الفعلية للتعديلات وتمريرها للمحرك، مما يضمن قراءة التعديلات الفعلية للمشروع.
الخطوة الرابعة: إجراء تعديل تجريبي في ملفات المشروع
اذهب لأي مشروع يحتوي على git (أو أنشئ مستودعاً جديداً بـ git init)، وقم بإجراء تعديل بسيط في ملف README.md مثلاً:
cd ~/some-git-project
echo "// تعديل تجريبي للاختبار" >> README.mdالنتيجة المتوقعة: عند كتابة git status ستلاحظ وجود ملف README.md معدل وغير مرفوع.
الخطوة الخامسة: اختبار وتجربة تفعيل المهارة
الاختبار الأول - التفعيل التلقائي (باللغة الطبيعية): تحدث مع Claude بعبارة عادية (دون كتابة اسم المهارة صراحة) للتحقق من تعرفه عليها وتفعيلها:
ماذا عدلت؟النتيجة المتوقعة: سيقوم Claude بمطابقة السؤال مع وصف مهارة summarize-changes ويقوم بتفعيلها تلقائياً، ويعرض لك ملخصاً بالتعديلات الحالية (مثل "إضافة تعليق تجريبي في نهاية ملف README.md"). نجاح التفعيل التلقائي يعني سلامة حقل description وقدرته على الاستجابة للطلب.
الاختبار الثاني - الاستدعاء بالاسم: إذا لم ينجح التفعيل التلقائي، جرب استدعاء المهارة بالاسم مباشرة:
/summarize-changesالنتيجة المتوقعة: سيتم تشغيل المهارة وعرض التلخيص مباشرة.
كيفية تقييم المخرجات وتصحيحها:
| النتيجة | التقييم | الإجراء المطلوب |
|---|---|---|
| نجاح التفعيل التلقائي والاستدعاء المباشر | المهارة تعمل بشكل ممتاز | انتهى العمل بنجاح |
| نجاح الاستدعاء المباشر وفشل التفعيل التلقائي | ضعف الكلمات المفتاحية في حقل description | اطلب من skill-creator تعديل وتحسين الوصف وإضافة كلمات مفتاحية أدق |
| فشل التشغيل في الطريقتين | خطأ في كتابة الملف أو مسار الحفظ | تحقق من صحة مسار المجلد وصحة كتابة اسم الملف SKILL.md بالحروف الكبيرة |
تأكد من كتابة الكلمات المفتاحية بشكل صحيح - فنجاح الاستدعاء بالاسم وفشل التفعيل التلقائي يعني أن المهارة سليمة برمجياً وأن المشكلة تكمن في صياغة حقل الوصف، وهو ما نعالجه عبر طلب تحسين الأوصاف من أداة skill-creator.
بإتمام هذه الخطوات، تكون قد مررت بمراحل بناء المهارات كاملة وتعرفت على آلية الفحص والتفعيل.
💡 خلاصة سريعة: ركز في التطبيق على أمرين - تضمين الكلمات المفتاحية في الوصف، والتحقق من التفعيل التلقائي باللغة الطبيعية؛ ويمثل فشل التفعيل التلقائي مع نجاح الاستدعاء المباشر دليلاً على وجود ضعف في حقل
descriptionويجب تحسينه.
07 ميزة إضافية: الضغط والتعبئة بصيغة .skill لمشاركتها
بعد بناء المهارة والتحقق من عملها، تتيح لك أداة skill-creator ضغط المهارة وتعبئتها في ملف واحد بامتداد .skill لتسهيل إرسالها ومشاركتها مع المطورين الآخرين وتركيبها لديهم بنقرة واحدة.
لا تحتاج لحفظ أوامر الضغط، بل تكتفي بطلب التعبئة من مهارة skill-creator مباشرة:
ساعدني في ضغط هذه المهارة وتعبئتها في ملف .skillالنتيجة المتوقعة: ستقوم الأداة بتجميع ملفات مجلد المهارة (الملف الرئيسي والبرمجيات والمراجع) وضغطها في ملف واحد باسم summarize-changes.skill وإعلامك بمسار الحفظ.
تسهل هذه الخطوة عملية مشاركة الأدوات - وتكمل موضوع المقال 27 حول تركيب المهارات الجاهزة، حيث تمثل الملفات الناتجة هنا المهارات الجاهزة التي يركبها المطورون الآخرون في جلساتهم.
💡 خلاصة سريعة: تتيح لك
skill-creatorضغط المهارة في ملف.skillلتسهيل إرسالها ومشاركتها؛ وهو ما يكمل دورة عمل المهارات الجاهزة التي يتم تركيبها وتفعيلها لدى بقية المطورين.
08 ملخص
انتقلنا في هذا المقال من مرحلة استخدام المهارات الجاهزة إلى مرحلة صناعة مهاراتنا الخاصة وتصحيحها، وركزنا على أهمية صياغة شروط التفعيل.
لنراجع النقاط الأساسية معاً:
| الهدف المطلوب | الأداة والخطوات | نقاط هامة |
|---|---|---|
| تركيب أداة صناعة المهارات | نسخ مجلد المهارة لمسار المهارات الشخصية | تتوفر كمهارة مستقلة باسم skill-creator |
| تفعيل الأداة والبدء بالعمل | كتابة /skill-creator أو شرح الطلب باللغة الطبيعية | تبدأ بالحوار معك لتحديد المتطلبات وشروط التفعيل |
| ضمان تفعيل المهارة تلقائياً | كتابة حقل description بدقة وتفصيل | الصياغة الصحيحة = ما تقوم به المهارة + شروط التفعيل بالكلمات الشائعة |
| اختيار دليل الحفظ | شخصي في ~/.claude/ أو مشروع في .claude/ | يعتمد على ارتباط المهارة بالشخص أو بمتطلبات المشروع |
| التحقق من عمل المهارة | اختبار التفعيل التلقائي والاستدعاء المباشر | فشل التفعيل التلقائي مع نجاح الاستدعاء المباشر يعني ضعف حقل الوصف |
| مشاركة المهارة وتوزيعها | ضغطها في ملف بامتداد .skill | يسهل إرسالها وتركيبها لدى المطورين الآخرين |
يمكنك الآن: فهم المشاكل الشائعة التي تعيق تفعيل المهارات المكتوبة يدوياً، واستخدام مهارة skill-creator لتوليد المهارات وتصميمها، وصياغة حقل description بأسلوب نشط ومتضمن للكلمات المفتاحية لضمان نجاح التفعيل التلقائي، وحفظ المهارات في الأدلة المناسبة ومشاركتها وضغطها لتسهيل التوزيع. هذا يمنحك المفتاح لبناء أدواتك المخصصة وتسهيل مهامك اليومية المتكررة.
صياغة شروط التفعيل والكلمات المفتاحية بدقة هي الفارق بين المهارة الفعالة والمهارة المنسية، وتكفي صياغتها بشكل صحيح لتفادي كافة المشاكل.
المقال القادم 29 "Agent Teams: العمل الجماعي للوكلاء" - قمنا حتى الآن بتفصيل عمل Claude Code كوكيل فردي يتعامل مع المحادثة بشكل مباشر. ولكن في المشاريع الكبيرة والمهام المتشعبة، قد يعجز الوكيل الفردي عن إتمام المهام بكفاءة وتزداد نافذة السياق لديه بشكل كبير. وسنطرح في المقال القادم فكرة مبتكرة: بناء وتكوين فريق عمل من وكلاء الذكاء الاصطناعي وتوزيع المهام والمسؤوليات بينهم - حيث يتولى الوكيل الرئيسي إدارة الفريق وتوجيه العمليات، بينما ينفذ الوكلاء الفرعيون المهام التخصصية بشكل معزول ومستقل بنوافذ سياق مستقلة لا تؤثر على بعضها البعض. كيف نقوم ببناء هذا الفريق وتوزيع المهام عليه؟ سنشرح ذلك بالتفصيل في المقال القادم.