أول أداة بكلود كود

الهدف

تبني أول أداة عملية بكلود كود: سكربت يقرأ ملفات من مجلد ويخرج نتيجة منظّمة، وتتعلّم أسلوب الطلب اللي يخلّي الأداة تشتغل من أول مرة.

الشرح

الأداة = برنامج صغير يسوّي مهمة محددة. ما تحتاج تعرف تبرمج؛ تحتاج توصف المهمة بدقة، وكلود كود يكتب الكود ويشغّله ويصلّح أخطاءه بنفسه.

المثال: الفواتير

عندك مجلد فيه ١٠٠ فاتورة PDF من موردين. تبي ملف إكسل فيه: التاريخ، المورّد، رقم الفاتورة، المبلغ قبل الضريبة، الضريبة، الإجمالي.

أنت: في مجلد invoices/ فيه فواتير PDF. اكتب سكربت يقرأها كلها ويطلع ملف invoices.xlsx بالأعمدة: التاريخ، المورّد، رقم الفاتورة، المبلغ قبل الضريبة، الضريبة، الإجمالي. إذا فاتورة ما قدرت تقرأها، سجّلها في ورقة ثانية اسمها «تحتاج مراجعة» بدل ما توقف.
كلود كود: [يفحص عيّنة من الفواتير، يكتب السكربت، يشغّله، يرى خطأ في صيغة التاريخ، يصلّحه، يعيد التشغيل، ويعرض ملخص النتيجة]

شغل يوم كامل… صار أمرًا واحدًا. والأداة تبقى عندك: الشهر الجاي تشغّلها على الفواتير الجديدة.

وصفة الطلب الناجح

1. المدخل: وين الملفات ووش نوعها.
2. المخرج: اسم الملف، الصيغة، الأعمدة بالترتيب.
3. الحالات الاستثنائية: وش يسوّي لما يفشل في ملف (لا يوقف، يسجّل).
4. التحقق: «قارن مجموع الإجمالي مع عيّنة أحسبها يدويًا».
5. إعادة الاستخدام: «خلّ السكربت يقبل مسار المجلد كمعامل عشان أشغّله على أي مجلد».

أفكار أدوات أولى

• تجميع ملفات إكسل متعددة في ملف واحد منظّم.
• إعادة تسمية مئات الصور حسب التاريخ والمنتج.
• استخراج بيانات الزبائن من رسائل واتساب المصدّرة إلى جدول.
• تحويل مجلد صور المنتجات إلى مقاسات مناسبة لإنستغرام والمتجر.
• مراقبة مجلد وإرسال تنبيه لما يُضاف ملف جديد.

أثناء الشغل

تشوفه يفكّر، يكتب، يشغّل، يقرأ الخطأ، يصلّح. هذي الحلقة (كتابة ← تشغيل ← تصحيح) هي سر كلود كود. لا تقاطعه عند أول خطأ؛ أعطه فرصة يصلّح.

خطوة بخطوة

1. حدّد مهمة يدوية متكررة تستهلك وقتك.
2. جهّز مجلدًا بعيّنة من الملفات (١٠ ملفات تكفي للتجربة).
3. اكتب الطلب بالوصفة الخمسية.
4. راجع النتيجة على العيّنة، ثم شغّل على الكل.
5. اطلب README وخزّن الأداة.

برومبتات جاهزة

ابنِ أداة: المدخل مجلد [اسمه] فيه ملفات [النوع]. المخرج ملف [الاسم.الصيغة] بالأعمدة: [...]. إذا فشلت في ملف، سجّله في قائمة «تحتاج مراجعة» ولا توقف. اجعل مسار المجلد معاملًا. بعد التشغيل اعرض لي ملخصًا: عدد الملفات الناجحة والفاشلة، ومجموع [العمود المهم]. ثم اكتب README بالعربي.

شغّل الأداة في وضع تجريبي يطبع ما سيفعله بكل ملف بدون تنفيذ أي تعديل. بعد مراجعتي أقول لك «نفّذ».

أخطاء شائعة

• التشغيل على ١٠٠٠ ملف من أول مرة: عيّنة أولًا.
• مخرج غير محدد: حدّد الأعمدة والصيغة.
• نسيان الحالات الفاشلة: الأداة توقف عند أول ملف غريب.

تمرين

ابنِ أداة الفواتير (أو أي أداة من القائمة) على عيّنة من ملفاتك الحقيقية. تحقق من رقم واحد يدويًا. ثم شغّلها على المجلد كاملًا واحسب الوقت اللي وفّرته.

الخلاصة

مدخل + مخرج + حالات فاشلة + تحقق + إعادة استخدام. كلود كود يكتب ويشغّل ويصلّح لحاله. أول أداة تبنيها تغيّر طريقة نظرتك للشغل اليدوي.