Context7: استخدم المهارات والوكلاء الفرعيين، وليس MCP وحده

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

فكّرت ملياً في كيفية حل هذه المشكلة في Claude Code باستخدام المهارات والوكلاء الفرعيين، والفرق في الممارسة العملية كبير.

قيود اتصال MCP المباشر

عندما تستدعي Context7 مباشرة عبر MCP، يتدفق محتوى المستند بالكامل إلى سياقك الرئيسي. هذا مقبول لاستعلام سريع لمرة واحدة. لكن في جلسة عمل حقيقية، نادراً ما تبحث عن شيء واحد فقط.

تراجع توثيق React hook. ثم أداة في Tailwind. ثم واجهة Astro البرمجية. كل استجابة تتراكم فوق السابقة. نافذة السياق تمتلئ، ويبدأ النموذج بفقدان تتبع المحادثة السابقة - الكود الفعلي، والمتطلبات، والقرارات المعمارية التي اتخذتها قبل ثلاث تبادلات.

كما أكد فريق Manus في ملاحظاتهم المعمارية، السياق الواحد الضخم ليس الحل. الفكرة الجوهرية هي أن ليس كل شيء يحتاج أن يعيش في نفس نافذة السياق.

المهارات والوكلاء الفرعيون: استعلامات معزولة عن السياق

يوفر ملحق Context7 آليتين تبقيان استعلامات التوثيق خارج سياقك الرئيسي.

• المهارة (Skill): عندما تطرح سؤالاً عن مكتبة أو واجهة برمجية، يُستدعى Context7 تلقائياً. يجلب أحدث التوثيق ويستجيب دون الحاجة لأي صياغة خاصة منك. عملية البحث تحدث خلف الكواليس.
• وكيل docs-researcher: هذه هي القطعة المعمارية الأساسية. استعلامات التوثيق تعمل في سياق معزول - وكيل فرعي مستقل يتولى البحث، ويستخلص ما هو ذو صلة، ويُعيد الإجابة فقط. سياقك الرئيسي لا يرى التوثيق الخام أبداً.

عندما تريد الاستعلام عن التوثيق بشكل صريح، يمكنك استخدام الأمر:

/context7:docs <library> [query]

هذا يمنحك تحكماً مباشراً مع إبقاء العمل الثقيل خارج نافذة سياقك الأساسية.

التثبيت

ثبّت ملحق Context7 في Claude Code بالأمر التالي:

/plugin marketplace add upstash/context7
/plugin install context7-plugin@context7-marketplace

الفرق في التصميم

باستخدام نفس واجهة Context7 الخلفية، ينتج النهجان نتائج مختلفة جذرياً في الممارسة العملية.

MCP المباشر: كل بحث في التوثيق يُضاف إلى سياقك الرئيسي. بعد ثلاثة استعلامات، تكون قد استهلكت جزءاً كبيراً من نافذة السياق. في منتصف الجلسة، يعمل النموذج بقدرة متراجعة على تذكر الحالة الفعلية لمشروعك.

المهارة + الوكيل الفرعي: استعلامات التوثيق تحدث في سياقات معزولة. فقط الإجابة المستخلصة - توقيع الدالة المحدد، خيار الإعدادات، مثال الاستخدام - تعود إلى سياقك الرئيسي. التوثيق الخام لا يمسّه أبداً.

هذا النمط يحل مشكلتين في آن واحد. يعالج مشكلة انقطاع المعرفة بسحب التوثيق الحيّ، ويفعل ذلك دون زعزعة استقرار جلسات البرمجة الطويلة. تحصل على معلومات محدّثة دون دفع تكلفة السياق.

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