ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

كيف توفّر 70% من رموز Claude عبر الوصول الموجَّه إلى الشيفرة

طوّر مبرمج أداة بلغة PHP وقاعدة SQLite لتحسين أداء Claude Code عند العمل على المشاريع الكبيرة. يبني سكربتان، هما buildGraph وclaudeSearch، رسمًا بيانيًا لتبعيات المشروع، ويمنحان الوكيل وصولًا موجَّهًا إلى الشيفرة: دالة محددة، أو حقول فئة، أو سلسلة وراثة، أو استعلامات SQL على جدول معيّن. وبدل قراءة الملفات بالكامل، بلغ التوفير في نافذة السياق 70%.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
كيف توفّر 70% من رموز Claude عبر الوصول الموجَّه إلى الشيفرة
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1دالة محددة في فئة، مع توقيعها وجسمها
حقيقة رئيسية #2جميع حقول الفئة ومُنشئها
حقيقة رئيسية #3سلسلة الوراثة كاملة لكيان ما

طوّر مبرمج أداة توفّر 70% من نافذة السياق في Claude عند العمل على المشاريع الكبيرة. فبدل أن يقرأ وكيل الذكاء الاصطناعي الملفات بالكامل، يحصل على وصول موجَّه إلى الشيفرة المطلوبة، أي ما تحتاجه المهمة بالضبط.

المشكلة: سياق ثمين يُهدَر

يعرف Claude Code بنية المشروع من ملف CLAUDE.md ويفهم الملفات المسؤولة عن كل جزء. لكنه عمليًا يقرأ الملفات بالكامل. فإذا احتاج إلى دالة واحدة، قرأ الفئة كلها بجميع دوالها. وإذا أراد معرفة مواضع استدعاء دالة ما، قرأ مجلدًا بعد مجلد بحثًا عن الأنماط. وهكذا يتبدد السياق بسرعة قبل أن يُنجَز أي عمل مفيد.

من السيناريوهات المعتادة أن يطلب المطوّر من Claude العثور على حقل في كيان (Entity). يفتح الوكيل الملف كاملًا، مع أن المطلوب هو أول 20 سطرًا فقط، وفيها وصف الحقول والمُنشئ. أو أن يحتاج إلى فهم بنية العلاقات بين جداول قاعدة البيانات، فيقرأ Claude ملفات SQL بالكامل، مع أن أسماء الجداول والمفاتيح كانت كافية للإجابة.

نافذة السياق هي المورد الرئيسي عند العمل مع الذكاء الاصطناعي على المشاريع الكبيرة. ومن أصل 200K رمز، قد يذهب 100K منها في قراءة شيفرة كان يمكن الحصول عليها بطريقة أذكى.

الحل: رسم بياني للتبعيات ووصول موجَّه

كتب المطوّر سكربتين بلغة PHP يعملان معًا:

buildGraph.php يمسح المشروع مرة واحدة ويبني رسمًا بيانيًا للتبعيات في SQLite. يحلّل الشيفرة بلغتي PHP وJavaScript، ويستخرج الفئات والدوال والتوابع وعمليات الاستيراد وسلاسل الوراثة. والتشغيل تزايدي (incremental)، أي أنه عند إعادة التشغيل يحدّث الملفات التي تغيّرت فقط. ويستغرق ذلك من 100 إلى 200 ميلي ثانية لمشروع متوسط الحجم.

claudeSearch.php هو واجهة CLI للوكلاء. بأمر واحد يمنح Claude ما يحتاجه بالضبط:

  • دالة محددة في فئة، مع توقيعها وجسمها
  • جميع حقول الفئة ومُنشئها
  • سلسلة الوراثة كاملة لكيان ما
  • جميع استعلامات SQL على جدول معيّن
  • قائمة بكل استدعاءات دالة في المشروع بأكمله
  • التبعيات بين الوحدات

بدل Read(path/to/huge-file.php) يكتب Claude الآن search("User", "fields") ويحصل على 15 سطرًا. وبدل قراءة ثلاثة مجلدات، يكتب search("saveOrder()", "calls") فيرى جميع المواضع التي تُستخدم فيها هذه الدالة.

دعم اللغات والسرعة

