~$ cat ./dossiers/claude-code-agents-memory-skills.md
Claude Code: agents.md و memory.md و skills.md — كيف تعمل معًا؟
يُعد Claude Code نظاماً متقدماً يعتمد على ملفات ماركداون لتنظيم سلوك النموذج داخل المشاريع البرمجية. تتيح هذه الملفات للمطورين تحديد تعليمات المشروع والحفاظ على الذاكرة وإعادة استخدام المهارات بطريقة منظمة.
تركز هذه المقالة على التكامل بين الطبقات الثلاث الرئيسية وتقدم أمثلة عملية توضح كيفية استخدامها معاً لتحسين الإنتاجية.
دور agents.md في تعليمات المشروع
يحتوي ملف agents.md على التعليمات الأساسية التي توجه سلوك Claude داخل المشروع بأكمله. يحدد هذا الملف القواعد العامة وأهداف المشروع والأسلوب المطلوب في الردود.
يُستخدم هذا الملف كمرجع دائم يقرأه النموذج في بداية كل جلسة لضمان الالتزام بمتطلبات المشروع.
يمكن تخصيص agents.md ليشمل تفاصيل مثل هيكل المجلدات والتقنيات المستخدمة ومعايير الجودة.
memory.md للذاكرة المستمرة بين الجلسات
يوفر ملف memory.md آلية لحفظ المعلومات المهمة التي يجب تذكرها عبر جلسات متعددة. يسجل هذا الملف القرارات السابقة والمشكلات المحلولة والسياقات الخاصة بالمشروع.
يُحدث الملف تلقائياً أو يدوياً ليحافظ على استمرارية العمل دون فقدان المعلومات عند إعادة تشغيل Claude.
يساعد هذا النهج في تجنب تكرار الأخطاء وتسريع عملية التطوير في المشاريع طويلة الأمد.
skills.md للقدرات القابلة لإعادة الاستخدام
يحتوي ملف skills.md على تعريفات لمهارات محددة يمكن استدعاؤها عند الحاجة. كل مهارة تتضمن وصفاً واضحاً للمدخلات والمخرجات والخطوات المطلوبة.
تُصمم هذه المهارات لتكون قابلة للتشغيل التلقائي عند ذكر كلمات مفتاحية معينة في الطلب.
تسمح هذه الطبقة بتوسيع قدرات Claude دون تعديل التعليمات العامة في كل مرة.
كيفية دمج الطبقات الثلاث معاً
تعمل الطبقات الثلاث بشكل متسلسل حيث يقرأ agents.md أولاً لتحديد السياق العام ثم يستخدم memory.md لاسترجاع الذاكرة السابقة وأخيراً يستدعي skills.md عند الحاجة إلى مهارة محددة.
يضمن هذا التسلسل أن التعليمات العامة تظل سارية بينما تُطبق الذاكرة والمهارات بشكل ديناميكي.
يمكن للمطورين تعديل أي طبقة دون التأثير على الطبقتين الأخريين مما يوفر مرونة عالية.
أفضل الممارسات في الهيكلة وسير العمل
يُفضل الاحتفاظ بملفات agents.md و memory.md و skills.md في مجلد جذري واضح مع استخدام تعليقات داخلية لتوضيح الغرض من كل قسم.
يُنصح بمراجعة memory.md دورياً لإزالة المعلومات القديمة وتحديث skills.md عند إضافة قدرات جديدة.
يمكن دمج هذه الملفات مع أدوات مثل Git لتتبع التغييرات وضمان التوافق بين أعضاء الفريق.
أمثلة عملية على سير العمل
عند بدء جلسة جديدة يقرأ Claude ملف agents.md لفهم قواعد المشروع ثم يسترجع memory.md لمعرفة آخر حالة عمل ثم يستدعي مهارة من skills.md لتنفيذ مهمة محددة مثل إنشاء اختبارات.
في حالة اكتشاف خطأ يُحدث memory.md تلقائياً لتسجيل الحل مما يمنع تكراره في الجلسات اللاحقة.
يمكن للمطور طلب تنفيذ مهارة معينة مباشرة فيكتشف النموذج الكلمة المفتاحية ويطبق الخطوات المحددة في skills.md.
نقاط أساسية
- يحدد agents.md التعليمات العامة للمشروع ويضمن الالتزام بها في كل جلسة.
- يحافظ memory.md على الذاكرة المستمرة ويمنع فقدان السياق بين الجلسات.
- توفر skills.md مهارات قابلة لإعادة الاستخدام تُستدعى عند الحاجة.
- يؤدي دمج الطبقات الثلاث إلى سير عمل أكثر كفاءة واستمرارية.
- تساعد أفضل الممارسات في الحفاظ على هيكلة واضحة وقابلة للتطوير.
أسئلة شائعة
ما الفرق بين agents.md و skills.md؟
يحدد agents.md التعليمات العامة والقواعد الثابتة للمشروع بينما يركز skills.md على مهارات محددة قابلة للاستدعاء التلقائي. يعمل الأول كمرجع دائم والثاني كأدوات مساعدة.
كيف يتم تحديث memory.md؟
يمكن تحديث memory.md يدوياً من قبل المطور أو تلقائياً بواسطة Claude عند اكتشاف معلومات جديدة مهمة. يُفضل مراجعته دورياً للحفاظ على دقته.
هل يمكن استخدام هذه الملفات مع مشاريع متعددة؟
نعم يمكن نسخ الملفات أو تعديلها لتناسب مشاريع مختلفة مع الحفاظ على الهيكل الأساسي. يُنصح بتخصيص كل مشروع بملفات خاصة به.
ما أهمية دمج الطبقات الثلاث؟
يضمن الدمج استمرارية العمل وتجنب التكرار وتطبيق المهارات المناسبة في الوقت المناسب. يؤدي ذلك إلى تحسين جودة النتائج وتقليل الجهد اليدوي.
