SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

الفرق بين مهارات الوكيل وMCP وملفات القواعد

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

مهارات الوكيل (Agent skills) مقابل خوادم MCP مقابل ملفات القواعد: الإجابة المختصرة

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

لهذا الاختيار تكلفة، وتلك التكلفة هي السياق (context). كل رمز (token) يُنفق على تعليمات لا يحتاجها الوكيل هو رمز غير متاح للكود الذي يقرأه. كما أنك تدفع ثمن هذا الرمز مجدداً في كل دورة، لأن نافذة السياق بأكملها تُرسل من جديد مع كل طلب. لذا، السؤال المفيد ليس أي آلية يمكنها إنجاز المهمة؛ ففي معظم الأيام، يمكن للآليات الثلاث القيام بذلك. السؤال هو أيها الأقل تكلفة أثناء حالة الخمول.

تكلفة كل منها قبل استخدامه

يتم تحميل الثلاثة في لحظات مختلفة، وهذا التوقيت هو جوهر الاختلاف.

يُحمَّل ملف القواعد غير المشروط عند الإقلاع، في كل جلسة، سواء كان ذا صلة أم لا، ما لم يتم استثناؤه. يقرأ Claude Code ملفات بدء التشغيل CLAUDE.md في بداية كل محادثة، ويزيل تعليقات HTML على مستوى الكتلة الموجودة خارج كتل التعليمات البرمجية قبل إدراج محتواها، ويتخطى الملفات التي يتجاوز حجمها 4 MiB؛ كما يمكن لـ claudeMdExcludes استثناء الملفات باستثناء ملف السياسة المُدار. الهدف الموثق هو أقل من 200 سطر لكل ملف، لأن الملف الأطول يستهلك سياقاً أكبر ويتم اتباعه بشكل أقل موثوقية. هذان التأثيران يدفعان في نفس الاتجاه، ولهذا السبب يكون ملف القواعد المكون من 900 سطر أسوأ من كونه عديم الفائدة.

تُحمَّل المهارة على مرحلتين. عند بدء التشغيل، يدخل سطر description فقط من كل واجهة SKILL.md إلى السياق، ليعرف النموذج وجود المهارة وتوقيت تطبيقها تقريباً. يُحمَّل المتن عند استدعاء المهارة. لذا، فإن مستند مرجعي مكون من 400 سطر لا يكلفك شيئاً تقريباً حتى لحظة الحاجة إليه.

كان خادم MCP هو الأكثر تكلفة، وهنا تكمن النقطة التي أصبحت فيها معظم المقارنات التي تقرأها قديمة. ميزة البحث عن الأدوات مفعلة افتراضياً في إصدار Claude Code الحالي. تُحمَّل فقط أسماء الأدوات وحقل تعليمات الخادم عند بدء الجلسة، بينما يتم تأجيل مخططات JSON (ترميز كائنات JavaScript) الكاملة حتى يبحث عنها Claude. لم تعد إضافة خادم تكلف آلاف الرموز (tokens) مقدماً. لا تزال هناك تكلفة، ولا تزال التكلفة كاملة ومقدمة في الإعدادات التي تكون فيها ميزة البحث عن الأدوات معطلة.

رسم بيانيStartup and post-use context cost, estimated tokens
البيانات وراء هذا الرسم البياني
[
  {
    "label": "Rules file, 200 lines",
    "at_startup": "2,500",
    "after_use": "2,500"
  },
  {
    "label": "Skill, 12 KB body",
    "at_startup": 40,
    "after_use": "3,000"
  },
  {
    "label": "MCP server, tool search on",
    "at_startup": 500,
    "after_use": "3,200"
  },
  {
    "label": "MCP server, tool search off",
    "at_startup": "4,500",
    "after_use": "4,500"
  }
]

