فهم الكود الذي لم تكتبه بنفسك

ما ستتعلمه

كيفية استخدام الذكاء الاصطناعي لفك تشفير أي جزء من الكود لم تكتبه بنفسك — سواء كان كوداً قديماً من مطور سابق، أو مكتبة مفتوحة المصدر، أو مقطع من Stack Overflow، أو شيء قام به زميلك — وفهم بالضبط ما يفعله.

لماذا هذا مهم

قراءة كود شخص آخر غالباً ما تكون أصعب من كتابة الكود بنفسك. بدون تعليقات، بدون سياق، وبدون معرفة نية المطور الأصلي، حتى المبرمجون ذوو الخبرة يمكن أن يقضوا ساعات في فك تشفير دالة من 30 سطراً. يمكن للذكاء الاصطناعي قراءة الكود وشرحه بلغة واضحة في ثوانٍ — محدداً ما يفعله كل قسم، ولماذا هو منظم بهذه الطريقة، وما هي حالات الحدود التي يتعامل معها (أو لا يتعامل معها).

دليل خطوة بخطوة

الخطوة 1: اطلب شرحاً بلغة واضحة

Please explain what this code does in plain English. Assume I understand basic programming concepts but am not familiar with this specific pattern or library.

[paste the code here]

الخطوة 2: قسّمه سطراً تلو الآخر (للكود المعقد)

Go through this code line by line (or block by block) and explain what each part does. Highlight anything unusual, clever, or potentially problematic.

[paste the code]

الخطوة 3: اسأل عن أجزاء محددة لا تفهمها

In the code above, I don't understand what [specific line or section] is doing. Can you explain it more clearly, and give me an analogy if it helps?

الخطوة 4: اسأل عما قد يحدث خطأ

Are there any edge cases, potential bugs, or situations where this code might behave unexpectedly? What inputs or conditions could cause it to fail?

الخطوة 5: اطلب اقتراحات لإعادة الصياغة (اختياري)

إذا كنت تحتاج إلى العمل مع الكود في المستقبل:

Is this code written in a modern, idiomatic style? Are there any improvements or simplifications you would recommend that preserve the same behaviour?

نصائح للحصول على نتائج أفضل

• أدرج اللغة والإطار العملي. "هذا Python يستخدم مكتبة pandas" أو "هذا JavaScript في مسار Next.js API" يساعد الذكاء الاصطناعي على تقديم شروحات أكثر دقة.
• قدم السياق حول مكان تشغيل الكود. "هذا يعمل عند إرسال المستخدم لنموذج" أو "هذه وظيفة خلفية مجدولة" يساعد الذكاء الاصطناعي على شرح غرض الكود بوضوح أكبر.
• اطلب ملخصاً أولاً، ثم التفاصيل. ابدأ بـ "ما الذي يفعله هذا بشكل عام؟" قبل أن تطلب تفاصيل سطراً تلو الآخر. يساعد الملخص عالي المستوى في جعل التفاصيل منطقية.

الأدوات الأفضل لهذا الغرض

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