السلام عليكم ورحمة الله وبركاته،
تحدثت في المقالات السابقة عن البحث عن معجم موحّد للمصطلحات القرآنية بالإنجليزية، ثم اختلاف التسميات بين المشاريع مفتوحة المصدر، ووصلنا بعدها إلى جدول حصر المصطلحات القرآنية.
وفي تعليق على منشور الحصر، اقترح الأخ علي ملص تجهيز ملف توجيهات للمساعدات البرمجية، مثل cursorrules، حتى يعرف المساعد التسميات التي نريد الالتزام بها أثناء التطوير. أعجبني الاقتراح، وحوّلت الجدول إلى مهارة Quranic Vocab. كنت قد أشرت إليها في ملخص ورشة اختلاف المصطلحات القرآنية، وأشارككم هنا طريقة تجربتها بعد التحديث الأخير.
الفكرة أن تطلب من المساعد مراجعة الكود عندك، ليتأكد من اتساق التسميات مع المرجع الذي وضعناه. المطلوب أن يحدد مواضع الاختلاف ويقترح توحيدها، حتى تصبح أسماء المفاهيم في المشروع أسهل في التوقع والمتابعة.
كيف تعمل؟
المهارة ملف تعليمات ومعه مرجع لـ65 مفهومًا، مشتق من جدول حصر المصطلحات، مع تعديلات موثقة في المستودع. لكل مفهوم اسم إنجليزي مقترح، وصيغة جمع حين تكون محددة، وصيغ بديلة قد نجدها في الكود أو التوثيق.
عندما تشغّل المهارة، يقرأ المساعد هذا المرجع ويراجع التسميات في سياقها. ولها وضعان:
- المراجعة (
audit): يعرض الاختلافات ومواضعها والتسميات المقترحة، دون تعديل الملفات. وهذا هو الوضع الافتراضي.
- التعديل (
enforce): يراجع أولًا، ثم يصحح الحالات التي يتضح فيها أن الاسمين يدلان على المفهوم نفسه، مع الحفاظ على المفرد والجمع وطريقة تسمية المتغيرات.
لنأخذ أمثلة تحتاج إلى النظر في المعنى وطريقة استخدام الاسم.
لو كانت لديك قائمة بالروايات اسمها riwayat، فالتسمية المقترحة وفق صيغة الجمع في المرجع هي:
riwayat → riwayahs
هنا نحتفظ بمعنى الجمع. تحويل الاسم إلى riwayah سيجعله مفردًا، مع أن المتغير يحتوي على مجموعة روايات. وهذا أحد أسباب فصل المفرد والجمع في الجدول.
وحالة أخرى أقل وضوحًا: حقل اسمه qiraat. قد يكون المطوّر استخدمه لقراءة واحدة، وقد يقصد مجموعة قراءات. إذا اتضح من نوع البيانات واستخدام الحقل أنه مفرد، يصبح qiraah؛ وإذا كان جمعًا، يصبح qiraahs. أما الاسم وحده فلا يكفي للحكم، وإذا لم يتضح المقصود فالمطلوب الإبلاغ عن الالتباس وترك الحقل دون تعديل.
ملاحظات غيّرت بعض الاختيارات
نشر الأخ عبدالله عبيد مراجعة حول معايير المصطلحات القرآنية، وطرح فيها سؤالًا أعتقد أنه يستحق التوقف عنده: على أي أساس نختار الاسم؟ هل نحتفظ بالمصطلح العربي منقولًا إلى الإنجليزية في كل الحالات، أم نستخدم المقابل الإنجليزي عندما يكون واضحًا؟
استفدت من ملاحظاته في توضيح قاعدة الاختيار. نحتفظ بالمصطلح القرآني المتخصص عندما يفقد المقابل الإنجليزي فرقًا مهمًا في المعنى، ونستخدم الإنجليزية المعتادة للمفاهيم العامة التي تعبّر عنها بدقة. لذلك أبقيت أسماء مثل Surah وAyah وRiwayah، وغيّرت ثلاثة أسماء في النسخة الحالية:
Kalimah إلى Word: الكلمة المكتوبة بحسب تقسيم مجموعة البيانات.Safhah إلى Page: الصفحة ضمن طبعة المصحف أو تخطيطه.Harf إلى Letter: الحرف الهجائي، مع تمييزه عن محرف Unicode أو الشكل الرسومي للحرف.
ومن ملاحظاته أيضًا أن البدائل ليست كلها من النوع نفسه. فالتهجئة الأخرى للاسم تختلف عن ترجمة نذكرها لشرح معناه، والمفهوم المرتبط به قد لا يكون مرادفًا له. لذلك فصلت في المرجع بين التهجئات البديلة، والأسماء السابقة، والترجمات التوضيحية، والمفاهيم المرتبطة، حتى لا نتعامل معها جميعًا باعتبارها أسماء يجب استبدالها.
قد نتفق لاحقًا على اسم أنسب لأحد المفاهيم. لذلك أعطيت كل مفهوم مفتاحًا ثابتًا في مرجع المصطلحات؛ نغيّر التسمية ويبقى المفتاح نفسه. وأبقيت الاسم السابق ضمن البدائل، حتى تتعرّف إليه المهارة في المشاريع القديمة وتقترح الاسم الجديد.
أما طريقة الكتابة، فنستخدم مثلًا I'rab في الشرح وirab في المتغيرات. وضّحت هذه التفاصيل في سياسة التسمية، ومعها ما نحتاجه لإضافة مصطلح: تعريفه، ومصدره، ومثال على استخدامه، ولماذا نفضّل هذا الاسم. نناقش الاقتراح أولًا، وتبقى المهارة على الأسماء الموجودة في المرجع إلى أن نعتمد التعديل.
جرّبوها على مشاريعكم
لتثبيتها في Codex، استنسخوا المستودع داخل مجلد المهارات:
git clone https://github.com/realabdu/quranic-vocab.git ~/.codex/skills/quranic-vocab
ثم افتحوا المشروع واطلبوا مراجعة المجلد المطلوب، مثلًا:
$quranic-vocab audit ./src
وبعد قراءة النتائج، يمكن طلب تطبيق التصحيحات:
$quranic-vocab enforce ./src
يمكن أيضًا تحديد ملف أو نص بدل المجلد. وعند تعديل الكود، تطلب التعليمات من المساعد متابعة استخدامات الأسماء وتشغيل الفحوص المناسبة. راجعوا الفروق، خصوصًا عند التعامل مع أسماء منشورة أو بيانات تأتي من مصادر خارجية.
هذه التسميات ما زالت مقترحًا للتجربة والمراجعة. أضفت إلى المستودع سياسة اختيار الأسماء، والقادم بإذن الله نشر مسودة معيار وسجل قرارات يشرح اختيار كل تسمية، والبدائل التي ناقشناها، وأسباب ترجيحها.
شكرًا لـعلي ملص على الاقتراح، ولـعبدالله عبيد على ملاحظاته القيّمة والساعات الطويلة التي خصصها لمراجعة المشروع. ساعدتني هذه الملاحظات كثيرًا في تحسين المهارة والمصطلحات التي تعتمد عليها.
إذا جرّبتم المهارة ووجدتم تصحيحًا لا يناسب السياق، شاركونا المقطع والاسم الذي اقترحته؛ فهذا سيساعدنا على تحسين التعريف أو قاعدة المراجعة.
