شرح ملف CLAUDE.md الخاص بكارباثي: ملفٌ واحد يقف خلف البحث عن المهارات

على Google Trends، عالميًا، خلال الأيام السبعة الماضية وبتاريخ قراءة 23 أكتوبر 2026، يظهر "karpathy skills" كاستعلام صاعد ضمن البذرة "claude skills". أي شخص يتابع هذا البحث يصل إلى المكان نفسه: github.com/multica-ai/andrej-karpathy-skills، وهو مستودع أظهر 222,612 نجمة على GitHub، بحسب قراءة 23 أكتوبر 2026. لا يحتوي وصفه على كلمة skill إطلاقًا. وهو يقول: "ملف CLAUDE.md واحد لتحسين سلوك Claude Code، مستمد من ملاحظات Andrej Karpathy حول مزالق البرمجة باستخدام LLM."

الفارق بين الاستعلام والكائن ليس تفصيلًا تقنيًا صغيرًا. فالمهارة وملف CLAUDE.md آليتان مختلفتان تؤدّيان عملًا مختلفًا، وكل ادعاء تقريبًا يقدّمه الناس عن هذا المستودع إمّا يعتمد على معرفة أيّهما هو، وإمّا يفترض في صمت أنّه الآخر خطأً. الإرشادات الموجودة بالداخل ملفٌ واحد. والمستودع المحيط بذلك الملف يحمل أيضًا بيان إضافة (plugin manifest) ومجلدًا ضمن skills، وهو على الأرجح مصدر الكلمة في شريط البحث. والفصل بين التغليف والمحتوى هو أول خطوة مفيدة هنا.

الأرقام، وكلها من GitHub وقُرئت في 23 أكتوبر 2026: 222,612 نجمة، و22,321 تفرّعًا، أُنشئ في 27 يناير 2026، وآخر دفع في 20 أبريل 2026، ورخصة MIT. هذا الزوج الأخير هو المثير للاهتمام. لم يتلقَّ المستودع أي دفعة منذ نحو ستة أشهر، ومع ذلك استمر عدد النجوم في الارتفاع.

الملف هو الذي يقوم بالعمل؛ أما التغليف فيوضّح مصطلح البحث.

افتح المستودع، وستجد أن قائمة الملفات تجعل عدم التطابق واضحًا. يوجد CLAUDE.md في الجذر، وبجانبه CURSOR.md وEXAMPLES.md، ومجلد .cursor/rules الذي يحتوي على الإرشادات نفسها كقاعدة مشروع Cursor، ومجلد .claude-plugin، ودليل skills/karpathy-guidelines. مسار التثبيت الموصى به في README هو سوق الإضافات، ويصف النتيجة بأنها تجعل «المهارة متاحة عبر جميع مشاريعك».

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

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

الشكاوى التي كُتِبَ ضدها

المصدر المذكور في README هو منشور لـ Andrej Karpathy على X، ويقتبس منه README ثلاث شكاوى حول طريقة كتابة النماذج للشيفرة. يجدر قراءتها كاملة، لأن المبادئ الأربعة تقابلها تقريبًا واحدًا لواحد.

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

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

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

أربعة مبادئ، والاختبار الذي يتركه كل منها خلفه

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

فكّر قبل البرمجة

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

البساطة أولاً

القاعدة هي الحد الأدنى من الشيفرة التي تحل المشكلة، دون أي شيء تخميني: لا ميزات تتجاوز ما طُلب، ولا تجريدات لشيفرة تُستخدم مرة واحدة، ولا مرونة أو قابلية تكوين لم يطلبها أحد، ولا معالجة أخطاء لسيناريوهات مستحيلة، و"إذا كان يمكن أن تكون 200 سطر 50 سطرًا، فأعد كتابتها". الاختبار سؤال واحد — هل سيقول مهندس أول إن هذا مفرط التعقيد؟ — وهو حكم تقديري، وبصراحة كذلك.

تغييرات جراحية

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

التنفيذ الموجّه بالأهداف

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

الملف والمهارة والإضافة هي ثلاثة أشياء مختلفة

يجدر بنا أن نكون دقيقين بشأن الآلية، لأن السلوك العملي يختلف. CLAUDE.md هو ملف تعليمات للمشروع: نص يقرأه Claude Code كسياق دائم لمستودع، ويكون حاضرًا سواء طلبه أحد في هذه الجولة أم لا. المهارة عبارة عن مجلد يحتوي على SKILL.md يصف متى ينبغي استخدام القدرة، ويُحمّل عندما تتطلب المهمة ذلك وليس قبل ذلك. الإضافة عبارة عن حزمة توزيع، تُثبّت عبر سوق، ويمكنها أن تحمل مهارات وأوامر ومكونات أخرى. تتعلق هذه الفروق بموعد دخول التعليمات إلى السياق ومن يقرر، لا بالجودة.

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

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