هذه تقديرات، وليست قياسات من جهازك. إنها تأتي من حجم النص الذي تحمله كل آلية، بمعدل أربعة أحرف تقريباً لكل رمز: ملف قواعد مكون من 200 سطر يبلغ حوالي 10 KB من Markdown، ووصف المهارة يبلغ حوالي 160 حرفاً، والخادم الذي يعرض اثنتي عشرة أداة يحمل حوالي 18 KB من المخطط بالإضافة إلى كتلة تعليمات بحجم 2 KB. يقتطع Claude Code حقل تعليمات الخادم، ووصف كل أداة يتم تحميلها مقدماً، عند 4,096 حرفاً افتراضياً، ووصف الأداة الذي يتم تحميله عبر البحث عن الأدوات عند 16,384. قبل الإصدار v2.1.296 كان الحد الأقصى الأقصر هو 2,048 حرفاً، ويحل CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH محل كلا الحدين إذا قمت بضبطه. تصل التعليمات والأوصاف من بعض خوادم MCP المستضافة من قبل Anthropic إلى Claude بالكامل حتى مع ضبط هذا المتغير، لذا فإن هذه الحدود ليست سقفاً عالمياً. يوضح لك القسم التالي كيفية قراءة أرقامك الحقيقية بدلاً من ذلك.

اقرأ الصفين الأولين معاً. يكلف ملف القواعد 2,500 رمزاً في جلسة لم يحتجها فيها أحد. تكلف المهارة 40 رمزاً في نفس الجلسة، و 3,000 في الجلسة الواحدة من أصل عشر جلسات يتم تفعيلها فيها. الصفان الأخيران هما لنفس الخادم مرتين، مع تفعيل وتعطيل البحث عن الأدوات: 500 رمزاً مقابل 4,500. هذه الفجوة هي السبب في استمرار تداول النصائح القديمة حول تضخم سياق MCP.

اعتباراً من أكتوبر 2026، يستخدم Claude Code البحث عن الأدوات في نماذج Claude Opus 4 وSonnet 4 وHaiku 4.5 وما يليها، وفي Opus 4.5 وSonnet 4.5 وHaiku 4.5 وما يليها على منصة Agent Platform الخاصة بـ Google Cloud. في النماذج الأقدم، وعلى عمليات نشر Microsoft Foundry المستضافة على Azure، يتم تحميل كل أداة MCP مقدماً بغض النظر عما تضبطه. مع توجيه ANTHROPIC_BASE_URL إلى بوابة LLM، يتم تفعيل البحث عن الأدوات افتراضياً منذ الإصدار v2.1.304؛ كانت الإصدارات الأقدم تعطلها هناك ما لم تختر تفعيلها. منذ الإصدار v2.1.305، يمكن لـ Claude Code إعادة محاولة طلب البوابة بدون بحث عن الأدوات بعد 400 أو 422، مع تحميل الأدوات مقدماً عند نجاح تلك المحاولة. اضبط ENABLE_TOOL_SEARCH للتحكم في ذلك: يقوم false بتحميل كل مخطط مقدماً، ويقوم true بتأجيلها مع نفس احتياطيات النموذج والنشر كما في حالة تركها دون ضبط، ويقوم auto بتحميلها مقدماً طالما أن تعريفاتها تشكل إجمالاً أقل من 10% من نافذة السياق، ثم يبقي البحث عن الأدوات مفعلاً بمجرد الوصول إلى هذا الحد حتى لو انخفض الإجمالي لاحقاً إلى ما دون ذلك. الخادم الذي تم تكوينه باستخدام "alwaysLoad": true يحمل أدواته مقدماً بغض النظر عن ENABLE_TOOL_SEARCH.

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

السؤال الحاسم: هل تتغير البيانات بين مرات الاستدعاء؟

