مهارات Claude Code: بناء سير عمل مخصص لمساعد البرمجة المدعوم بالذكاء الاصطناعي الخاص بك

أهم النقاط

• مهارات Claude Code هي ملفات Markdown تقوم بحقن قواعد الفريق، والاتفاقيات، وقوالب الأوامر مباشرة في سياق الوكيل (agent).
• يمكن أن تكون المهارة بسيطة كتعليمات من فقرة واحدة، أو غنية كمسار عمل (workflow) متعدد الخطوات مع أمثلة ومراجع لمتغيرات البيئة.
• تحل المهارات محل دليل الأوامر المخصصة القديم، وتمنحك طريقة موحدة لتعليم الوكيل مرة واحدة، ثم إعادة استخدامه عبر الجلسات.
• عند تثبيت مهارة على إصدار نموذج معين، تصبح تكاليف الـ token وجودة المخرجات قابلة للتنبؤ؛ قارن بين النماذج في دليل نماذج TokenLab وصفحة تسعير Anthropic قبل اختيار نموذج للإنتاج.

---

فهم مهارات Claude Code

المهارات هي ملفات Markdown نصية بسيطة توجد في .claude/skills/ داخل مشروعك (أو عالمياً في ~/.claude/skills/). عندما تستدعي مهارة، يقوم Claude Code بحقن محتوى الملف مباشرة في "مطالبة النظام" (system prompt) الخاصة به، مما يوجه الوكيل لاتباع تلك الإرشادات المحددة أولاً.

هذا الحقن يعني أنك تتحكم في سلوك الوكيل بدقة. يمكن لملف المهارة سرد الأنماط المحظورة، أو المكتبات المطلوبة، أو تنسيقات المخرجات، أو قائمة مراجعة معمارية كاملة. ولأن التعليمات تخضع للتحكم في الإصدار (version-controlled) جنباً إلى جنب مع الكود الخاص بك، يحصل كل عضو في الفريق تلقائياً على نفس مجموعة الضوابط.

السيناريوهات الشائعة التي تستفيد من مهارة مخصصة تشمل:

• فرض أنواع TypeScript صارمة بدلاً من الكائنات العامة.
• توحيد أشكال استجابات الـ API.
• أتمتة إنشاء ترحيلات قاعدة البيانات (database migrations).
• تشغيل مجموعات الاختبار (test suites) قبل رفع الكود.

من خلال تحديد مسارات العمل هذه كمهارات، فإنك تمنع الوكيل من هلوسة الأوامر أو استخدام مكتبات قديمة. هذا مفيد بشكل خاص عند العمل مع نماذج برمجة متقدمة. إذا كنت تختار بين نماذج لغوية كبيرة (LLMs) مختلفة لخط إنتاج التطوير الخاص بك، يمكنك قراءة دليلنا حول أفضل نماذج الذكاء الاصطناعي للبرمجة في عام 2026 لمعرفة كيفية مقارنة Claude Sonnet 5 ببدائل مثل Kimi K2.7 Code أو DeepSeek V4 Pro.

---

كيفية بناء مهارة مخصصة

إنشاء مهارة أمر مباشر. أنت تكتب ملف Markdown، وتحفظه في الدليل الصحيح، ثم تشير إليه أثناء جلسة Claude Code الخاصة بك. دعنا نستعرض عملية بناء مهارة تفرض بنية برمجية نظيفة وتشغل مجموعات الاختبار.

أولاً، أنشئ الدليل المحلي في جذر مشروعك:

mkdir -p .claude/skills

بعد ذلك، أنشئ ملفاً باسم verify-and-test.md داخل ذلك الدليل. سيوجه هذا الملف Claude Sonnet 5 لمراجعة قاعدة الكود، وكتابة اختبار وحدة (unit test) باستخدام Vitest، وتشغيل مجموعة الاختبار للتحقق من التغييرات.

# مهارة التحقق والاختبار (Verify and Test Skill)

أنت مهندس برمجيات خبير. مهمتك هي مراجعة تغييرات الكود، وكتابة اختبار وحدة شامل، وتشغيل مجموعة الاختبار.

## التعليمات

1. مراجعة الكود: تحليل الملفات المعدلة. تأكد من أنها لا تستخدم APIs مهجورة.
2. كتابة اختبار الوحدة: إنشاء ملف اختبار في دليل `tests/`. استخدم Vitest.
3. تشغيل الاختبارات: تنفيذ `npm run test` للتحقق من اجتياز جميع الاختبارات.
4. التقرير: تقديم ملخص لنتائج الاختبار وأي مشكلات تم العثور عليها.

## أمثلة

إذا طلب منك المستخدم التحقق من دالة مساعدة جديدة:
- ابحث عن `src/utils/math.ts`.
- أنشئ `tests/math.test.ts`.
- قم بتشغيل `npm run test`.

بمجرد حفظ هذا الملف، يكتشفه Claude Code تلقائياً. يمكنك استدعاؤه بطلب "run the verify-and-test skill on the latest changes" من الوكيل أو بالإشارة إلى اسم المهارة مباشرة في مطالبتك.

لفهم كيفية تعامل النماذج المختلفة مع مسارات العمل الوكيلة المعقدة ومتعددة الخطوات هذه، يمكنك الاطلاع على مقارنة OpenRouter الخاصة بنا لتقييم زمن الاستجابة والموثوقية عبر مزودي الـ API المختلفين.

