المدونة

لماذا يتباطأ Claude Code: كيف تختار المهارات والوكلاء الفرعيين وMCP والإضافات

Markdown

مقارنة بين إضافات Claude Code واستهلاك السياق وسبعة أخطاء وإعداد عملي بسيط، مع الحفاظ على الأمثلة التقنية.

قراءة المقال كاملًا

الخلاصة الرئيسية

المهارة هي تعليمات متكررة تُحمّل عند تفعيل محفّز (نحو 100 رمز في وضع الخمول). والوكيل الفرعي هو سياق معزول بسعة 200K وله أذوناته الخاصة. يربط MCP البيانات وواجهات API الخارجية. أما الإضافة فهي حزمة جاهزة تضم العناصر الثلاثة الأولى. الصيغة الأساسية لعام 2026: وكيل فرعي من Haiku + مهارة محمّلة مسبقًا للتوافق مع القواعد + خادم MCP واحد محدود النطاق للبيانات الحية. أما كل ما عدا ذلك فإما يهلوس أو يملأ السياق أكثر من اللازم.

تجد في الوثائق تعليمات عملية للعمل مع Ailoot.

لماذا أصبح «حشو Claude Code» أكبر مشكلة في 2026؟

الخلاصة الرئيسية

بحلول يونيو 2026، أصبح لدى Claude Code أربع آليات للتوسعة: المهارة والوكيل الفرعي وMCP والإضافة. يضم السجل الرسمي 101 إضافة، بينما تحتوي فهارس المجتمع على الآلاف. يؤدي إغراء تثبيت كل شيء إلى إبطاء Claude وإرباكه بين الوظائف المتشابهة واستهلاك حدود الاستخدام مع كل رسالة. والسؤال الأهم لدى الجمهور هو: أي آلية ينبغي استخدامها لكل مهمة، من دون تحويل الوكيل إلى ساحة خردة؟

وحتى الوثائق الرسمية لم تقدم إجابة شاملة جاهزة عن سؤال «متى تختار أيًّا منها؟».

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

ما الفرق بين المهارة والوكيل الفرعي وMCP والإضافة؟ في جدول واحد

الخلاصة الرئيسية

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

مصفوفة الاختيار:

الخاصيةالمهارةالوكيل الفرعيخادم MCPالإضافة
سياق معزوللانعم (200K جديد)لاعبر وكلائها الفرعيين
البيانات وواجهات API الخارجيةلاعبر MCP المعيّن فقطنعمعبر خوادم MCP الخاصة بها
توفير الرموز70–90% (الإفصاح التدريجي)حتى 70% في المهام المعقدةبحسب البحث عن الأدواتبحسب محتويات الحزمة
تقييد الأدواتعبر allowed-toolsبصرامة في frontmatterعبر وكيل فرعي أو سياسةجزء من الحزمة
اختيار نموذج أقل تكلفةعبر الحقل modelنعم، في frontmatterلا ينطبقعبر الوكلاء الفرعيين الخاصين بها
سرعة الإعداددقائقدقائقساعات إلى أيامنقرة واحدة من السوق
الاستخدام الأساسيقوائم التحقق، القواعد، الأسلوبمهمة مفوّضة ذات مخرجات كثيرةقاعدة بيانات، واجهة API، بيانات حيةسير عمل مجتمعي جاهز
المطب الرئيسيملف SKILL.md متضخم يتجاوز 500 سطروكيل فرعي بأذونات على مستوى الوكيل الأبأكثر من 3 خوادم MCPحزمة بمحتويات غير مقروءة

إليك تشبيهًا بسيطًا لرواد الأعمال: تخيل أنك المدير التنفيذي لشركة تضم عشرة موظفين:

  • CLAUDE.md — ميثاق الشركة. معلّق دائمًا على الجدار؛ يقرأه الجميع ولا يعترض عليه أحد.
  • Skill — إجراء داخلي: «كيف نجري المراجعات»، و«كيف نكتب ملاحظات الإصدار»، و«كيف نقبل المدفوعات».
  • Subagent — اختصاصي له مكتب منفصل وقائمة أذونات محدودة. إذا منحته مفاتيح كل شيء، فستحصل على مدير تنفيذي ثانٍ لا موظف.
  • MCP server — أنظمة الشركة: CRM والبنك والمستودع. هذا ليس معرفة؛ بل اتصال.
  • Plugin — حل جاهز من متجر. حزمة من الإجراءات والاختصاصيين والتكاملات في صندوق واحد.

