قراءة التعليمات البرمجية وشرحها والتوافق مع قاعدة التعليمات البرمجية الجديدة

المكاسب:

• القدرة على تعيين طبقة أساسية للكود الأجنبي حسب الطبقة باستخدام الذكاء الاصطناعي وتتبع الميزة من البداية إلى النهاية
• القدرة على شرح الوظائف المعقدة خطوة بخطوة ومراقبة تدفق البيانات
• القدرة على عرض وصف الذكاء الاصطناعي كفرضية والتحقق من المطالبات الهامة في التعليمات البرمجية

يقرأ المطورون التعليمات البرمجية بدلاً من كتابة التعليمات البرمجية. عندما تبدأ وظيفة جديدة، أو تتولى خدمة تركها شخص آخر، أو تساهم في مكتبة مفتوحة المصدر، فإن مهمتك الأولى هي "ما الذي يحدث هنا؟" هو العثور على إجابة لهذا السؤال. يمكن للذكاء الاصطناعي اختصار مهمة الاكتشاف هذه إلى ساعات بدلاً من أسابيع، ولكن فقط عند استخدامها مع الأسئلة الصحيحة وردود التحقق.

في هذه الوحدة، نتعلم استخدام الذكاء الاصطناعي مثل "دليل التعليمات البرمجية": رسم خريطة لقاعدة تعليمات برمجية أجنبية، وترجمة وظيفة معقدة إلى لغة بسيطة، ومتابعة تدفق البيانات، ومعرفة كيفية استخدام المكتبة. القاعدة الذهبية هنا هي أن تفسير الذكاء الاصطناعي هو مجرد فرضية؛ يمكنك التحقق من ذلك باستخدام الكود نفسه.

لماذا يعد التعليق التوضيحي للكود قويًا ولكنه محفوف بالمخاطر؟

يعد LLM جيدًا جدًا في قراءة جزء من التعليمات البرمجية وترجمته إلى لغة بشرية، مثل "هذه الوظيفة تقوم بتحديث الرمز المميز لجلسة المستخدم"؛ لأنها تعلمت أنماطًا من ملايين الأمثلة المشابهة. يعد هذا توفيرًا كبيرًا للوقت، خاصة مع الوظائف الطويلة والمتداخلة.

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

تحذير: لا تعتبر ملخص الذكاء الاصطناعي "هذا الرمز يفعل X" كدليل وحده في قرار يتعلق بالأمن أو تدفق الأموال. الملخص عبارة عن خريطة توضح المكان الذي يجب البحث فيه؛ أنت تعطي التأكيد في الكود.

خطوات تعيين قاعدة التعليمات البرمجية الأجنبية

1. ابدأ بالمستوى الأعلى. أولاً، تعرف على بنية المجلد ونقاط الإدخال (الرئيسية، تشغيل التطبيق، جهاز التوجيه المنزلي). اسأل الذكاء الاصطناعي "ما هي طبقات التطبيق بناءً على بنية الدليل هذه؟" بسأل.
2. تتبع الميزة من البداية إلى النهاية. "ما هي الملفات التي يتم تنشيطها وبأي ترتيب عندما يقوم المستخدم بتسجيل الدخول؟" - إن مشاهدة تدفق واحد أكثر إفادة من قراءة البنية بأكملها.
3. توطين المصطلحات. اسأل الذكاء الاصطناعي عن المفاهيم الخاصة بالمشروع ("المستأجر"، "دفتر الأستاذ"، "مدير الوظيفة") وابحث عن ما يعادلها في الكود.
4. لقد قمت بتبسيط الوظيفة المعقدة. احصل على شرح طويل للوظيفة خطوة بخطوة، ثم ضع علامة على تلك الخطوات في الكود.
5. يؤكد. قم بإجراء تغيير بسيط وقم بإجراء اختبارات لاختبار مدى فهمك؛ يخبرك الاختبار على الفور إذا كان فهمك خاطئًا.

ثلاث حالات صغيرة

الحالة 1 - تم تخفيض الخدمة الموروثة من يومين إلى 3 ساعات. استحوذ أحد المطورين على خدمة تسوية الدفع المكونة من 4000 سطر من زميل مغادر. لو قام الذكاء الاصطناعي بتلخيص الوحدات وتتبع تدفق الدفع من البداية إلى النهاية؛ لقد تحقق شخصيًا من وظيفتين مهمتين في الكود. تم الانتهاء من الاكتشاف، الذي قُدر أن يستغرق يومين باستخدام "القراءة العمياء" الكلاسيكية، في حوالي 3 ساعات باستخدام طريقة الذكاء الاصطناعي التي تم التحقق منها.

الحالة 2 - فخ الأسماء المضللة. إحدى الوظائف كانت تسمى validateAndSave لكن ملخص الذكاء الاصطناعي يقول "التحقق أولاً، ثم الحفظ". عندما دخل المطور في الكود، رأى أن الحفظ قد تم قبل التحقق، وأن التحقق يكتب فقط في السجل. كان هذا هو السبب الجذري الفعلي لتذكرة الخطأ في الإنتاج. إذا لم يكن هناك تحقق من صحة الكود، فإن الملخص الخاطئ سيخفي الخطأ.

