خان المُبرمجين (علي فاضل)
737 subscribers
178 photos
18 videos
1 file
173 links
قناة أنشر فيها ما أتعلمه خلال عملي على مشاريعي الخاصة 👀
Download Telegram
خان المُبرمجين (علي فاضل)
Photo
ملفات MD تعمل 😁

من فترة وجدت مستودعًا باسم superpowers وهو عبارة عن Claude Code plugin (يمكن استخدامه مع بقية الـ Harnesses) وهذا كان وصفه:
An agentic skills framework & software development methodology that works.

وكالعادة، مع كثرة أخبار الذكاء الاصطناعي، تجاهلته تمامًا لأن الأمر أصبح مملًّا، الكثير من المشاريع تظهر وتختفي كل يوم دون أن نعرف جدواها.

ثم ظهر لي مستودع آخر منذ أسبوعين تقريبًا باسم:
superpowers-ruby

فتوقفت ❤️

قرأت ملف README وظهر أنه Fork من مستودع superpowers مخصص للغة Ruby، فبدأت بتثبيته لتجربته، وكانت النتيجة ممتازة خلال الأسبوعين الماضيين.

المستودع الأصلي فيه الكثير من الـ Skills ولكن أكثر ما أعجبني منها هو التالي:
- brainstorming
- writing-plans
- executing-plans
- test-driven-development
- subagent-driven-development
- systematic-debugging

طريقة تفاعل Claude Code أو Codex تغيَّرت تمامًا بعد تثبيت هذه الـ Plugin بداية من بحثه في المشكلة والتخطيط لحلها وصولًا إلى تنفيذ المهام والتأكد من إنجازها.

أنصح بتجربة هذه الـ Plugin بناءً على تجربة شخصية، سواءً superpowers أو superpowers-ruby.

الروابط:
https://github.com/obra/superpowers
https://github.com/lucianghinda/superpowers-ruby

والسلام عليكم 👋🏻
3
خان المُبرمجين (علي فاضل)
Photo
اهتمامنا بجمالية الشيفرة البرمجية قد يُفقدنا الأداء أحيانًا!

كنت أعمل البارحة على مشروع جانبي، واحتجت إلى معالجة بعض النصوص العربية، فكتبت دالة شبيهة بالتي في الصورة.

الدالة بسيطة: تستبدل الألف المهموزة أو الممدودة بألف عادية، والألف المقصورة بياء، والأرقام العربية (أو الهندية) بأرقام ASCII الإنجليزية (والخلاف حول تسمية هذه الأرقام لا ينتهي 😂).

في Ruby توجد دالة اسمها tr، وهي اختصار لكلمة translate. تستقبل سلسلتين نصيتين، ثم تستبدل كل حرف من السلسلة الأولى بالحرف المناظر له في السلسلة الثانية، داخل النص الذي تُستدعى عليه الدالة (text في مثالنا).

كتب Codex الدالة باستخدام سلسلة من الاستدعاءات المتتالية للدالة tr، بحيث يستبدل كل استدعاء جزءًا من الحروف المستهدفة.

وخلال مراجعتي للدالة، طلبت منه إجراء بعض الاختبارات للمقارنة بين سرعة تنفيذها عند استخدام سلسلة من الاستدعاءات، وبين سرعتها عند الاكتفاء باستدعاء واحد فقط يضم جميع الحروف. والمنطق يقول إنها ستكون أسرع في الحالة الثانية، وهذا ما حدث فعلًا.

كانت النتيجة أن الدالة ذات الاستدعاء الواحد أسرع بنحو الضعف من الدالة التي تستخدم سلسلة من الاستدعاءات.

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

الهدف توضيح فكرة واحدة: قد نخسر شيئًا من الأداء مقابل جمالية الشيفرة، وقد نخسر شيئًا من الجمالية مقابل الأداء، وهذا قد يكون مقبولًا بحسب السياق. لكن المهم أن يكون المبرمج واعيًا عند اتخاذ القرار.

والسلام عليكم 👋🏻
5👍1
This media is not supported in your browser
VIEW IN TELEGRAM
كتبت نفس البرنامج 3 مرات بـ 3 لغات مختلفة 😂 ذكرت هذا الأمر في هذا المنشور:
https://t.me/programmerskhan/269