ما إن تفهم أنها أربع طبقات في نظام واحد لا أربعة منافسين، يزول سؤال «أيهما أفضل؟». ويبقى سؤال «أين يوضع كل شيء؟».

ما المهارة في Claude Code، ومتى ينبغي تثبيتها؟

الخلاصة الرئيسية

المهارة مجلد يحتوي على ملف SKILL.md (بيانات YAML التمهيدية + تعليمات Markdown) في ~/.claude/skills/<name>/ أو .claude/skills/<name>/ داخل المشروع. تعمل المهارة بالإفصاح التدريجي: عند بدء التشغيل لا يُحمّل سوى الاسم والوصف (نحو 100 رمز)، ولا يُجلب النص الكامل إلا عندما تطابق المهمة المحفّز. وهي الأقل تكلفة من بين الآليات الأربع أثناء الخمول.

تعريف Anthropic الرسمي:

المهارات موارد ملفات قابلة لإعادة الاستخدام تمنح Claude خبرة في مجال محدد: سير العمل والسياق وأفضل الممارسات التي تحوّل الوكيل متعدد الأغراض إلى اختصاصي.

— Anthropic Docs, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

للمهارة ثلاثة مستويات:

  1. البيانات الوصفية. تُحمّل دائمًا عند بدء الجلسة: الاسم والوصف من البيانات التمهيدية. تستهلك المهارة نحو 100 رمز عند بدء التشغيل.
  2. التعليمات. لا تُحمّل إلا عندما يرى Claude طلبًا يفعّلها. حتى 5,000 رمز، وهي متن SKILL.md.
  3. الموارد. لا تُحمّل إلا عندما تطلبها التعليمات صراحةً. وتشمل الملفات المرفقة، والبرامج النصية في scripts/، والمواد المرجعية في references/. تعمل البرامج النصية عبر bash؛ ولا يدخل الرمز البرمجي نفسه إلى السياق.

تسمّي Anthropic هذا المبدأ «الإفصاح التدريجي»:

الإفصاح التدريجي مبدأ تصميم أساسي يجعل Agent Skills مرنة وقابلة للتوسع.

— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

وفي المقال نفسه، يرد تشبيه يشرح الفكرة أفضل من أي شيء آخر:

إنشاء مهارة لوكيل يشبه كتابة دليل تهيئة لموظف جديد.

— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

متى تستخدم المهارة:

  • عند وجود إجراء معياري تكرره مرارًا. مثل مراجعة PR، وكتابة ملاحظات الإصدار، ومراجعة الرمز البرمجي وفق دليل الأسلوب الخاص بك.
  • عندما يتحول قسم في CLAUDE.md من معلومة إلى إجراء ويبدأ في إعاقة كل ما عداه.
  • عندما تريد اتباع التعليمات نفسها باستمرار عبر مشاريع مختلفة.

صيغة عملية: إذا فعلت شيئًا أكثر من مرتين، ففوّضه إلى النظام. في المرة الأولى، استخدم prompt يدويًا. وفي المرة الثانية يصبح مرشحًا لمهارة.

متى لا تستخدم المهارة:

  • إذا كانت المهمة تتطلب بيانات حية (قاعدة بيانات، واجهة API، بحث، بيانات سوق الأوراق المالية الحالية)، فالمطلوب MCP لا مهارة. المهارة التي تحاول «جلب السعر الحالي» ستهلوس.
  • إذا كانت المهمة تتطلب سياقًا معزولًا، فالمطلوب وكيل فرعي.
  • إذا احتجت إلى فحص مُلزِم («امنع commit يحتوي .env»)، فاستخدم hook للمسار الذي يغطيه تثبيت التغييرات بدل الاعتماد على مهارة. راجع تغطيته الفعلية واختبرها؛ فالـ hook لا يقيّد جميع طرق قراءة الملف أو نسخه أو نشره.

حدود ينبغي معرفتها مسبقًا:

  • اسم المهارة: حتى 64 حرفًا، ولا يُسمح إلا بالأحرف الصغيرة والأرقام والواصلات. الكلمتان anthropic وclaude محجوزتان.
  • الوصف: حتى 1,024 حرفًا. يُقتطع مجموع description وwhen_to_use عند 1,536 حرفًا في القائمة.
  • متن SKILL.md: التوصية ألا يتجاوز 500 سطر. انقل كل ما يزيد على ذلك إلى references/ وscripts/.
  • أثناء ضغط السياق التلقائي (auto-compaction)، تُرفق مجددًا أول 5,000 رمز من كل مهارة نشطة. والميزانية الإجمالية لكل المهارات هي 25,000.