الحالة 3 - تسريع التعلم المكتبي الجديد. كان الفريق على وشك دمج مكتبة قائمة انتظار الرسائل التي لم يكونوا على دراية بها. سألت الذكاء الاصطناعي "كيفية إعداد عميل في هذه المكتبة، وكيفية إعادة المحاولة في حالة حدوث خطأ؟" سألوا وأنتجوا عينة. ثم قاموا بمقارنة المثال بالمستند الرسمي وقاموا بإصلاح الفرق (الإصدار القديم من واجهة برمجة التطبيقات). تقليص وقت التعلم إلى النصف

أربعة قوالب قابلة للنسخ

تعيين قاعدة التعليمات البرمجية:

فيما يلي قائمة الدليل/الملف للمشروع. 1) قم باستخراج طبقات التطبيق (الإدخال، ومنطق الأعمال، والوصول إلى البيانات، وما إلى ذلك). 2) قم بإدراج رحلة الملف المحتملة لطلب "{{example property}}". 3) ضع علامة على المناطق التي لست متأكدًا منها على أنها "يجب التحقق منها". {{directory_list}}

وصف الوظيفة (خطوة بخطوة):

قم بتقسيم هذه الوظيفة إلى مجموعات صفية واشرح باللغة التركية البسيطة ما تفعله كل مجموعة. أخيرًا: قم بإدراج الإدخال والإخراج والتأثيرات الجانبية (قاعدة البيانات/الملف/الشبكة) وحالات الحافة المحتملة. اجمع السلوكيات التي لست متأكدًا منها تحت عنوان منفصل "يجب التحقق منها".{{function}}

تتبع تدفق البيانات:

من أين تأتي القيمة "{{variable/data}}" وما هي التحولات التي تمر بها وأين تُكتب؟ قم بإنشاء سلسلة تدفق باستخدام أسماء الوظائف في الكود. الكود ذو الصلة: {{code_segments}}

تعلم كيفية استخدام المكتبة:

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

موجه ضعيف / موجه قوي

ضعيف: "اشرح هذا الرمز." (ما الذي تتساءل عنه؟ على أي مستوى؟ ماذا ستفعل؟)

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

الإصدار القوي يوضح نيتك (سأغير منطق إعادة المحاولة) والتركيز؛ حتى لا يكون الشرح ملخصًا عامًا بل دليلًا مفيدًا.

كويست

الذكاء الاصطناعي يعمل بشكل جيد

تأكد من التحقق

ملخص العمارة العامة

إزالة الطبقات

تسلسل المكالمة الفعلي

وظيفة معقدة

شرح خطوة بخطوة

المنطق العكسي والآثار الجانبية

دفق البيانات

صياغة السلسلة

الفروع الشرطية، المسارات التي تم تخطيها

استخدام المكتبة

توليد العينة

أصالة وإصدار API

لا يوجد بديل للفهم البشري

وصف الذكاء الاصطناعي ليس بديلاً عن التعلم؛ فإنه يسرع ذلك. إن "امتلاك" قاعدة التعليمات البرمجية حقًا يعني بناء نموذج عقلي لها، وهذا النموذج لا يناسبك إلا عندما تقرأ الكود، وتجري تغييرات صغيرة، وترى النتيجة. استخدم الذكاء الاصطناعي كما يقول لك المرشد "انظر هنا، هذا مهم" - ولكن اقرأ حيث تراه بأم عينيك.

نصيحة: عندما تعتقد أنك تفهم وظيفة ما، اطلب من الذكاء الاصطناعي "تلخيصها في جملة واحدة"؛ ثم قارنها بجملتك الخاصة. إذا تناقضت جملتان مع بعضهما البعض، فإما أنك أو النموذج قد فاتك شيء ما - وعليك حله في الكود.

الأخطاء الشائعة

• اعتبر الملخص كدليل. إن اتخاذ القرار بشأن الكود دون التحقق من الوصف يعني الوقوع في فخ الأسماء المضللة.
• لصق قطع كبيرة جدًا. إن تلخيص 2000 سطر مرة واحدة يعطي نتائج سطحية وعرضة للخطأ؛ تقسيم إلى قطع.
• عدم ذكر الغرض. إذا لم تقل "ماذا ستفعل"، فسيظل الوصف عامًا ولا يركز على عملك.
• عدم التحقق من صحة مثيل المكتبة. قد يستدعي النموذج واجهة برمجة تطبيقات قديمة أو غير موجودة؛ قارن مع الوثيقة الرسمية.
• إعطاء كل التعلم بعيدا. إن العمل فقط مع الملخصات دون قراءة قاعدة التعليمات البرمجية يتركك عاجزًا عند أول خطأ حقيقي.

باختصار

يعد الذكاء الاصطناعي دليلاً قويًا لاستكشاف قاعدة الأكواد الأجنبية: هندسة الخرائط، وتبسيط الوظائف المعقدة، وتتبع تدفق البيانات، وتعليم استخدام المكتبة. لكن كل تفسير هو فرضية. اجعل وجهة نظرك واضحة، وقم بتقسيمها، وتحقق من الكود واختبر كل التأكيدات الحاسمة التي يقولها النموذج (ولا يقولها) "يجب التحقق منها". الدليل هو الذكاء الاصطناعي؛ أنت من يقرأ الخريطة ويتحمل المسؤولية.

مهمة التطبيق

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

قائمة مرجعية

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