واليوم انتهيت من المراجعة النهائية لتطبيق سطح المكتب الخاص بتحويل والمبرمج حدسيًّا (Vibe Coded) باستخدام Tauri (Rust + Vue3) لتحويل ملفات PDF والصور إلى نصوص بصيغة TXT و DOCX من خلال Google Drive OCR.

مشروع من الزمن الجميل، لا نماذج لغوية عملاقة ولا خوارزميات معقدة، مجرد API calls بسيطة باستخدام Google Drive API.

جودة التحويل ممتازة مقارنة بوقت المعالجة والموارد المطلوبة، يمكنكم تحميل نسخة البرنامج المتوافقة مع نظام تشغيلكم من هذا الرابط:
https://tahweel.ieasybooks.com
8
خان المُبرمجين (علي فاضل)
Photo
يجب أن تستخدم superpowers!

نشرت منذ ثلاثة أيام عن superpowers و superpowers-ruby واكتشفت أنني لا أستغلها بالكامل وذلك خلال إنشاء صفحة لمبادرة الكتب المُيسّرة:
https://ieasybooks.com

بدأت التخطيط مع Claude Code من خلال إعطائه تفاصيل الهوية البصرية لمبادرة الكتب المُيسّرة (الألوان والشعار والخطوط وغيرها) وكل مستودعات مشاريع المبادرة.

تفاجأت بعد أن انتهى من "التفكير" أنه أنشأ خادمًا محليًّا على localhost:59100 وأضاف إلى الصفحة الرئيسية 3 اقتراحات لشكل الصفحة الرئيسية وطلب مني الاطلاع عليها والاختيار منها!

ظننت أنها ميزة جديدة من Claude Code، ولكن اكتشفت بعد ذلك أنها ميزة من superpowers موجودة في Skill اسمها brainstorming واسم هذه الميزة Visual Companion.

فتحت الصفحة ووجدت 3 اقتراحات بالفعل (ليس المنتج النهائي، إنما مجرد مسودَّات للتصميم)، فطلبت منه تغيير الفكرة واستخدام أسلوب آخر للتصميم، فأعطاني 3 اقتراحات أخرى على نفس الصفحة، ثم أكملنا العمل بنفس هذا الأسلوب، أنا أشرح وهو يُنشئ مجموعة من الاقتراحات، ثم نتفق على الشكل النهائي.

ببساطة، تُفعِّل هذه الميزة خادم Node.js محلي، ثم تُنشئ مجموعة من الاقتراحات (Mockups/Concepts)، ثم يعرضها الخادم في الصفحة الرئيسية ويسمح لك باختيار واحد من هذه الاقتراحات.

بعد الاختيار، يمكنك أن تُخبر Claude Code أنك اخترت المقترح المناسب، أو تطلب منه إنشاء مقترحات أخرى، وتستمر عملية التطوير.

الصورة المرفقة كانت لمجموعة من الاقتراحات لقسم الاحصائيات في موقع مبادرة الكتب المُيسّرة واخترت المقترح الثالث 😁

ميزة ممتازة لمشاهدة التصاميم قبل تنفيذها مع أدوات البرمجة بالذكاء الاصطناعي (Claude Code أو غيره) أنصح بتجربتها.

والسلام عليكم 👋🏻
5
لا يختلف Codex عن Claude Code كثيرًا..

بدأت منذ ثلاثة أسابيع في استخدام Codex باشتراك 20$ و Claude Code باشتراك 100$ في نفس الوقت للعمل على مهمات متشابهة وأحيانا للعمل على نفس المهمة.

والنتيجة التي توصلت إليها أن Codex ليس أقل من Claude Code وأن GPT 5.4 ليس أسوأ من Opus 4.6، بل أن Codex باشتراك 20$ يعطيك كمية Tokens أكثر بكثير من اشتراك 20$ في Claude Code وقد تكفيك لأسبوع كامل في حال الاستخدام المنضبط وعدم الإهدار.

يبدو أنني سأنتقل من Claude Code إلى Codex بالكامل قريبًا 😁
5
خان المُبرمجين (علي فاضل)
Photo
هل تعرف كم عمر اعتماديات مشروعك؟

وجدت من فترة مكتبة (أو فكرة) تُسمَّى libyear وهي تعمل كالتالي:

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

كلما ارتفع هذا الرقم (عمر الاعتماديات) زاد القلق نوعًا ما 🤓 وكلما نقص فهذا يعني أن مشروعك في "ريعان شبابه".