---

إدارة تكاليف الـ Token واختيار النموذج

عند تشغيل Claude Code، تضيف كل مهارة تحقنها إلى عدد الـ tokens المدخلة. ولأن المهارات تُلحق بمطالبة النظام، فإن ملفات المهارات الطويلة التي تحتوي على أمثلة واسعة النطاق يمكن أن تزيد من فاتورة الـ API الخاصة بك بسرعة.

وفقاً لصفحة تسعير Anthropic (تمت ملاحظتها في 2026-07-07)، فإن الـ tokens المدخلة والـ tokens المخرجة لها هياكل تكلفة مختلفة. على سبيل المثال، لدى Claude Sonnet 5 معدل محدد لكل مليون token مدخل ومعدل أعلى لكل مليون token مخرج. إذا قمت بتشغيل مهارة في كل مطالبة، فستتراكم تلك الـ tokens المدخلة.

للحفاظ على تكاليف التطوير الخاصة بك تحت السيطرة، ضع في اعتبارك هذه الاستراتيجيات:

• اجعل المهارات موجزة: تجنب إضافة قواعد كود ضخمة كأمثلة داخل ملف المهارة. استخدم مقتطفات قصيرة ومعبرة بدلاً من ذلك.
• استخدم المهارات العالمية مقابل المحلية: احتفظ بالقواعد الخاصة بالمشروع في .claude/skills/ والتفضيلات العامة في ~/.claude/skills/ لتجنب ازدحام سياقك.
• قارن النماذج البديلة: بينما يعد Claude Sonnet 5 ممتازاً لمهام البرمجة المعقدة، قد ترغب في توجيه المهام الأبسط إلى نماذج أقل تكلفة. يمكنك مراجعة دليل مقارنة الأسعار لمعرفة كيف يسعر المزودون المختلفون الـ tokens المدخلة والمخرجة لديهم.

---

أفضل الممارسات لمهارات Claude Code

لتحقيق أقصى استفادة من مسارات العمل المخصصة الخاصة بك، اتبع هذه الإرشادات العملية.

الممارسة	الوصف	الفائدة
التحكم في الإصدار	قم برفع .claude/skills/ إلى مستودع Git الخاص بك.	يضمن أن الفريق بأكمله يستخدم نفس معايير البرمجة.
تحديد المدخلات	حدد المتغيرات أو الملفات التي تتوقعها المهارة.	يقلل من الغموض ويمنع الوكيل من التخمين.
تقديم أمثلة سلبية	قم بتضمين أقسام "ما لا يجب فعله" في ملف Markdown الخاص بك.	يمنع النموذج من تكرار الأخطاء الشائعة السابقة.
اختبار التغييرات التدريجية	قم بتشغيل المهارة على تغييرات كود صغيرة أولاً.	يجعل تصحيح تعليمات المهارة أسهل بكثير.

عند كتابة المهارات، تعامل معها ككود. إذا فشلت المهارة في إنتاج المخرجات المطلوبة، قم بتحسين المطالبة، أو أضف أمثلة أوضح، أو قيد نطاق التعليمات. إذا كان مسار عملك يتطلب إنشاء أصول تتجاوز الكود، مثل نماذج واجهة المستخدم (UI mockups) أو الوسائط الترويجية، يمكنك استكشاف أفضل API لنماذج صور الذكاء الاصطناعي في 2026 أو أفضل API لنماذج فيديو الذكاء الاصطناعي في 2026 للعثور على الـ APIs المناسبة لتلك المهام.

---

الأسئلة الشائعة

أين يجب أن أخزن مهارات Claude Code الخاصة بي؟

يمكنك تخزينها محلياً في جذر مشروعك في .claude/skills/ للقواعد الخاصة بالمشروع، أو عالمياً في ~/.claude/skills/ للقواعد التي تريد تطبيقها عبر جميع مشاريعك على جهازك.

هل يمكنني استخدام نماذج أخرى مع Claude Code؟

تم تصميم Claude Code بواسطة Anthropic بشكل أساسي لنماذجها الخاصة، مثل Claude Sonnet 5. ومع ذلك، يمكنك مقارنة قدرات وأسعار النماذج المختلفة في دليل نماذج TokenLab لمعرفة كيفية أدائها في معايير البرمجة.

كيف يمكنني تعطيل مهارة أثناء الجلسة؟

إذا كنت لا تريد أن يستخدم Claude Code مهارة معينة، يمكنك نقل ملف Markdown خارج دليل .claude/skills/ أو إعادة تسمية امتداد الملف حتى لا يتعرف عليه الوكيل كمهارة نشطة.

---

ابدأ مع TokenLab

هل أنت مستعد لتحسين مسار عمل تطوير الذكاء الاصطناعي الخاص بك؟ العثور على النموذج المناسب بأفضل نسبة سعر إلى أداء أمر بالغ الأهمية لتوسيع نطاق تطبيقاتك. استكشف فئة نماذج البرمجة في TokenLab لمقارنة أحدث النماذج، وتحليل تسعير الـ tokens، والعثور على الـ LLM المثالي لوكلاء البرمجة الخاصين بك.