CodeWiki Skill: نهج متعدد الوكلاء لتوثيق الشيفرة البرمجية تلقائيًا

التوثيق صداع دائم للمطوّرين. الجميع يعرف أنه ضروري، ولا أحد يرغب في كتابته، وحتى حين يتصدى له أحدهم، تصبح النتيجة قديمة قبل أن يجفّ حبر آخر commit. هذه المشكلة المزمنة في القطاع هي ما تحاول CodeWiki Skill حلّه، وهي أداة جديدة تحوّل وكلاء AI إلى كتّاب تقنيين.

يقترح المشروع، الذي عُرض على Habr، نهجًا يتجاوز الصيغة المعتادة «أطعم النموذج الشيفرة واحصل على وصف للدوال». فقد صُمّمت CodeWiki Skill بوصفها امتدادًا لـ Claude Code، مساعد AI الطرفي من Anthropic، لكن بنيتها تتيح دمج الأداة مع بيئات تطوير أخرى. والفكرة أن النظام لا يمرّر الملفات عبر نموذج لغوي واحدًا تلو الآخر. بل يعتمد نهجًا متعدد الوكلاء، يعمل فيه عدة وكلاء متخصصين بالتوازي، ولكل منهم نطاق مسؤولية خاص.

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

وهنا يلزم النظر إلى السياق الأوسع. فالأنظمة متعددة الوكلاء من أسرع الاتجاهات نموًا في تطبيقات AI. ففي عام 2024 كان القطاع مهووسًا بحجم نافذة السياق وبجودة كل نموذج على حدة، أما بحلول 2026 فقد انتقل التركيز إلى التنسيق: كيف نجعل عدة وكلاء يعملون معًا على مهمة أعقد من أن يتولاها وكيل واحد. وتمثّل CodeWiki Skill تطبيقًا عمليًا ملموسًا لهذه الفكرة. فهي تُظهر أن تعدد الوكلاء ليس مفهومًا بحثيًا مجرّدًا، بل نمط هندسي عملي يُستخدم فعلًا في حل المهام اليومية للمطوّرين.

ويستحق اختيار الصيغة اهتمامًا خاصًا. فالـ skill في منظومة Claude Code هو في جوهره إضافة، أي مجموعة تعليمات وأدوات توسّع قدرات الوكيل الأساسي. وقد نشر المؤلف CodeWiki كمشروع مفتوح، ما يعني إمكانية تكييفه وتطويره من قبل المجتمع. وهذا مهم لأن احتياجات التوثيق تختلف جذريًا من مشروع إلى آخر: فشركة ناشئة لديها مستودع واحد ضخم monorepo بلغة TypeScript تحتاج توثيقًا مختلفًا تمامًا عما يحتاجه فريق مؤسسي لديه خدمات مصغّرة بلغة Java.

ومن الإنصاف الإقرار بأن التوليد التلقائي للتوثيق ليس فكرة جديدة. فأدوات مثل Sphinx وJSDoc وما يماثلها موجودة منذ عقود. لكنها تعمل على مستوى الدوال والفئات المنفردة، وتستخرج المعلومات من تعليقات يجب أن يكتبها المطوّر يدويًا. أما CodeWiki Skill فتطمح إلى مستوى آخر: توثيق بمقياس معماري، يشرح لا ما تفعله الشيفرة فحسب، بل لماذا صُمّمت على هذا النحو تحديدًا. وبطبيعة الحال، تتوقف جودة هذا التوثيق مباشرة على قدرات النموذج الأساسي، ولذلك يحسن التحلي بقدر من الشك الصحي: فالنماذج اللغوية لا تزال قادرة على الهلوسة وعلى إساءة تفسير المنطق غير البديهي.

ومع ذلك، فالاتجاه صحيح. فمشكلة التوثيق هي في نهاية المطاف مشكلة توسيع نطاق المعرفة داخل الفريق. ففي كل مرة ينضم فيها مطوّر جديد إلى مشروع، يقضي أسابيع في فهم قاعدة الشيفرة، لأن التوثيق إما غائب وإما يصف شيفرة عمرها عامان. وإذا استطاع وكلاء AI إبقاء التوثيق محدّثًا، عبر تحديثه تلقائيًا عند كل تغيير مهم، فسيغيّر ذلك اقتصاديات استقبال المطوّرين الجدد وتأهيلهم onboarding. ولا تحلّ CodeWiki Skill حتى الآن مسألة التحديث التدريجي، لكنها ترسي الأساس الذي يمكن أن يُبنى عليه مثل هذا الحل.

يتجه القطاع نحو مرحلة لن تكون فيها كتابة الشيفرة وتوثيقها عمليتين منفصلتين. وأدوات مثل CodeWiki Skill هي أولى بشائر هذا التحول، وظهورها يدل على نضج كل من البنى متعددة الوكلاء ومنظومة مساعدي AI للمطوّرين نفسها.