ماذا تقيس 222,612 نجمة؟

إنها تقيس الاهتمام. وهذا ليس استهانة ولا هو بالأمر الهيّن: مستودع أُنشئ في يناير 2026 وآخر ما دُفع إليه كان في أبريل بلغ 222,612 نجمة و22,321 نسخة متفرعة بحلول 23 أكتوبر 2026، على GitHub، كما قُرئ ذلك اليوم، ما يعني أنه شُورك على نطاق واسع وتفرّع عنه أشخاص أرادوا نسخة خاصة بهم. ويُعدّ عدد النجوم مؤشرًا معقولًا على عدد الأشخاص الذين وجدوا شيئًا يستحق الحفظ.

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

ما يقدّمه README بدلًا من ذلك هو قسم بعنوان How to Know It's Working، يسرد أربعة أشياء قد تلاحظها: تغييرات غير ضرورية أقل في الفروقات، وإعادة كتابة أقل بسبب الإفراط في التعقيد، وأسئلة توضيحية تصل قبل التنفيذ لا بعد الأخطاء، وطلبات سحب نظيفة ومحدودة. هذه إشارات معقولة. وهي أيضًا بالضبط ما كنت ستكتبه لو لم تكن قد قِست شيئًا، وهي مُبلَّغ عنها ذاتيًا من أي شخص يطبّق الملف. اقرأها كقائمة تحقق تُلزِم بها الملف في مستودعك، لا كدليل على أنه نجح بالفعل.

ما تكتبه فعليًا لتثبيته

يقدّم ملف README مسارين. المسار الموصى به يعمل داخل Claude Code: أضِف السوق، ثم ثبّت الإضافة، وبعد ذلك تكون الإرشادات موجودة عبر المشاريع بدلًا من أن تكون لكل مستودع على حدة. أما المسار الثاني فهو لكل مشروع: اجلب ملف CLAUDE.md الخام إلى مستودع جديد، أو ألحقه بمستودع موجود. وهناك أيضًا قاعدة مشروع Cursor مضمّنة في المستودع، لذا تنطبق الإرشادات نفسها عند فتح المجلد في Cursor — وهو تفصيل يخبرك بأن الملف كُتب ليكون قابلًا للنقل بين الأدوات التي تقرأ ملف تعليمات على مستوى المشروع، لا مرتبطًا بمحمّل خاص ببائع واحد.

ثمة نقطة خشنة واحدة تستحق التنبيه، لأنك ستواجهها إذا اتبعت README حرفيًا. فأسماء أوامر المتجر مكتوبة بصيغة forrestchang/andrej-karpathy-skills، بينما عنوان URL للمستودع في أعلى الصفحة هو multica-ai/andrej-karpathy-skills. يظهر النصان معًا في README نفسه، الذي قُرئ في 23 أكتوبر 2026. أستطيع رؤية عدم التطابق ولا أستطيع أن أخبرك بسبب وجوده، لذا النصيحة الصادقة هي تجربة المسار الآخر إذا فشل أحد المسارين، والتعامل مع أحد النصّين على أنه قديم.

الشيء الآخر الذي يستحق الملاحظة في الصفحة الرئيسية: أن المستودع تتم صيانته بواسطة multica-ai، وأن الاقتباس الافتتاحي في README يروّج لـ Multica، «منصة مفتوحة المصدر لتشغيل وإدارة وكلاء البرمجة بمهارات قابلة لإعادة الاستخدام». هذا إفصاح مشروع، وهو أيضاً دليل على سبب ظهور التغليف بالشكل الذي هو عليه. من المرجّح أن يقدّم مشروعٌ مهتم بالمهارات القابلة لإعادة الاستخدام إرشاداته الخاصة كشيء قابل للتثبيت، وهذا هو ما تمثله الإضافة.

استخدامه دون وراثة افتراضاته

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

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

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

على طبقة أدنى، لا شيء من هذا يغيّر أي نموذج يجيب. ملف CLAUDE.md يشكّل كيفية معالجة الطلب بمجرد وصوله إلى نموذج؛ لكنه لا يقول شيئًا عن النموذج الذي يستقبله. ذلك القرار الثاني يخصّ ما يقف أمام النموذج. إحدى طرق ترتيب ذلك هي نقطة نهاية واحدة متوافقة مع OpenAI تحمل أكثر من 200 نموذج تحت مفتاح واحد، مع تجاوز فشل تلقائي عبر المزوّدين وأسعار قائمة المزوّدين تُمرَّر بهامش ربح 0%. نحن نستضيف النماذج؛ ولا نصنع Claude Code، ولا شيء في مستودعك مرئي لنا.

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