المهارات

دليل Karpathy: ملف CLAUDE.md واحد يجعل Claude Code حذرًا قبل تعديل الشيفرة

مناسب لمن يريد تقليل مطبات الترميز الشائعة في Claude Code، لكن الدليل يميل إلى الحذر لا السرعة، فلا حاجة لمسار كامل من أجل خطأ إملائي أو تعديل سطر واحد.

Official source · andrej-karpathy-skills

Install

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

لمن يناسب

إذا كنت تعدّل المستودعات أساسًا داخل Claude Code وتريد أن يقع أقل في مطبات الترميز الشائعة لنماذج اللغة، فهذه المادة أنسب. هو ملف CLAUDE.md لتحسين سلوك Claude Code، ومصدره ملاحظات Andrej Karpathy عن مطبات ترميز نماذج اللغة:

https://x.com/karpathy/status/2015883857489522876

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

أول محاولة في 3 دقائق

التثبيت الرسمي الموصى به خطوتان متتاليتان؛ إن نقصت واحدة فالتثبيت غير مكتمل. نفّذ أولًا داخل Claude Code:

/plugin marketplace add forrestchang/andrej-karpathy-skills

ثم ثبّت الإضافة فورًا:

/plugin install andrej-karpathy-skills@karpathy-skills

هذا يغيّر إعداد إضافات Claude Code، وليس معاينة للقراءة فقط. قبل التنفيذ تأكد أنك في بيئة Claude Code التي تريد الكتابة إليها، وأكمل الخطوتين. لا تضف marketplace دون install.

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

حالات الاستخدام

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

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

حدود الاستخدام

هذا CLAUDE.md لـ Claude Code، وليس حزمة قواعد لمحررات عامة. الصفحة لا تكتب خطوات لإعادة تسميته لمنتجات أخرى. المبادئ الأربعة في الملف نفسه، لكن النص المتاح من الصفحة يتوقف عند «هناك أربعة، وهي تقابل هذه المشكلات» دون قائمة مبادئ. لا تُكمل الأسماء، ولا تتظاهر بأنك اقتبست الجمل الأصلية من الملف.

التثبيت الموصى به هو marketplace add أعلاه ثم plugin install. نفّذ الخطوتين. لا تضع مثبّتًا آخر إلى جانبهما. ملاحظات المصدر في منشور Karpathy؛ الدليل نفسه استعمال مشتق ولا يغني عن سياق ذلك المنشور.

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