اطرح هذا السؤال أولاً، لأنه يستبعد خياراً واحداً بشكل قاطع. إذا كان الوكيل يحتاج إلى قراءة أو كتابة شيء قد يختلف في المرة التالية التي ينظر فيها، فأنت بحاجة إلى خادم. مثل نظام تتبع المشكلات، أو قاعدة بيانات، أو لوحة تحكم للمراقبة، أو واجهة برمجة تطبيقات (API) داخلية خاصة بك. تدوين البيانات لا يساعد، لأن ما كتبته يصبح قديماً بمجرد أن يقوم شخص آخر بتعديل السجل. تندرج قاعدة الأكواد البرمجية الخاصة بك ضمن هذه القائمة أيضاً، لأن هيكلها يتغير مع كل عملية commit، وهذا هو السبب وراء تزويد الوكيل بخريطة محللة للمستودع عبر MCP بدلاً من وصف التخطيط في ملف يتقادم مع الوقت.

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

إذا كانت حقيقة واحدة يجب أن تنطبق على عمل لم تفكر فيه بعد، ضعها في ملف القواعد (rules file). Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. سطر واحد لكل منها. في اللحظة التي يتحول فيها الإدخال إلى خطوات، فإنه يتوقف عن كونه حقيقة ويصبح إجراءً، ويجب نقله إلى مهارة.

عندما يكون ملف القواعد كافياً

تُحمَّل ملفات القواعد من عدة أماكن، بدءاً من النطاق الأوسع وصولاً إلى الأكثر تخصيصاً: ملف سياسة مُدار، ملف ~/.claude/CLAUDE.md الشخصي الخاص بك، ملف ./CLAUDE.md أو ./.claude/CLAUDE.md الخاص بالمشروع، وملف ./CLAUDE.local.md الذي يتجاهله git. تُدمج جميع الملفات المكتشفة بدلاً من أن يحل أحدها محل الآخر، وتُقرأ الملفات الأقرب إلى دليل عملك الحالي في النهاية.

بدءاً من الإصدار v2.1.277، يقرأ Claude Code أيضاً ملف AGENTS.md، ولكن افتراضياً فقط في حال عدم وجود CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في دليل عملك أو في الأدلة التي تعلوه. إذا كان مستودعك يحتوي على كليهما، يقرأ Claude ملفات CLAUDE.md فقط، لذا لا تحتفظ بنسختين قد تختلفان عن بعضهما بمرور الوقت.

ln -s AGENTS.md CLAUDE.md

لا يطبع الرابط الرمزي (symlink) أي شيء عند النجاح. ابدأ جلسة، ونفّذ الأمر /context all، وتأكد من ظهور CLAUDE.md تحت قسم Memory files. إذا لم يكن مدرجاً هناك، فهذا يعني أن الوكيل لم يره مطلقاً ولن تجدي إعادة الصياغة نفعاً. عندما ترغب أيضاً في إضافة أسطر خاصة بـ Claude، استخدم صيغة الاستيراد (import) وضعها أسفل الاستيراد.

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

هناك فخ واحد هنا. استيرادات @path لا تحفظ السياق. يتم توسيع الملف المستورد وتحميله عند التشغيل جنباً إلى جنب مع الملف الذي أشار إليه، وذلك حتى عمق أربع مستويات. تقسيم ملف قواعد مكون من 600 سطر إلى ستة ملفات مستوردة ينظمه للبشر ولا يغير تكلفة الرموز (tokens) بمقدار أي شيء. يجدر بك قراءة الاتفاقيات الكامنة وراء AGENTS.md وتوأمه الموجه للبشر قبل الاستقرار على هيكلية معينة.

ما يقلل التكلفة فعلياً هو .claude/rules/ مع حقل paths. ملف القواعد الذي يحمل بيانات وصفية (frontmatter) من نوع paths يُحمَّل فقط عندما يلمس الوكيل ملفاً يطابق أحد الأنماط.

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

القاعدة التي لا تحتوي على حقل paths تُحمَّل عند التشغيل بنفس أولوية .claude/CLAUDE.md. لذا، فإن نمط العمل المتبع هو وضع القواعد القصيرة غير المشروطة، بالإضافة إلى قائمة paths لأي شيء يهم فقط داخل دليل واحد.

عندما ترغب في استخدام مهارة

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

mkdir -p ~/.claude/skills/summarize-changes
---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.

