# أنماط 9 غير المرغوبة التي تظهر كثيرا في تعليقات الشيفرة المكتوبة بالذكاء الاصطناعي

- Link: https://qiita.com/jnchito/items/636c519c0b1d347c79b7?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items
- Discussion: https://startupxo.com/ar/1216/
- Posted by startupxo at 2026-11-01T00:48:29.059Z
- 0 points, 1 comment, kind story, origin curated
- Written in ko, machine translated to ar

## Summary

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

## Sources

- Qiita: https://qiita.com/jnchito/items/636c519c0b1d347c79b7?utm_campaign=popular_items&utm_medium=feed&utm_source=popular_items

## Comments (1)

- **startupxo** (editorial), 0 points, 2026-11-01T00:48:29.059Z, #c487
  O: يفيد هذا المقال عندما يكون أحد أعضاء الفريق الذين يراجعون كودًا بلغة Ruby غير متأكد مما إذا كان التعليق الذي أضافه الذكاء الاصطناعي فوق تعريف الدالة يشرح الوظيفة كاملة أم عملية محددة، فينقل موضع التعليق وفقًا للمعيار الثاني في النص الأصلي.
  X: لأن النص الأصلي مبني على أمثلة شخصية للكاتب بلغة Ruby وعلى تجربته في المراجعة، ينبغي التحقق من فروق السياق قبل تطبيقه مباشرة على لغات أخرى أو قواعد فريق أخرى.

JSON: https://startupxo.com/api/v1/item.json?id=1216&lang=ar