تدعم الأداة حاليًا PHP وJavaScript بالكامل. وقد أُضيف دعم Go بالفعل، أما C فسيأتي لاحقًا.

سرعة التحليل أمر حاسم، فالرسم البياني يجب ألا يتأخر في التحديث عن وتيرة تعديل المطوّر للشيفرة. والتحديث التزايدي يحل هذه المشكلة: يحلّل المرور الأول المشروع كله (وقد يستغرق بضع ثوانٍ في مستودع كبير)، أما المرور اللاحقة فتحدّث الملفات المتغيّرة فقط خلال 100–200 ميلي ثانية.

ماذا يعني ذلك عمليًا

بحسب حسابات المؤلف، تخفّض الأداة استهلاك الرموز بنسبة 70% في مشروع متوسط نموذجي. وهذا لا يعني أن كل طلب منفرد يوفّر 70%، بل يعني أن السياق يُستخدم خلال جلسة تطوير واحدة بكفاءة أعلى بثلاثة أضعاف. فبدل إنفاق 150K رمز على القراءة ثم 50K على العمل، يمكن للمطوّر إنفاق 70K على البحث و80K على العمل.

والأداة مفيدة خصوصًا لمساعدات CLI والروبوتات التي لا ترى نظام الملفات بنفسها. فيصبح الرسم البياني بالنسبة إليها مصدر الحقيقة حول بنية المشروع.

الخلاصة

تُظهر الأداة اتجاهًا واضحًا: قابلية التوسع في العمل مع Claude على المشاريع الكبيرة لا تقتصر على القرارات المعمارية وملف CLAUDE.md المكتوب بإتقان، بل تتطلب وصولًا ذكيًا إلى الشيفرة. قراءة موجَّهة بدل القراءة الكاملة، ورسم بياني بدل نظام الملفات. وحين يصبح السياق قيدًا، ينبغي ألا تُقرأ الشيفرة بحسب حجمها، بل بحسب ما تحتاجه المهمة فعلًا.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول المشكلة: سياق ثمين يُهدَر؟

يعرف Claude Code بنية المشروع من ملف CLAUDE.md ويفهم الملفات المسؤولة عن كل جزء. لكنه عمليًا يقرأ الملفات بالكامل. فإذا احتاج إلى دالة واحدة، قرأ الفئة كلها بجميع دوالها. وإذا أراد معرفة مواضع استدعاء دالة ما، قرأ مجلدًا بعد مجلد بحثًا عن الأنماط. وهكذا يتبدد السياق بسرعة قبل أن يُنجَز أي عمل مفيد. من السيناريوهات المعتادة أن يطلب المطوّر من Claude العثور على حقل في كيان (Entity). يفتح الوكيل الملف كاملًا، مع أن المطلوب هو أول 20 سطرًا فقط، وفيها وصف الحقول والمُنشئ.

ما أبرز التفاصيل حول الحل: رسم بياني للتبعيات ووصول موجَّه؟

كتب المطوّر سكربتين بلغة PHP يعملان معًا: buildGraph.php يمسح المشروع مرة واحدة ويبني رسمًا بيانيًا للتبعيات في SQLite. يحلّل الشيفرة بلغتي PHP وJavaScript، ويستخرج الفئات والدوال والتوابع وعمليات الاستيراد وسلاسل الوراثة. والتشغيل تزايدي (incremental)، أي أنه عند إعادة التشغيل يحدّث الملفات التي تغيّرت فقط. ويستغرق ذلك من 100 إلى 200 ميلي ثانية لمشروع متوسط الحجم. claudeSearch.php هو واجهة CLI للوكلاء.

ما أبرز التفاصيل حول دعم اللغات والسرعة؟

تدعم الأداة حاليًا PHP وJavaScript بالكامل. وقد أُضيف دعم Go بالفعل، أما C فسيأتي لاحقًا. سرعة التحليل أمر حاسم، فالرسم البياني يجب ألا يتأخر في التحديث عن وتيرة تعديل المطوّر للشيفرة. والتحديث التزايدي يحل هذه المشكلة: يحلّل المرور الأول المشروع كله (وقد يستغرق بضع ثوانٍ في مستودع كبير)، أما المرور اللاحقة فتحدّث الملفات المتغيّرة فقط خلال 100–200 ميلي ثانية.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…