يُعد description الجزء الوحيد من ذلك الملف الذي يظهر في السياق قبل تشغيل المهارة، لذا فهو يؤدي وظيفتين. فهو يحدد ما تفعله المهارة، ويحدد متى يجب استخدامها. إذا كان الوصف "يساعد في عمليات النشر" (Helps with deploys)، فلن يجد النموذج ما يطابقه مع الطلب، لذا لن تعمل المهارة بهدوء، وستستنتج أنت أن المهارات لا تعمل.

يصبح اسم الدليل هو الأمر، لذا يمنحك المثال أعلاه /summarize-changes. في المهارات الشخصية أو مهارات المشروع، يؤدي وجود حقل name في الترويسة (frontmatter) يختلف عن اسم الدليل إلى تعيين الأمر الذي تظهره قائمة / بدلاً من ذلك، ما لم يكن هناك أمر آخر يستخدم هذا الاسم بالفعل، وسيظل اسم الدليل يستدعي المهارة.

بمجرد استدعاء المهارة، يدخل محتواها المُعالج إلى المحادثة كرسالة واحدة ويبقى هناك لبقية الجلسة. لا يعيد Claude Code قراءة الملف في الجولات اللاحقة. اكتب تعليمات دائمة بدلاً من خطوات تُنفذ لمرة واحدة، وحافظ على اختصار النص، لأن كل سطر من تلك النقطة فصاعداً يمثل تكلفة متكررة في كل طلب. بعد الضغط التلقائي، يعيد Claude Code إرفاق أحدث استدعاء لكل مهارة، مع الاحتفاظ بأول 5,000 رمز (token) من كل منها ضمن ميزانية إجمالية قدرها 25,000 رمز. إذا استدعيت عدة مهارات كبيرة في جلسة واحدة، فسيتم إسقاط أقدمها بالكامل، وهذا هو السبب في أن المهارة قد تبدو وكأنها توقفت عن التأثير بعد محادثة طويلة. استدعِها مرة أخرى وستعود للعمل. تجعل المهارة التي تعتمد على إجراءات مكثفة هذه المقايضة ملموسة: المهارة غير الكسولة وطريقة شجرة العمق الخاصة بها تستهلك سياقاً فعلياً في البوابات وملف الخطة مقابل الحصول على وكيل يتوقف عن إعلان انتهاء العمل قبل أوانه. عندما ينطبق نفس الإجراء على أكثر من قاعدة برمجية، شارك مهارة واحدة عبر عدة مستودعات بدلاً من نسخ الملف في كل مكان.

متى تحتاج إلى خادم MCP

تعد إضافة خادم عملية تتطلب أمراً واحداً فقط، ويحدد بروتوكول النقل شكل هذا الخادم.

# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

يعد -- أمراً جوهرياً. بالنسبة لخادم يعمل عبر stdio، فإنه يفصل خيارات Claude Code الخاصة عن سطر الأوامر الذي يشغل خادمك. إذا أغفلته، سيتم تحليل --port 8080 المخصص للخادم كخيار لـ claude mcp add، والذي سيرفضه بدوره.

claude mcp list
claude mcp get notion

يؤكد claude mcp add العملية عبر سطر Added ...، والذي يخبرك فقط بأنه تمت كتابة الإعدادات على القرص. claude mcp list هو الأمر الذي يخبرك بالحقيقة، لأنه يعرض حالة السلامة بجانب كل خادم: ✔ Connected، أو ! Needs authentication، أو ✘ Failed to connect. تعني حالة الفشل أن Claude Code لم يتمكن من الوصول إلى ذلك الخادم، وليس أن أمر القائمة قد تعطل. داخل الجلسة، يعطي /mcp نفس العرض لكل خادم بالإضافة إلى عدد الأدوات المتاحة.