ما الوكيل الفرعي، ولماذا توجد 5 مستويات من التداخل؟

الخلاصة الرئيسية

الوكيل الفرعي هو Claude تابع له سياق خاص بسعة 200K رمز، وprompt نظام، وقائمة أدوات محدودة، وأذونات مستقلة. غرضه الأساسي هو العزل: تبقى عمليات البحث المليئة بالضجيج والسجلات الطويلة والأعمال الاستكشافية داخل الوكيل الفرعي، ولا يعود إلى السياق الرئيسي سوى الملخص النهائي. ومنذ 10 يونيو 2026، يمكن للوكلاء الفرعيين التداخل حتى 5 مستويات من الاستدعاء التكراري.

من الوثائق الرسمية:

الوكلاء الفرعيون مساعدين متخصصين بالذكاء الاصطناعي يتولون فئات محددة من المهام. استخدم أحدهم عندما يُحتمل أن تملأ مهمة جانبية محادثتك الرئيسية بنتائج البحث أو السجلات أو محتويات الملفات التي لن ترجع إليها. ينجز الوكيل الفرعي العمل في سياقه الخاص ولا يعيد سوى ملخص.

— Claude Code Docs, https://code.claude.com/docs/en/sub-agents

يضم Claude Code ثلاثة وكلاء فرعيين مدمجين تستخدمهم بالفعل من دون أن تعرف:

الوكيل الفرعيالنموذجصلاحية الوصولموضع العمل
ExploreHaikuللقراءة فقطالبحث في الرمز البرمجي؛ يوفر السياق بتجاوز CLAUDE.md وحالة git
PlanHaikuللقراءة فقطوضع التخطيط — يفكر قبل كتابة الرمز البرمجي
General-purposeSonnet/Opusجميع الأدواتالمهام المعقدة متعددة الخطوات

في 10 يونيو 2026، أطلق Anthropic الإصدار Claude Code v2.1.172 وأزال قيدًا ظل قائمًا منذ إطلاق الوكلاء الفرعيين: أصبح بإمكان الوكلاء الأبناء الآن تشغيل وكلائهم الفرعيين حتى عمق 5 مستويات.

الرقم 5 سقف أمان وليس هدفًا للتحسين.

يتوفر تفصيل شامل للميزة، مع قوالب YAML للمنسّق، في دليل الوكلاء الفرعيين المتداخلين.

متى تستخدم وكيلًا فرعيًا:

  • لاستكشاف الرمز البرمجي أو السجلات عندما لا تحتاج بعدها إلا إلى خلاصة موجزة.
  • للمهام المتوازية التي يمكن تشغيلها جنبًا إلى جنب.
  • للتفويض حسب التخصص: backend / frontend / test / review، بحيث يتولى كل واحد ميزة واحدة.
  • لضبط التكلفة: استخدم وكيلًا فرعيًا من Haiku بدلًا من Sonnet أو Opus، ما يخفض الفاتورة 5–7 مرات.

متى لا تستخدم وكيلًا فرعيًا:

  • لمهمة بسيطة وعابرة أو لاستدعاء أداة بسيط. فللوكيل الفرعي تكلفة بدء تشغيل.
  • عندما تحتاج المهام إلى مشاركة الحالة. لا يستطيع الوكلاء الفرعيون رؤية سياقات بعضهم، لذا ينبغي أن يظل العمل المترابط في المسار الرئيسي.

النمط المضاد الأبرز:

منح الوكيل الفرعي Opus وجميع الأدوات لا يجعله سوى جلسة رئيسية أخرى. إذا طابقت قائمة أدواته قائمة أدوات الوكيل الرئيسي، فهذا يعني أن قيوده غير كافية.

بعبارة أخرى، الوكيل الفرعي الذي يملك أذونات مماثلة لأذونات الوكيل الأب ليس سوى مدير تنفيذي ثانٍ. لا فائدة منه ومكلف.

ما خادم MCP، ومتى ينبغي ربطه بـ Claude Code؟

الخلاصة الرئيسية

