by PromptSpace
يفشل RAG بصمت. يسترجع المستندات، ويُعيد إجابات تبدو واثقة، لكنه يُخطئ السؤال كلياً — لأن الإجابة تستلزم ربط معلومات عبر مستندات متعددة، أو الاستدلال على التسلسل، أو تتبع علاقات السببية. تمنحك هذه المهارة قائمة تشخيصية من خمسة أسئلة تُصنّف أي استعلام فاشل إما بوصفه آمناً لـ RAG أو غير متوافق معه هيكلياً، ثم تربطه بنمط الفشل المحدد والحل المعماري الذي يعالجه.
₹840 ($10)
One-time purchase
by PromptSpace
يفشل RAG بصمت. يسترجع المستندات، ويُعيد إجابات تبدو واثقة، لكنه يُخطئ السؤال كلياً — لأن الإجابة تستلزم ربط معلومات عبر مستندات متعددة، أو الاستدلال على التسلسل، أو تتبع علاقات السببية. تمنحك هذه المهارة قائمة تشخيصية من خمسة أسئلة تُصنّف أي استعلام فاشل إما بوصفه آمناً لـ RAG أو غير متوافق معه هيكلياً، ثم تربطه بنمط الفشل المحدد والحل المعماري الذي يعالجه.
₹840 ($10)
One-time purchase
⚡ Skill ready to install in Claude Code, Gemini CLI, or any MCP-compatible client. Read the install guides →
المشكلات التي تحلّها
فشل الاسترجاع الصامت — تُعيد مسارات RAG نتائج تبدو معقولة على الاستعلامات متعددة الخطوات والسببية، مما يجعل اكتشاف الأخطاء أمراً عسيراً. تقضي الفرق أسابيع في تحسين جودة التضمين واستراتيجية التقطيع قبل أن تدرك أن نوع الاستعلام هو المشكلة، لا التنفيذ.
تطبيق الحل الخاطئ — يتمحور تصحيح أخطاء RAG في الغالب حول نماذج التضمين وحجم القطع وإعادة الترتيب. وهذه هي الأدوات الصحيحة لمعالجة إخفاقات البحث الحقيقي، لكنها لا تُجدي شيئاً في حالات الفشل العلائقية والزمنية، حيث تكون البنية نفسها غير ملائمة للاستعلام.
العمى تجاه نوع الاستعلام — لا توجد مفردات معيارية للتمييز بين "ما هو X" و"كيف نشأ X" على مستوى المسار. وبدون هذا التمييز، يُوجَّه كل استعلام إلى نظام الاسترجاع ذاته بصرف النظر عن مدى ملاءمته الهيكلية.
تدهور الأداء مع التوسع — يتراجع أداء RAG على المجموعات الكبيرة ليس لأن التضمينات تسوء، بل لأن نسبة الإشارة إلى الضوضاء تنهار. تُضيف الفرق طبقات إعادة ترتيب وترى تحسناً هامشياً، غافلةً أن الاسترجاع المتدرج هو الحل الفعلي.
ما الذي ستحصل عليه
تصنيف الاستعلامات ثنائي الفئة — تقسيم واضح وقابل للتنفيذ بين الفئة A (بحث حقيقي، آمن لـ RAG) والفئة B (علائقي/زمني، منطقة خطر في RAG)، مع أمثلة ملموسة على كل منهما لتسريع التصنيف وإزالة الغموض.
قائمة تشخيصية من خمسة أسئلة — مرّر أي استعلام فاشل عبر خمسة فحوصات بنعم/لا (هل يستلزم ربط مستندات متعددة؟ هل يهم الترتيب؟ هل ثمة سلسلة سببية؟ هل يمتد عبر فترة زمنية؟ هل يسأل عن لماذا لا مجرد ماذا؟) لتصنيفه ضمن الفئة A أو الحدية أو الفئة B في أقل من دقيقتين.
أربعة أنماط فشل مُسمّاة — فشل علائقي متعدد الخطوات، وفشل التسلسل الزمني، وفشل السياق التنظيمي، وفشل التوسع — كل منها مع وصف للأعراض ومثال تطبيقي وحل معماري محدد.
قالب تقرير تصنيف الفشل — مخرج منظم (الاستعلام، الفئة، أنماط الفشل، فقرة السبب الجذري، الحل الموصى به، المراجع) يُوصل التشخيص بوضوح إلى المهندسين والمعماريين وأصحاب المصلحة غير التقنيين.
مراجع الحلول المعمارية — يرتبط كل نمط فشل مباشرةً بمهارة مرافقة (designing-hybrid-context-layers، وtemporal-reasoning-sleuth، وsynthesizing-institutional-knowledge) لتتصل عملية التشخيص فوراً بالمعالجة.
من يجب أن يستخدم هذه المهارة
المهندسون ومعماريو الذكاء الاصطناعي الذين تُعيد مسارات RAG لديهم نتائج رديئة ويحتاجون إلى تحديد ما إذا كانت المشكلة في جودة التنفيذ (قابلة للإصلاح بالضبط) أم في عدم التوافق المعماري (يستلزم نهج استرجاع مختلفاً).
الفرق التي تبني وكلاء على قواعد المعرفة التنظيمية — سجلات قرارات البنية، وتقارير الحوادث، ووثائق السياسات، وعقود الموردين — حيث ستكون بعض الاستعلامات دائماً علائقية أو زمنية بطبيعتها.
القادة التقنيون الذين يُقيّمون إضافة رسم بياني للمعرفة أو فهرس زمني أو طبقة استرجاع هجينة، ويحتاجون إلى أساس منهجي للتوصية بدلاً من الاعتماد على الحدس.
mkdir -p ~/.claude/skills/diagnosing-rag-failure-modes && curl -s -X POST 'https://api.promptspace.in/api/skills/diagnosing-rag-failure-modes/install' | python3 -c "import sys,json; sys.stdout.write(json.load(sys.stdin).get('installInstructions') or '')" > ~/.claude/skills/diagnosing-rag-failure-modes/SKILL.mdFree skills install directly. Paid skills require purchase - use the download button above after buying.
Security Scanned
Passed automated security review
No special permissions declared or detected
OpenClaw, Cursor, Claude Code, Codex CLI
PromptSpace
We build AI agent skill packages for content creators. Specializing in Chinese social media automation.