كل استدعاء لخادم MCP مستقل بذاته ويحمل كل ما يحتاجه، وهذا هو سبب عدم تذكر خادم MCP لطلبك السابق. هذا خيار تصميمي يترتب عليه نتيجة تتحملها أنت: أي حالة تستحق الاحتفاظ بها يجب أن توجد خلف الخادم، في قاعدة بيانات أو ملف، وهذا هو الشيء الذي أصبحت تديره الآن.

خادم MCP هو عملية يجب عليك تشغيلها

إليك التكلفة التي لا تذكرها مقارنات المورّدين. المهارة ملف. أما خادم MCP فهو برنامج يعمل في مكان ما. وعندما يكون هذا المكان هو VPS (خادم خاص افتراضي)، تصبح أنت مسؤولاً عن استمرارية تشغيله.

خادم stdio هو الحالة الأقل تكلفة. يشغّله Claude Code كعملية فرعية عند بدء الجلسة، ويتوقف عند انتهاء الجلسة. لا شيء يحتاج إلى مراقبة، ولا تصحيحات يجب تثبيتها وفق جدول مستقل. أما خادم HTTP البعيد فهو خدمة طويلة التشغيل، ويحتاج إلى متطلبات أي خدمة طويلة التشغيل، بدءاً من مستخدم مخصص له. أنشئ مستخدم mcp الذي ستشغّله الوحدة أدناه، وامنحه دليل الخادم:

sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp
[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target

[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

يجب أن يطبع systemctl is-active القيمة active. إذا طبع failed، فسجّل journal السبب. وفي التشغيل الأول، يكون السبب غالباً متغير بيئة مفقوداً أو منفذاً تستخدمه عملية أخرى. لا يُعد Restart=on-failure اختيارياً هنا، لأن خادم MCP المتعطل لا يعلن عن تعطله. ستعرف ذلك فقط عندما يخبرك الوكيل بأنه لا يستطيع قراءة أداة تتبع المشكلات لديك.

اربط العملية بالعنوان 127.0.0.1، وضع reverse proxy مع TLS (أمان طبقة النقل) أمامها. خادم MCP الذي يصل إلى قاعدة بياناتك ويجيب على منفذ عام من دون مصادقة هو قاعدة بيانات نشرتها على الإنترنت. يشرح تشغيل خادم MCP على VPS إعداد الـproxy والشهادة والجدار الناري بصورة صحيحة.

ثم احسب العمل المتكرر بواقعية. تثبّت الخدمة تحديثات الأمان وفق جدولها الخاص، من دون ارتباط بالوكيل الذي يتصل بها. تنتهي صلاحية رمز OAuth الخاص بها، ويبدأ claude mcp list في طباعة ! Needs authentication في وقت غير مناسب. تُخزَّن بيانات اعتمادها في ملف إعداد أو في رأس Authorization، ولذلك تحتاج إلى العناية نفسها التي تحتاج إليها أي قيمة سرية أخرى. وهذا موضوع كامل بحد ذاته: إبعاد الأسرار عن متناول وكيل الذكاء الاصطناعي. لا يوجد أي من هذا العمل عند استخدام مهارة.

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

كيفية قياس تكلفة السياق الخاصة بك

توقف عن التخمين وقم بتشغيل /context all داخل الجلسة. سيؤدي ذلك إلى طباعة تفصيل حالي يتضمن: مطالبة النظام (system prompt)، وملفات الذاكرة، والأدوات، وخوادم MCP، مع وزن الرموز (token weight) لكل منها.

تحقق من أمرين. ضمن Memory files، تأكد من إدراج كل ملف قواعد تتوقعه. الملف المفقود غير مرئي للوكيل، لذا فهذا هو أول شيء يجب استبعاده عندما يتم تجاهل التعليمات. إذا كان الملف مدرجاً ولا تزال القاعدة تُتجاهل، فإن السبب يكمن في مكان آخر تماماً، ويجدر بك مراجعة الأسباب التي تجعل الوكيل يتجاهل تعليمات يمكنه رؤيتها قبل إعادة كتابة السطر مرة أخرى. بعد ذلك، انظر إلى تكلفة خوادمك. إذا كان أحد الخوادم التي تستخدمها مرتين في الشهر يمثل أحد أكبر البنود في تلك القائمة، فقم بإيقاف تشغيله في /mcp وأعد تشغيله للجلسات التي تحتاجه. يتم الاحتفاظ بالإعداد في كلتا الحالتين.

إذا كان ذاكرة التخزين المؤقت للاكتشاف (discovery cache) مفعّلة لحسابك، فقد يظهر خادم بعيد استخدمته من قبل حالة مثل cached 2h ago · connects on first use · 5 tools. هذا يعني أن Claude Code قرأ قائمة الأدوات من جلسة سابقة بدلاً من الاتصال عند بدء التشغيل، وسيتصل في المرة الأولى التي يتم فيها استدعاء أداة. الأدوات متاحة منذ رسالتك الأولى، لذا لا يوجد شيء يحتاج إلى إصلاح. ذاكرة التخزين المؤقت معطلة افتراضياً ما لم يتم تفعيلها لك عبر طرح تدريجي: اضبط MCP_DISCOVERY_CACHE=0 للحفاظ على اتصال كل خادم عند بدء التشغيل، أو 1 لتفعيل ذاكرة التخزين المؤقت. للحصول على صورة أوسع، يغطي إدارة نافذة سياق Claude Code ما يتبقى بعد الضغط، ويحول ما تكلفك تلك الرموز فعلياً الأرقام إلى مبالغ مالية.

لماذا لا يتم تفعيل مهارتي أبداً؟

السبب المعتاد هو description. إنه النص الوحيد في السياق قبل تشغيل المهارة، لذا إذا لم يحدد الموقف، فلن يطابق أي شيء. اكتب المشغّل (trigger) داخل الجملة: "استخدمه عندما يسأل المستخدم عما تغير، أو يريد رسالة commit، أو يطلب مراجعة diff الخاص به." الأوصاف الغامضة تفشل بصمت، مما يجعل من الصعب ملاحظة ذلك.

السبب الثاني هو خطأ مطبعي في الـfrontmatter، وفي Claude Code يكون هذا الخطأ صامتاً أيضاً. يجب أن يطابق اسم الحقل النص تماماً، بما في ذلك الواصلات، ويتجاهل Claude Code أي حقل لا يتعرف عليه دون الإبلاغ عن خطأ. تظهر النسخة الصريحة فقط عند حزم المهارة أو رفعها إلى claude.ai أو Skills API، والتي تقبل عدداً أقل من الحقول وترفض الباقي تماماً:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

السبب الثالث هو الموقع. يتم تحميل مهارات المشروع من .claude/skills/ في دليل العمل الخاص بك وفي كل دليل أب وصولاً إلى جذر المستودع. المهارات الموجودة في الأدلة المتداخلة أسفل المكان الذي بدأت منه لا يتم تحميلها عند التشغيل. تظهر هذه المهارات في المرة الأولى التي يقرأ فيها الوكيل ملفاً أو يعدله داخل ذلك الدليل الفرعي، لذا حتى ذلك الحين لا تظهر في الإكمال التلقائي ولا يمكن استدعاؤها بالاسم.

المكافئ لـMCP لهذا الفشل الصامت هو إدخال .mcp.json مع url وبدون type. يقرأ Claude Code أي إدخال بدون type كخادم stdio، لذا يتخطى الإدخال ويبلغ عن:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

استخدام الآليات الثلاث معاً

لا تتنافس هذه الآليات على نفس الدور. الإعداد الناجح هو الذي يستخدم كل آلية حيث تكون تكلفتها منخفضة. يحتوي ملف القواعد على بضعة أسطر تنطبق في كل مكان. بينما تحتوي المهارات (Skills) على الإجراءات ولا يتم تحميلها إلا عند الحاجة إليها. أما خادم MCP واحد، أو خادمين في بعض الأحيان، فيربط الأنظمة التي لا يمكنك التنبؤ بمحتوياتها مسبقاً. إذا كنت لا تزال تبني تصورك الذهني عن الآلية الأولى، فإن ماهية مهارة الوكيل فعلياً تغطي التنسيق بالتفصيل.

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

FAQ

هل يجب عليّ كتابة مهارة (skill) أم تشغيل خادم MCP؟

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

هل لا تزال خوادم MCP تستهلك نافذة السياق (context window) الخاصة بي؟

بدرجة أقل بكثير مما كانت عليه في السابق. تم تفعيل البحث عن الأدوات افتراضياً في Claude Code الحالي، لذا يتم تحميل أسماء الأدوات وحقل تعليمات الخادم فقط عند بدء الجلسة، بينما يتم جلب المخططات الكاملة عندما يبحث عنها Claude. يشمل ذلك الآن الجلسات التي تعمل خلف بوابة LLM مضبوطة عبر ANTHROPIC_BASE_URL، بدءاً من الإصدار v2.1.304 فصاعداً. لا يزال التحميل المسبق يحدث مع ENABLE_TOOL_SEARCH=false، للخادم المضبوط على "alwaysLoad": true، على نموذج أقدم من Claude Opus 4 وSonnet 4 (أقدم من جيل 4.5 على منصة وكلاء Google Cloud)، وعلى عمليات نشر Microsoft Foundry المستضافة على Azure. شغّل /context all لمعرفة الحالة التي أنت فيها، لأن الأرقام الواردة في منشورات المقارنة القديمة تفترض التحميل المسبق.

هل يقرأ Claude Code ملف AGENTS.md؟

نعم، منذ الإصدار v2.1.277، ولكن افتراضياً فقط عندما لا يوجد CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في دليل العمل الخاص بك أو في الأدلة التي تعلوه. إذا كان مستودعك يحتوي على كليهما، يقرأ Claude ملفات CLAUDE.md فقط، لذا اجعل أحدهما يشير إلى الآخر بدلاً من الاحتفاظ بنسختين. شغّل ln -s AGENTS.md CLAUDE.md لإنشاء رابط رمزي (symlink) بسيط، أو ضع @AGENTS.md في السطر الأول من CLAUDE.md وأضف التعليمات الخاصة بـ Claude أسفله. ثم ابدأ جلسة وشغّل /context all للتأكد من ظهور CLAUDE.md ضمن ملفات الذاكرة (Memory files).

لماذا توقفت مهاراتي عن التأثير في منتصف الجلسة؟

الضغط التلقائي (Auto-compaction) هو السبب المعتاد. عندما يتم تلخيص المحادثة، يقوم Claude Code بإعادة إرفاق أحدث استدعاء لكل مهارة، مع الاحتفاظ بأول 5,000 رمز (token) من كل منها، ضمن ميزانية إجمالية قدرها 25,000 رمز لجميع المهارات. يتم ملء هذه الميزانية بدءاً من المهارة التي تم استدعاؤها مؤخراً، لذا إذا استدعيت عدة مهارات كبيرة، يتم إسقاط المهارات الأقدم تماماً. استدعِ المهارة مرة أخرى لاستعادة محتواها الكامل.

كيف أمنع تحميل ملف قواعد طويل في كل جلسة؟

انقل الأجزاء التي تهمك في بعض الأحيان فقط إلى ملفات .claude/rules/ مع حقل paths في ترويستها (frontmatter)، بحيث يتم تحميل كل منها فقط عندما يلمس الوكيل ملفاً مطابقاً. تقسيم الملف إلى استيرادات @path لا يساعد، لأن الملفات المستوردة يتم توسيعها وتحميلها عند التشغيل جنباً إلى جنب مع الملف الذي أشار إليها. أي شيء يمثل إجراءً متعدد الخطوات بدلاً من كونه حقيقة ثابتة يجب أن يتحول إلى مهارة، حيث إن نص المهارة لا يكلف شيئاً حتى يتم استدعاؤها.

هل كان هذا المقال مفيدًا؟