MCP (Model Context Protocol) معيار مفتوح من Anthropic لربط الذكاء الاصطناعي بالأنظمة الخارجية: قواعد البيانات وواجهات API وأنظمة الملفات وخدمات SaaS. وبحلول يونيو 2026، أصبح Claude وChatGPT وCursor وVS Code وعشرات العملاء الآخرين يدعمونه. ويطرح موقع modelcontextprotocol.io تشبيهًا مفيدًا: MCP منفذ USB-C لتطبيقات الذكاء الاصطناعي.

التعريف الرسمي:

تخيّل MCP منفذ USB-C لتطبيقات الذكاء الاصطناعي. فكما وحّد USB-C طريقة اتصال الأجهزة الإلكترونية، يوفّر MCP طريقة موحدة لربط تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية.

— modelcontextprotocol.io, https://modelcontextprotocol.io/introduction

ما الذي يتيح لك MCP فعله فعليًا:

  • ربط Claude بـ Google Calendar وNotion للحصول على مساعد شخصي.
  • الاتصال بـ Figma كي ينشئ Claude مشروع ويب جاهزًا انطلاقًا من تصميم.
  • ربط روبوت محادثة مؤسسي بعدة قواعد بيانات في الوقت نفسه.
  • الاتصال بـ Blender وطابعة ثلاثية الأبعاد لإنشاء النماذج وطباعتها فورًا.

أشهر خوادم MCP التي يثبّتها الناس أولًا:

خادم MCPما الذي يربطهمن أين تحصل عليه
Context7أحدث الوثائق لأي مكتبةإضافة من claude-plugins-official
GitHubIssues وPRs والمستودعاتclaude-plugins-official
Filesystemالملفات في المجلدات المسموح بها (في Claude Code، مجلدات العمل فقط)خادم المشروع المرجعي لـ MCP، المستودع modelcontextprotocol/servers
Postgresوصول مباشر إلى قاعدة البياناتأُوقف الخادم المرجعي؛ والبديل النشط هو DBHub من Bytebase
Magic MCP by 21st.devالرسوم المتحركة ومكونات UIفهرس MCP
Slack / Linear / Jira / Notionتكاملات العملclaude-plugins-official

تجد الاتصالات وأوامر التثبيت مجمّعة في فهرس MCP.

متى تستخدم MCP:

  • لأي اتصال ببيانات أو إجراءات خارجية: «اجلب الصفوف من قاعدة البيانات»، و«اقرأ تذاكر Jira»، و«انشر في Slack».
  • عندما تحتاج مشاريع أو وكلاء عدة إلى الخدمة نفسها، يسهل الاحتفاظ بخادم مركزي واحد.

متى لا تستخدم MCP:

  • للمعرفة الثابتة أو الإجراءات. المطلوب مهارة لا MCP. «تعليمات كيفية إجراء مراجعة للرمز البرمجي» مهارة، بينما «اقرأ أحدث PR من GitHub وراجعه» يتطلب MCP.
  • لأمر CLI عابر؛ استخدام Bash أسهل من إعداد خادم.
  • عندما تريد إنشاء MCP «من أجل البنية المعمارية السليمة». فهذا تجميل لا مهمة.

أحد أكبر مطبات MCP ومن أبرز أسباب الشكاوى من أن «Claude Code يتصرف بغباء» في 2026 هو:

عندما تثبّت كل هذه الأنظمة MCP دفعة واحدة، ينتهي بك الأمر إلى خنق نافذة سياق نموذج اللغة الكبير: إذ تُحمّل جميع الأدوات المتاحة إلى السياق.

القاعدة العملية: أبقِ ما لا يزيد على 2–3 خوادم MCP نشطة ومخصصة لمهام محددة. وفي التجربة الموصوفة التي شملت خوادم كثيرة، كان بدء التشغيل أبطأ ووقعت الأخطاء أكثر.

أُضيف البحث عن أدوات MCP في Claude Code v2.1.x: لم تعد الأدوات تُحمّل إلى السياق تلقائيًا، بل تُفهرس وتُجلب عند الحاجة. وهذا يقلل تكلفة «كثرة أنظمة MCP في المشروع»، لكنه لا يلغيها تمامًا.

كيف تختلف الإضافة عن المهارة، ولماذا تلاشى الحد الفاصل بينهما؟

الخلاصة الرئيسية

