ما هو AI DevKit؟
AI DevKit حزمة أدوات وطبقة تشغيل محلية لتنظيم عمل وكلاء البرمجة، وليست نموذج ذكاء اصطناعي جديدًا أو مهارة واحدة مستقلة. يجمع المستودع أداة سطر أوامر وإعدادات مشتركة وذاكرة قابلة للبحث ومهارات هندسية ومكونات لمتابعة الجلسات والتواصل بينها. فائدته تظهر عندما تستخدم أكثر من مساعد، أو عندما تتكرر مشكلات مثل نسيان قرارات المشروع، البدء في البرمجة قبل فهم المطلوب، أو إعلان اكتمال المهمة دون اختبار فعلي. لا يستبدل Claude Code أو Codex أو غيرهما، بل يضبط طريقة استخدام الأدوات الموجودة لديك.
المهارات ودورة التطوير
المهارة المحورية dev-lifecycle منسق يوجه العمل إلى مهارات متخصصة، وليست ملفًا ينفذ جميع تفاصيل التطوير بمفرده. تشمل المراحل تجهيز مساحة العمل، توثيق المتطلبات ومراجعتها، فحص التصميم، تقسيم الخطة، تنفيذ المهام، اختبار السلوك، ثم مراجعة التغييرات. قبل تشغيل مرحلة، تتحقق التعليمات من وجود المهارات المطلوبة ومن بنية وثائق المشروع، ثم تقدم خطة تبين الملفات والأوامر والنتيجة المتوقعة. وعند غياب مهارة ضرورية، يكون المسار الصحيح إصلاح الإعداد أو الإبلاغ عن النقص، لا التظاهر بأن المرحلة نُفذت.
هذا التنظيم مناسب لمزايا لها أثر واضح، مثل إضافة صلاحيات مستخدمين أو ربط خدمة دفع أو تعديل واجهة برمجية. لكنه لا يلزمك بتحويل كل تصحيح إملائي إلى مشروع طويل؛ يمكن استخدام المهارة المناسبة مباشرة عندما يكون النطاق صغيرًا. في المهام الكبيرة، راجع المتطلبات قبل التنفيذ، لأن خطة جيدة لمشكلة مفهومة خطأ ستظل تنتج تعديلًا غير مناسب. كما تسمح دورة العمل بالعودة إلى التصميم أو المتطلبات إذا كشف الاختبار خللًا في الفكرة، بدل ترقيع الكود باستمرار.
التحقق بدل الاكتفاء بالوعود
مهارة verify تطلب دليلًا جديدًا من الجلسة الحالية قبل إعلان النجاح. يتعين تحديد أمر يثبت الادعاء، تشغيله كاملًا، قراءة مخرجاته ورمز خروجه، ثم مقارنة النتيجة بالادعاء نفسه. نجاح فاحص التنسيق لا يثبت نجاح البناء، ونجاح اختبار وحدة لا يثبت أن رحلة المستخدم الكاملة تعمل. هذه التفرقة مفيدة عند مراجعة رد الوكيل: اطلب اسم الاختبار ونتيجته، وليس عبارة عامة مثل «تم الإصلاح». وإذا لم توجد طريقة تحقق مناسبة، يجب توضيح ذلك بدل تقديم ثقة غير مستندة إلى دليل.
وتضيف مهارة tdd مسار الاختبار أولًا: كتابة اختبار لسلوك مطلوب، رؤية فشله للسبب الصحيح، تنفيذ أقل تعديل ينجحه، ثم تحسين البنية مع استمرار نجاح الاختبارات. عمليًا، عند إصلاح خطأ في حساب الخصم، يفضل اختبار الحالة التي تكشف الخطأ قبل تعديل المعادلة. الهدف ليس زيادة عدد الاختبارات شكليًا، بل التأكد من أن الاختبار يستطيع كشف غياب السلوك. وتبقى مراجعة التغييرات البشرية مهمة، لأن اتباع التعليمات يعتمد على الوكيل وعلى جودة أدوات الاختبار المتاحة.
ذاكرة مفيدة وليست أرشيف محادثات
تتيح الذاكرة حفظ معرفة قابلة لإعادة الاستخدام في قاعدة SQLite محلية، مثل اتفاقيات الاستجابات البرمجية أو خطوات حل مشكلة متكررة. يبدأ المسار بالبحث، ثم استخدام النتائج كسياق لا كحقيقة تتغلب على ملفات المشروع أو الاختبارات الحديثة. إذا تعارضت ذاكرة قديمة مع دليل مباشر، تُصحح الذاكرة. وعند الحفظ، يفضل اختيار نطاق محدد للمستودع بدل تعميم قاعدة تخص مشروعًا واحدًا على كل الأعمال.
لا ينبغي إدخال كلمات المرور أو بيانات العملاء أو سجلات خام أو محادثات كاملة في الذاكرة. كذلك لا تصلح كل ملاحظة مؤقتة للحفظ الدائم؛ عبارة «الاختبار يعمل الآن» ليست معرفة مفيدة مثل توثيق السبب المتحقق لمشكلة إعداد متكررة. ويمكن استعمال البحث والتخزين من الطرفية أو عبر تكامل الذاكرة، بحسب الإعداد. كون التخزين محليًا لا يعني أن كل تفاعل مع نموذج الذكاء الاصطناعي محلي، لذلك راجع ما ترسله الأدوات إلى مزوديها بصورة مستقلة.
بداية عملية
جهز بيئة Node.js المناسبة ووكيل البرمجة الذي تستخدمه، ثم شغل npx ai-devkit@latest setup لإعداد الجهاز، وانتقل إلى مشروعك وشغل npx ai-devkit@latest init. ينشئ الإعداد ملف .ai-devkit.json ويضبط ملفات البيئات التي تختارها. راجع التغييرات الناتجة قبل اعتمادها، خصوصًا في مستودع يملك تعليمات وقواعد سابقة. بعد ذلك اطلب من الوكيل استخدام dev-lifecycle لتحديد متطلبات ميزة صغيرة، ثم راجع الوثائق والخطة قبل الموافقة على التنفيذ. ابدأ بميزة محدودة لتفهم سير العمل قبل توسيعه إلى عدة وكلاء.
تستطيع إدارة المهارات بأوامر العرض والإضافة والتحديث، وإضافة مهارات من سجلات أخرى. لكن وجود مهارة داخل المستودع لا يعني أنها ضمن الحزمة الافتراضية؛ بعض المهارات تثبت منفردة. كذلك تختلف المسارات والقدرات بحسب بيئة الوكيل. راجع محتوى المهارة قبل تشغيلها، خصوصًا إذا احتوت برامج مساعدة أو طلبت وصولًا واسعًا؛ تثبيت التعليمات لا يجعل مصدرها موثوقًا تلقائيًا.
العمل بعدة وكلاء وحدوده
توفر أدوات الجلسات عرض الوكلاء وتشخيص جلساتهم وإرسال تعليمات أو مخرجات اختبارات إليهم. ويمكن توزيع التنفيذ والاختبار والمراجعة بين وكلاء مختلفين، لكن الأفضل إعطاء كل عامل مجلد عمل أو Git worktree مستقلًا، مع مهمة محددة وأمر تحقق واضح. تشغيل عدة جلسات في المجلد نفسه قد يسبب التباسًا في مطابقة الجلسات، فضلًا عن تعارض التعديلات. بعد انتهاء العمال، يلزم دمج النتائج وتشغيل اختبارات التكامل؛ نجاح كل جزء منفردًا لا يثبت سلامة المنتج المجمع.
هناك فرق بين دعم إعداد بيئة معينة ودعم التحكم الكامل بجلساتها. تعتمد الجلسات المدارة ولوحة الطرفية على tmux في macOS وLinux، واللوحة تجريبية وغير مدعومة على Windows. وقد تتطلب الاتصالات عبر القنوات الخارجية إعدادات وصلاحيات إضافية. الحزمة مفتوحة المصدر بترخيص Apache 2.0، لكنها لا تلغي اشتراكات مزودي النماذج أو حدودهم. اخترها إذا كانت مشكلتك تنظيم التطوير ومتابعة الأدلة والسياق بين الأدوات؛ أما إذا أردت نموذجًا أقوى أو تطبيقًا جاهزًا بمجرد الضغط على زر، فهذا ليس ما يقدمه المستودع.