كنت أُحدِّث الاعتماديات في MilkStraw AI البارحة في Ruby و JS (حدَّثت Ruby نفسها إلى 4.0.2 🎉) وحسبت الـ libyear للغتين فوجدت أننا متأخرون 4.7 سنة في اعتماديات Ruby و 45.48 سنة في JS، رغم أنني حدَّثت الاعتماديات لآخر نسخة (واضح سبب كرهي لـ JS 😂).

سبب هذا الرقم الكبير في JS هو تأخر المطوِّرين في تحديث اعتماديات مكتباتهم نفسها.

فمثلًا، مكتبة tar موجودة في ملف yarn.lock وهي ليست اعتماديةً مباشرةً لمشروعنا، فأضافت 0.04 إلى مجموع الـ libyear الخاص بنا (كمية الاعتماديات غير المباشرة في JS مُرعبة 😂).

يمكنك التأكد من الـ libyear الخاص بمشروعك في أغلب اللغات المشهورة من خلال المكتبات الموجودة في هذا الرابط:
https://libyear.com

كما يمكنك إضافة الـ libyear كخطوة من خطوات الـ CI الخاص بمشروعك للمحافظة عليه تحت رقم معيَّن (100 سنة مثلًا).

حافظ على شباب مشروعك، والسلام عليكم 👋🏻
😁42🔥2
خان المُبرمجين (علي فاضل)
Photo
مغامرات فاشلة 🥲

يستغرق تشغيل كامل الـ CI في MilkStraw AI على حاسبي الشخصي (MacBook Pro - M3 Pro) 90 ثانية تقريبًا وهو يقوم بتسع مهام منفصلة، منها:
- التأكد من تنسيق الشيفرة البرمجية
- التأكد من عدم وجود أي مكتبات تحتاج إلى تحديث بسبب الثغرات الأمنية
- التأكد من صحة حالات الاختبار وتغطيتها لكامل الشيفرة البرمجية
وغيرها..

تستغرق مهمة حالات الاختبار أكثر من ثلث الوقت بقليل (35 ثانية تقريبًا)، فقررت محاولة تسريعها 🙂

منذ أيام، قرأت عن مكتبة TestProf وهي تهتم بتحديد مسببات البطء في حالات الاختبار ومعالجتها، فبدأت العمل مع Claude Code لتحسين وقت تنفيذ حالات اختبارنا (تذكر، هي 35 ثانية فقط في الأساس).

صرفت 4 أو 5 ساعات من وقتي في هذا الأمر، وفي النهاية توصَّلت لنتيجة واحدة: لا يمكن التحسين أكثر من ذلك.

وعندما راجعت نفسي وتفكَّرت قليلًا، وجدت أن 90 ثانية للـ CI بالكامل و 35 ثانية لحالات الاختبار لم تكن تحتاج إلى تحسين في الأساس، إذا أخذنا في الاعتبار أن مراجعة BugBot مثلا تستغرق 7 إلى 10 دقائق!

يوجد لدينا 2300 اختبار تقريبًا، تحتوي على أكثر من 6450 توكيد (Assertion)؛ لذا فإن انتهائها في 35 ثانية كان أمرًا ممتازًا في الأساس.

لذلك عزيزي القارئ، لا تكن مثل علي، ولا تحاول تحسين ما هو حسن بالفعل، واهتم بالأمور الأكثر إفادة لك ولجهة عملك، وفكِّر مليًّا قبل أن تستهويك المكتبات الجديدة 😁

والسلام عليكم 👋🏻
8
This media is not supported in your browser
VIEW IN TELEGRAM
ولهذا السبب أوقفنا مراجعات Claude في MilkStraw AI 😂
🤣41
خان المُبرمجين (علي فاضل)
Photo
حاول بناء الحلول المناسبة لمشكلتك.

نستخدم في MilkStraw AI مكتبة GoodJob لمعالجة البيانات وتنفيذ المهام في الخلفية (كمثال، إرسال رسائل البريد الإلكتروني).

المكتبة ممتازة وتعمل بكفاءة ولكن ينقصها شيء واحد: إمكانية إنشاء Workflows متكاملة تعتمد على Directed Acyclic Graph (DAG).

بحثنا سريعًا عن حل لتنظيم سير هذه المهام، فلم نجد ما يناسب بيئة عملنا التي تشترط:
- الاعتماد على قاعدة بيانات PostgreSQL فقط.
- عدم الاعتماد على Redis.