الإضافة حزمة جاهزة. ويمكن أن تضم مهارة أو وكيلًا فرعيًا أو خادم MCP أو hook، بأي توليفة. جمعت Anthropic كل ذلك في تنسيق واحد يمكن تثبيته بأمر واحد هو /plugin install وتحديثه تلقائيًا. أُطلق سوق claude-plugins-official في فبراير 2026، وبحلول يونيو صار يضم 101 إضافة. والفرق بين «مهارة مستقلة» و«إضافة تتكون من مهارة واحدة» يتعلق بالتغليف فحسب.

الصياغة الرسمية:

توسّع الإضافات Claude Code بمهارات ووكلاء وhooks وخوادم MCP. والأسواق الخاصة بالإضافات فهارس تساعدك على العثور على هذه الامتدادات وتثبيتها من دون جمعها بنفسك. تخيل أنك تصل متجر تطبيقات: بعد إضافة متجر، يصبح لديك وصول إلى مجموعة من التطبيقات، لكنك أنت من يقرر أيها ينزّل.

— Claude Code Docs, https://code.claude.com/docs/en/discover-plugins

الإضافات الأعلى تثبيتًا في يونيو 2026:

الترتيبالإضافةعدد التثبيتاتالمحتويات
1Frontend Design (Anthropic)829 316مهارات + وكلاء فرعيون للتصميم
2Context7 (Upstash)348 660غلاف MCP للوثائق
3Code Review (Anthropic)347 2215 وكلاء فرعيين متوازيين للمراجعة
4Code Simplifier284 632مهارة + hook للتبسيط
5TypeScript LSP177 136إضافة LSP
6Pyright LSP91 225إضافة LSP

يجد القارئ التحليل الكامل للاختيار في دليل أفضل 10 إضافات من أصل 101.

متى تستخدم إضافة:

  • عند توفر حزمة جاهزة من المجتمع تغطي جزءًا كبيرًا من سير عمل، مثل التصميم أو المراجعة.
  • إذا كنت لا تريد إعداد مجموعة «مهارة + وكيل فرعي + MCP + hook» يدويًا، فيمكنك استخدام حزمة جاهزة.
  • للتوزيع المؤسسي: ينشئ المسؤول سوقًا للفريق، ويثبت المطورون منه باستخدام بادئة واحدة.

متى لا تستخدم إضافة:

  • عندما تكفي مهارة واحدة لحل المهمة، لكن الحزمة تضيف معها خمسة أنظمة MCP أخرى «احتياطًا». هذا مجرد ازدحام للسياق.
  • إضافة مغلقة المصدر لم تخضع للتدقيق. فهي تعمل بأذوناتك، لذا اقرأ محتوياتها قبل تثبيتها.
  • إذا كان لديك بالفعل إضافة خاصة بك في الموضوع نفسه. وجود نسخة مكررة في السياق يضاعف المشكلة.

قبل التثبيت، يعرض Claude Code v2.1.143+ Context cost، وهو تقدير للرموز التي ستضيفها الإضافة إلى كل رسالة. ومنذ v2.1.145+ يعرض حقل Will install قائمة كاملة بمحتويات الحزمة من أوامر ووكلاء ومهارات وhooks وMCP وLSP. هذه أول شاشة ينبغي فتحها قبل النقر على التثبيت.

أي مصفوفة اختيار تنجح في 2026؟

الخلاصة الرئيسية

الأداة الأساسية في الدليل هي شجرة قرار تتضمن ستة أسئلة. ابدأ من الأعلى إلى الأسفل وتوقف عند أول إجابة تنطبق. تغطي هذه الخوارزمية 95% من المهام. أما نسبة 5% المتبقية فهي سيناريوهات معقدة تتطلب مزيجًا من وكيل فرعي من Haiku، ومهارة محمّلة مسبقًا للقواعد، وخادم MCP محدود النطاق للبيانات الحية. هذه هي «صيغة 2026» التي تؤتي ثمارها.

