كافي باش تكون كفء هو كتاب مفتوح على الذكاء الاصطناعي من تأليف فابيو أكيتا. كيتبع مبرمج مخضرم خلال عام 2026 وهو كيبني برامج حقيقية باستعمال وكلاء الذكاء الاصطناعي، وكيقيّم العشرات ديال النماذج فاختبار شخصي، وكي documentation الأخطاء والتصحيحات، وكيقارن بين إعلانات القطاع والأدلة المتوفرة.
المستودع فيه الكتاب والأدوات المستعملة فالصيانة ديالو. تقدر تقرا النسخ التجريبية بالبرتغالية ولا بالإنجليزية، وتهبط الصيغ النهائية، ولا تبني المصدر براسك باستعمال سيرورة المشروع المبنية على Ruby ومعالجة الوثائق.
شنو كاين فالمشروع
الكتاب موجه للقراء اللي حاسين بالقلق ولا بعدم اليقين تجاه الذكاء الاصطناعي، ومنهم المهنيين اللي خايفين يتعوضو، والآباء اللي كيتبعو التوقعات حول الذكاء الاصطناعي العام، والمسيرين اللي كيسمعو مقترحات على “تحول بالذكاء الاصطناعي”. المنهج ديالو عملي ومبني على الأدلة، وماشي ترويجي.
المحتوى مقسم لخمس أجزاء رئيسية:
- الجزء الأول: شنو هو هاد الشي أصلاً؟ كيدرس واش الذكاء الاصطناعي ذكي، وواش الذكاء الاصطناعي العام قرب.
- الجزء الثاني: الماراطون. كيسول واش الذكاء الاصطناعي خدام خارج العروض المبهرة.
- الجزء الثالث: الأرقام والدعاية. كيتعمق فمقارنات النماذج وكيفاش نقيمو الإعلانات.
- الجزء الرابع: شكون شاد المفاتيح؟ كيناقش مخاطر السماح لأنظمة الذكاء الاصطناعي بالوصول للموارد الشخصية ولا التشغيلية.
- الجزء الخامس: وشنو على خدمتي؟ كيتطرق للمخاوف المرتبطة بالخدمة والخطوات الممكنة من بعد.
المستودع فيه حتى جوج فواصل، وملحق اختياري بلا رياضيات كيشرح كيفاش كتخدم الآلة من الداخل، وزمنية، ولوائح عملية للتحقق، ومسرد فيه 144 مصطلح، و292 مرجع.
تهبط وتقرا الكتاب
أسهل طريقة تستعمل بها المشروع هي تهبط إصدار. حل صفحة الإصدارات واختار آخر نسخة.
- اختار النسخة البرتغالية ولا الإنجليزية.
- اختار الصيغة المناسبة للجهاز ديالك.
- هبط الملف من ملفات الإصدار.
- حلو بقارئ الكتب الإلكتروني، ولا عارض PDF، ولا تطبيق القراءة اللي كتفضل.
الصيغ المتوفرة كتشمل Competente-o-Suficiente.epub لقارئات الكتب الإلكترونية، وCompetente-o-Suficiente-ebook.pdf للقراءة على الشاشة، وCompetente-o-Suficiente.pdf للطباعة. النسخة الإنجليزية كتستعمل أسماء مقابلة بحال Competent-Enough.epub وCompetent-Enough-ebook.pdf وCompetent-Enough.pdf.
هاد النسخ تجريبية. الكتاب باقي مفتوح للمراجعات، ومتوقع تخرج نسخ جديدة حتى يعلن المؤلف أن العمل سالا.
وجد بيئة البناء
إلى بغيتي تبني الكتاب من المصدر ديالو، دير clone للمستودع وعاين ملفات المشروع، بما فيها docs/DESIGN.md وLICENSE.md. ملف README كيحدد التبعيات الضرورية للنظام: Ruby وJava وpoppler-utils.
Ruby كيشغل مهام المشروع. Java ضرورية لـepubcheck، اللي كيتحقق من صحة مخرجات EPUB. أدوات Poppler كتعاون فمعالجة الوثائق أثناء البناء.
من بعد ما تثبت هاد التبعيات، استعمل مشغل المهام ديال المستودع باش تجيب سلسلة الأدوات المثبتة بالإصدارات ديالها:
rake toolsهاد المهمة كتوجد سلسلة الأدوات الموثقة، ومن بينها Quarto مع Pandoc وTypst، وزيد عليهم epubcheck.
بني صيغ النشر
منين تكون الأدوات وتبعيات النظام متوفرة، شغل:
rake buildالبناء كينتج نسخ EPUB وPDF والويب وDOCX داخل build/pt/. وكيشغل حتى التحقق من EPUB ومراجعة الصفحات، باش يعاون فالكشف على المشاكل فالمخرجات المتولدة.
السيرورة العادية هي:
- ثبت Ruby وJava و
poppler-utils. - شغل
rake toolsباش تجيب سلسلة أدوات المشروع المثبتة. - حدّث المحتوى المصدر ولا عاينو.
- شغل
rake build. - راجع الملفات اللي تخرجات فـ
build/pt/وعالج أي مشاكل ديال التحقق ولا مراجعة الصفحات.
README ماكيشرحش مجلد منفصل للمخرجات الإنجليزية، لذلك تبع التوثيق الحالي وإعدادات المهام فالمستودع ملي تخدم على المصدر الإنجليزي.
تبع التغييرات من المدونة
المستودع مصمم باش يبقى متزامن مع مقالات المؤلف فـakitaonrails.com. كل فقرة كتوثق المقال اللي جات منو. بهاد الطريقة تقدر تحدد محتوى الكتاب اللي خاصو مراجعة ملي كتتبدل شي مقالة.
شغل فحص الانحراف بهاد الأمر:
rake drift
الأمر كيبيّن شنوما الفصول المتأثرة بالتغييرات فالمدونة وكيعرض الفرق المرتبط بها. استعملو قبل الإصدار ولا من بعد تحديث المقالات المصدر، باش تفهم شنو خاصو يتراجع.
فهم طريقة إنتاج المشروع
المستودع كيتعامل مع الكتاب على أنه منشور كيتصان باستمرار، وماشي وثيقة جامدة. الرسومات كترسم على شكل كود، والرسومات التوضيحية المتولدة بالذكاء الاصطناعي كيتصرح بها فاعتمادات الصور، والصور الفوتوغرافية الحقيقية كيتذكرو التراخيص ديالها. كاين تفاصيل أكثر على هاد العملية فـdocs/DESIGN.md.
هاد المنهج مفيد ملي كتراجع المشروع ولا كتساهم فيه، حيث كيفصل بين مصدر النصوص، والموارد المولَّدة، ومعلومات الترخيص. قبل ما تعاود توزّع شي نسخة مبنية، قرا LICENSE.md مزيان.
نصائح متقدمة للخدمة مع المستودع
استعمل الإصدارات للقراية والمصدر للصيانة
القُرّاء غالباً خاصهم يستعملو موارد الإصدارات، حيث راه واجدين ومعبّئين للصيغ الشائعة. استعمل مستودع المصدر ملي تحتاج تتفقد كيفاش تبنى الكتاب، تعاود تنتج نسخة مبنية، ولا تحقق فالتغييرات بين المدوّنة والكتاب.
دير فحوصات الاختلاف قبل النشر
إلا تبدّل محتوى شي مقال، شغّل rake drift قبل rake build. هاد الشي كيعطيك لائحة مركّزة بالفصول اللي ممكن تكون ولات قديمة، وكيساعد باش تبقى النسخ المولَّدة منسجمة مع المقالات الأصلية.
خلي التحقق داخل دورة البناء
مهمة البناء فيها epubcheck ومراجعة للصفحات. اعتابر هاد الفحوصات جزء من عملية النشر، ماشي إضافات اختيارية، خصوصاً ملي كتبدّل القوالب، والرسومات التوضيحية، ولا بنية الوثيقة.
راجع التراخيص قبل إعادة الاستعمال
النص ديال الكتاب، والغلاف، والرسومات التوضيحية محميين بحقوق النشر ديال Fabio Akita، بينما سكريبتات البناء والقوالب مرخّصين برخصة MIT. الخطوط، وأسلوب الاستشهادات، والصور الفوتوغرافية يقدرو يكون عندهم تراخيص منفصلة مذكورة فـ LICENSE.md. ما تفترضش باللي كل ملف فالمستودع عندو نفس شروط إعادة الاستعمال.
الخلاصة
كتاب Competent Enough كيجمع بين كتاب نقدي على الذكاء الاصطناعي وسيرورة نشر قابلة لإعادة الإنتاج. تقدر تحمّل نسخة تجريبية من Releases، وتبني الصيغ المتاحة باستعمال rake build، وتستعمل rake drift باش تحدد المحتوى اللي تأثر بالتغييرات فالمقالات المصدرية. والنتيجة هي طريقة عملية لدراسة ادعاءات الذكاء الاصطناعي، وفنفس الوقت استكشاف كيفاش كيتصان منشور تقني طويل.