فكان الحل في إنشاء مكتبة جديدة لإنجاز هذا الأمر وسميتها GoodPipeline 😂

خلال التطوير، لاحظت وجود بطء في مكتبة GoodJob وهذا يجعل إنشاء Workflows فيها الكثير من المهام المبدئية أو الجذرية (المهام التي يبدأ منها الـ Workflow) بطيئًا نسبيًّا.

ففتحت مستودع مكتبة GoodJob وشغَّلت Claude Code وبدأنا العمل لتحسين هذا البطء 🤓 وكانت النتيجة في هذا التعديل

قلّص هذا التعديل مدة إنشاء الـ Workflows من 3 دقائق ونصف تقريبًا إلى أقل من دقيقة! التعديل متاح الآن ومفيد لجميع مستخدمي المكتبة.

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

وأخيرًا، تذكر دائمًا الإفصاح عند استخدام أدوات الذكاء الاصطناعي في مساهماتك البرمجية 🙂

والسلام عليكم 👋🏻
👏124🔥1
يُعالج نموذج Gemini اللغة العربية بطريقة غريبة!

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

أكتب له عادةً:
Review this LinkedIn post for Arabic writing and grammar issues:
{content}

لكنني بدأت ألاحظ ملاحظاتٍ غريبة، مثل: كتبتَ "تُسمَّي" ويجب أن تكتب "تُسمَّى"، وعندما أعود لما كتبت، أجد أنني استخدمتُ الألف المقصورة "ى" بالفعل ولم أستخدم الياء "ي"!

أو ملاحظات من نوع: كتبتَ الكلمة (س) بهمزة قطع ويجب أن تكتبها بهمزة وصل، فأعود للكلمة فأجدها مكتوبةً بهمزة وصلٍ أساسًا!

فأصبحت أشك أن نماذج Gemini تُعالج المدخلات العربية فتستبدل الألف المقصورة بياء، والألف العادية بألف مهموزة، ولكن الغريب أن هذا الأمر لا يتكرر دائمًا.

يمكنكم مراجعة المحادثة بيني وبين Gemini عبر هذا الرابط:
https://gemini.google.com/share/71e4b417afd8

هل لاحظتم شيئًا شبيهًا؟
3👍1
من أكثر الأشياء التي ساعدتني في البرمجة باستخدام Claude Code أو Codex أو غيرهما، هي مراجعة النتيجة النهائية بواسطة أكثر من Sub-agent ومعالجة الأخطاء إن وُجدت.

على سبيل المثال: بعد الانتهاء من العمل على ميزة جديدة، وقبل دمج التعديلات وطلب المراجعة البشرية، أطلب من Claude Code التالي:

Use 3 sub-agents and review the changes with fresh eyes.

من ميزات هذه الطريقة:
• استهلاك أقل للـ Tokens: لأن الـ Sub-agents تستخدم نماذج أصغر غالباً (مثل Haiku أو Sonnet).
• التصويت: فإذا اتفق أكثر من Sub-agent على نفس المشكلة، فهذا يعطيك ثقة أكبر بوجود خطأ حقيقي.
• الحيادية: مراجعة بدون سياق مسبق، مما يقلل من احتمالية "التحيز" للنتائج السابقة.

أنصح بتجربة هذا الأسلوب، خصوصاً مع التعديلات الكبيرة.

والسلام عليكم 👋🏻
111👍1
لا تثق في تقييمات النماذج يا صديقي 🙂

https://www.youtube.com/watch?v=Oq5e_8zvick
إذا كنت من مستخدمي مكتبة GoodJob، أنصحك باستخدام المكتبة من GitHub مباشرة (main branch) قبل صدور الإصدار القادم لأن الـ Dashboard الخاصة بالمكتبة أصبحت أسرع مئات (أو آلاف) المرات بعد آخر 3 تعديلات أجريتها عليها 🤓 🎉

لا تنسى تعديل قاعدة بياناتك من خلال تشغيل bin/rails g good_job:update لتستفيد من كل التحسينات 🚀

سأنشر مقالًا خلال الأيام القادمة أشرح فيه التعديلات وما أجرته من تحسينات على سرعة الـ Dashboard الخاصة بالمكتبة بإذن الله.
🔥31
نمط جديد في Claude Code لحمايتك من --dangerously-skip-permissions 😂
1