ستة أسئلة مرتبة حسب الأولوية:

  1. هل هذه إجراءات أو أسلوب أو قائمة تحقق متكررة؟ إن كان الجواب نعم، فاستخدم مهارة.
  2. هل تحتاج إلى بيانات أو إجراءات خارجية (قاعدة بيانات، واجهة API، Slack، GitHub، Figma)؟ إن كان الجواب نعم، فاستخدم خادم MCP.
  3. هل أريد سياقًا منفصلًا كي لا أزدحم السياق الرئيسي؟ إن كان الجواب نعم، فاستخدم وكيلًا فرعيًا.
  4. هل أريد فحصًا أو خطوة تلقائية عند حدث محدد؟ إن كان الجواب نعم، فاستخدم hook واختبر تغطيته؛ واستخدم الأذونات أو عزل البيئة لحدود وصول أوسع.
  5. هل أريد حزمة جاهزة تضم 1–4 بنقرة واحدة؟ إن كان الجواب نعم، فاستخدم إضافة من السوق.
  6. هل هذه مهمة معقدة تحتاج إلى بيانات وسياق وأسلوب؟ عندئذٍ استخدم تركيبة: وكيل فرعي من Haiku + مهارة محمّلة مسبقًا + خادم MCP واحد محدود النطاق.

صيغة التركيبة:

الاستعانة بوكيل فرعي من Haiku مع مهارة محمّلة مسبقًا للقواعد وخادم MCP محدود النطاق للبيانات الحية نمط يؤتي ثماره فعلًا.

والقاعدة الرئيسية لاتجاه الاعتماد:

يمكن للوكلاء الفرعيين استخدام خوادم MCP. أما خوادم MCP فلا يمكنها استخدام الوكلاء الفرعيين.

بعبارة أخرى، يتولى MCP دائمًا البيانات والإجراءات لا الوكلاء. إذا أردت تفويض مهمة، فالوكيل الفرعي هو من يستدعي MCP، لا العكس.

مثال محدد يصفه هذا المقال: محرك تحريري لوكالة رقمية يكتب مقال SEO واحدًا في 60 دقيقة. يضم 25 وكيلًا فرعيًا و14 مرحلة مراجعة، تعمل بالتتابع، ولكل منها سياقه وأذوناته ومهارته الخاصة بالقواعد التحريرية. يتصل أحد الوكلاء الفرعيين بخادم MCP يضم قاعدة بيانات من الوسوم الجاهزة والمقالات القديمة. ويعمل الوكيل المنسّق الرئيسي على Opus، فيما تعمل الوكلاء الأبناء على Haiku، ما يحافظ على معقولية الميزانية.

ليس هذا «مصنع مقالات»، بل مثال على اجتماع الآليات الأربع في نظام واحد عندما تتطلب المهمة عمقًا في الجودة بدلًا من السرعة.

ما الأخطاء السبعة التي ينبغي إزالتها من Claude Code فورًا؟

الخلاصة الرئيسية

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

  1. ثبتّ أفضل 10 إضافات كلها «لأنها رائجة». تضيف كل واحدة منها رموزًا إلى كل رسالة. افتح /plugin list وتحقق من Context cost لكل إضافة. أزل ما لم تستخدمه منذ أسبوعين.

  2. نسخت 15 خادم MCP من ملف .mcp.json لشخص آخر. إعداد شخص آخر مخصص لمشروعه ومهامه. احرص على ألا يتجاوز عدد أنظمة MCP النشطة للمشروع الحالي 2–3. انقل البقية إلى إعداد منفصل لمشروع آخر أو احذفها الآن.

  3. تؤدي المهارة وإضافة MCP المهمة نفسها. تقول المهارة «أجرِ مراجعة للرمز البرمجي»، بينما يشغّل ملحق pr-review-toolkit سير عمل المراجعة الخاص به. ويبدآن بالتنافس على الأولوية. والعرض هو: «Claude، لماذا تتردد باستمرار؟». الحل: أبقِ مصدرًا موحدًا للحقيقة. في الإعداد الموصوف، اختيرت المهارة للاحتفاظ بالتحكم في التعليمات.

  4. تستخدم مهارة لفرض قاعدة بينما تحتاج إلى hook. المهارة اقتراح وليست ضمانًا. لمنع .env داخل commit، يستطيع pre-commit hook فحص مسار التثبيت هذا. اختبر المحتوى المرحلي والمسارات البديلة مستقلًا؛ فهو لا يمنع جميع القراءات أو طرق النشر الأخرى. ولا تستطيع المهارة وحدها فرض هذا الحد.

  5. لدى الوكيل الفرعي أذونات الوكيل الأب نفسها. منحته Opus وجميع الأدوات، فتحولت النتيجة إلى جلسة رئيسية أخرى. ويوصي prompt النظام في الوثائق الرسمية بمنح الوكيل الفرعي قائمة أدوات محدودة ومهمة مقيّدة خاصة به. وإلا فهو نسخة مكلفة لا أكثر.

  6. لم تتحقق من Will install قبل تثبيت إضافة. يعرض هذا الحقل في Claude Code v2.1.145+ محتويات الحزمة كاملة. وكثيرًا ما تحتوي إضافة «لمهمة صغيرة واحدة» على ثلاثة خوادم MCP ووكيليْن فرعيين وخمسة hooks. وكلها تبدأ باحتلال سياقك.

  7. تكرّر مجلد .claude/commands/ القديم المهارات الجديدة. تقول Anthropic في وثائقها:

دُمجت الأوامر المخصصة في المهارات. ينشئ الملف .claude/commands/deploy.md والمهارة .claude/skills/deploy/SKILL.md الأمر /deploy ويعملان بالطريقة نفسها.

— Claude Code Docs, https://code.claude.com/docs/en/skills

ما زال مجلد commands/ القديم يعمل، لكن المهارات هي المعيار الآن. في المثال الموصوف، كان كلا المجلدين مستخدمًا؛ فأزيل commands/ وأُبقيت المهارات التي تضم الملفات والمحـفّزات.

علامات تدل على أن Claude Code أصبح «مزدحمًا»:

  • تبدأ كل رسالة بذكر الأدوات المتاحة في أكثر من 200 سطر.
  • تستغرق المهام البسيطة وقتًا أطول مما كانت تستغرقه قبل شهر.
  • يخلط Claude بين مهارتين أو إضافتين متشابهتين.
  • تظهر تحذيرات تعارض الأسماء عند بدء الجلسة.
  • يستدعي Claude الأداة الخاطئة، مثل المهارة A بدلًا من MCP B المطلوب.

إذا تعرفت على عرضين من هذه الأعراض على الأقل، فافتح /plugin list و/skill list الآن. أزل أولًا ما لم تستخدمه منذ أسبوعين. ثم تحقق من Context cost لكل عنصر. وبعد ذلك، عالج الأنماط المضادة المذكورة أعلاه.

كم مهارة ونظام MCP يمكنك الإبقاء عليهما من دون استهلاك السياق؟

الخلاصة الرئيسية

لا توجد حدود صارمة، لكن هناك عتبات عملية. أبقِ حتى 10–12 مهارة نشطة، وإلا ستبدأ الحدود الفوقية لدى Anthropic باقتطاع مساحة من كل مهارة أثناء الضغط التلقائي للسياق. وأبقِ ما لا يزيد على 2–3 خوادم MCP نشطة في المشروع. استخدم الإضافات فقط عندما تكون تكلفة Context cost أقل من 1,000 رمز لكل رسالة. تستند هذه العتبات إلى الممارسة لا النظرية.

ما يعرضه Claude Code مباشرة:

  • /skill list — جميع المهارات النشطة وحجمها بالرموز.
  • /plugin list — جميع الإضافات وContext cost لكل منها.
  • /mcp list — خوادم MCP وعدد أدواتها.

ميزانية الرموز بالأرقام الفعلية:

الآليةالتكلفة في وضع الخمولالتكلفة عند التفعيلسعة السياق
Skillنحو 100 رمز (البيانات الوصفية فقط)التعليمات والموارد المحملة التي تُقرأ فعلًاتستخدم سياق مستدعيها
Subagentنحو 50 رمزًا (الاسم والوصف)الإدخال والإخراج ونتائج الأدوات والدورات المتكررة الفعليةنافذة مستقلة؛ مثال 200K سعة وليس رسمًا لكل تفويض
MCP serverأوصاف الأدوات التي يحملها العميلالوسائط والنتائج المحملة؛ وقد تترتب رسوم مستقلة لتنفيذ الخدمةيستخدم سياق مستدعيه
Pluginمجموع المكونات الداخلية المحملةالاستخدام الفعلي لمكوناتها الداخليةبحسب مكوناتها

نافذة السياق هي مساحة العمل القصوى، وليست عدد الرموز الذي تستهلكه كل مهمة. قارن الإدخال المقاس والمدخلات المخزنة مؤقتًا والإخراج والدورات المتكررة للوصول إلى النتيجة نفسها. قد يبقي العزل سياق الوكيل الأب صغيرًا، مع استمرار احتساب استخدام الوكيل الفرعي نفسه.

يورد مدوّنة Anthropic التقنية أرقام ضغط المهارات تلقائيًا: تُرفق مجددًا أول 5,000 رمز من كل مهارة نشطة، بميزانية إجمالية قدرها 25,000. وهذا يعني أن Claude يبدأ بفقدان بعض التعليمات عند تنشيط أكثر من 5 مهارات «ثقيلة» في الوقت نفسه.

قاعدة عملية بسيطة:

  • المهارات: لا يزيد عدد النشطة للمشروع الحالي على 5–7. ضع البقية في ~/.claude/skills/disabled/؛ ويمكنك إعادتها عندما تحتاج إليها.
  • MCP: لا يزيد على 2–3 لكل مشروع. يستحق Context7 الخاص بالوثائق الاحتفاظ به دائمًا تقريبًا؛ واجعل بقية الخوادم مخصصة لمهام بعينها.
  • الإضافات: ثبّت واحدة فقط في كل مرة، وبعد أسبوعين تحقق مما إذا كنت قد استخدمتها. إن لم تستخدمها، فأزلها.

يتناول دليل منفصل تحليلًا مفصلًا لتقرير Anthropic 2026 Agentic Coding Trends Report وسبب عجز 80% من المطورين عن تفويض مهمة بالكامل إلى Claude. والرقم الأساسي في التقرير: يستخدم الناس الذكاء الاصطناعي في 60% من عملهم، لكنهم يفوضون إليه بالكامل 0–20% فقط من المهام. والسبب الرئيسي هو ازدحام السياق وفقدان السيطرة على الأدوات.

من أين ينبغي للمبتدئ أن يبدأ؟ إعداد عملي بالحد الأدنى

الخلاصة الرئيسية

إذا كنت قد بدأت للتو ولا تعرف ماذا تختار، فلا تثبّت أيًا من العناصر المذكورة هنا. ابنِ الأساس أولًا: ملف CLAUDE.md، ومجلدًا منفصلًا لسياق المشروع وبنية أساسية للمهام. اقضِ أسبوعين في تنفيذ مهام حقيقية باستخدام Claude Code دون إضافات. بعدها سيتضح أين يوجد إجراء متكرر (هذه مهارة)، وأين تفتقر إلى البيانات الحية (هذا MCP)، وأين تبدأ المهمة بملء السياق (هذا وكيل فرعي).

الحد الأدنى من الحزمة بعد أسبوعين من العمل:

  1. CLAUDE.md في المجلد الجذر، ويتضمن قواعد المشروع.
  2. AGENTS.md للتوافق مع الأدوات الأخرى إذا كنت تخطط للعمل خارج Claude Code أيضًا. للمزيد، راجع «كيفية إنشاء ملف تعليمات واحد لـ Claude Code وCodex وCursor».
  3. مهارة واحدة لمهمتك المتكررة الأساسية. على سبيل المثال، ابدأ بـ code-review وفق دليل الأسلوب الخاص بك.
  4. خادم MCP واحد: Context7 للوثائق الحديثة. ومن دونه، يواصل Claude الهلوسة بواجهات API غير موجودة.
  5. لا إضافات ولا وكلاء فرعيين في الشهر الأول. ليس الهدف توفير المال، بل الحفاظ على السيطرة. ستسبب لك الحزم الارتباك إلى أن تفهم الأساسيات.

من هناك، اتبع المهام. هل ظهر إجراء متكرر؟ حوّله إلى مهارة. هل تحتاج إلى بيانات حية من خدمة محددة؟ أضف MCP. هل بدأت مهمة كبيرة تملأ السياق الرئيسي؟ فوّضها إلى وكيل فرعي.

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

يمكنك مواصلة استكشاف Ailoot على ailoot.ai.

المزيد من التفاصيل

أسئلة شائعة

هل يستهلك تفويض وكيل فرعي 200K رمز تلقائيًا؟

لا. تصف نافذة السياق السعة. يأتي الاستهلاك من الإدخال والإخراج المعالجين فعلًا ونتائج الأدوات والدورات اللاحقة. قارن مجموع الاستخدام المقاس، بما فيه الإدخال المخزن مؤقتًا، بدل اعتبار النافذة القصوى رسمًا ثابتًا للتفويض.

متى أختار مهارة أو خادم MCP أو وكيلًا فرعيًا؟

استخدم المهارة لإجراء متكرر، وMCP للوصول إلى أنظمة حية، والوكيل الفرعي عندما تملأ مهمة محدودة المحادثة الرئيسية بتفاصيل العمل. تجمع الإضافة هذه المكونات؛ افحص محتوياتها قبل التثبيت.

جميع المقالات