/ الدليل / الملعب / Understand-Anything
● مجتمع Lum1104 ⚡ فوري

Understand-Anything

بواسطة Lum1104 · Lum1104/Understand-Anything

إعداد مرئي لأي قاعدة كود — شبكات معرفية هيكلية ومجالية تُعلّم النظام بدلاً من مجرد رسمه.

يحوّل Understand-Anything قواعد الكود وقواعد المعرفة إلى شبكات تفاعلية. عرض ثنائي الطبقة: هيكلي (الملفات / الدوال / الفئات) ومجالي (العمليات التجارية / تدفقات البيانات). يتضمن بحثاً دلالياً ('ما الذي يتعامل مع المصادقة؟') وتحليل أثر التغيير ومستويات تفصيل تكيفية. مُصمَّم لتأهيل الفرق الجديدة وفهم المعمارية، لا للصور الجميلة.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "understand-anything-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "understand-anything-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Lum1104/Understand-Anything",
        "~/.claude/skills/understand-anything"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "understand-anything-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Lum1104/Understand-Anything",
          "~/.claude/skills/understand-anything"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add understand-anything-skill -- git clone https://github.com/Lum1104/Understand-Anything ~/.claude/skills/understand-anything

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Understand-Anything

تأهيل مهندس جديد لقاعدة كود بـ 200 ألف سطر

👤 قادة تقنيون يؤهّلون موظفين جدد، أو مطورون منفردون يتبنّون مشروعاً ⏱ ~60 min intermediate

متى تستخدمه: مستودع جديد، ولديك أسبوع لتشعر بالإنتاجية.

المتطلبات الأساسية
  • المهارة مثبتة — git clone https://github.com/Lum1104/Understand-Anything ~/.claude/skills/understand-anything
الخطوات
  1. فهرسة المستودع
    Use understand-anything. Build the structural graph for ./repo and the domain graph from /docs.✓ تم النسخ
    → إحصاءات الشبكة (العقد، الحواف، الكثافة)
  2. إيجاد نقاط الالتحام الأساسية
    Highlight the 5 most-connected modules — likely architectural seams.✓ تم النسخ
    → قائمة مرتبة مع المبرر
  3. تتبع ميزة واحدة
    Walk me through 'create checkout' end-to-end across structural + domain graphs.✓ تم النسخ
    → مسار مُشروح عبر العقد؛ يشرح التقاطعات التجارية والتقنية

النتيجة: إنتاجية في أيام لا أسابيع؛ قراءة موجّهة بدلاً من الاستكشاف العشوائي.

المزالق
  • الشبكة كثيفة جداً فتصبح غير مقروءة — فلتر حسب المجلد أو الميزة؛ المهارة تدعم مستويات تفصيل تكيفية
اجمعها مع: filesystem

التنبؤ بأثر التغيير قبل فتح PR

👤 المطورون على وشك لمس كود مشترك ⏱ ~25 min intermediate

متى تستخدمه: أنت على وشك إعادة هيكلة وحدة 'تبدو حاملة للعبء'.

الخطوات
  1. تحديد التغيير
    Use understand-anything. I'll change the signature of calculateTax(price, region) to add a customer_class. What breaks?✓ تم النسخ
    → قائمة المُستدعين والاختبارات التي تحتاج تحديثاً
  2. تصوير نطاق الأثر
    Show me the subgraph touched by this change.✓ تم النسخ
    → شبكة فرعية مُضاءة مع درجة خطورة لكل حافة
  3. تخطيط PR
    Propose a PR sequence that minimizes review surface — which files first?✓ تم النسخ
    → قائمة ملفات مرتبة مع المبرر

النتيجة: PR مُحدَّد للمراجعة البشرية، لا وحش بـ 1500 سطر.

المزالق
  • الشبكة تُغفل المُستدعين في وقت التشغيل (reflection, dynamic dispatch) — تحقق بـ grep لاسم الدالة؛ اذكر المُستدعين في وقت التشغيل منفصلاً

تحويل wiki إلى شبكة معرفية

👤 الباحثون / الفرق ذات الـ wikis المترامية ⏱ ~45 min intermediate

متى تستخدمه: لديك wiki بـ 200 صفحة؛ لا أحد يستطيع إيجاد أي شيء.

الخطوات
  1. استيعاب الصفحات
    Use understand-anything. Build a knowledge graph from /wiki/. Extract entities and implicit relationships.✓ تم النسخ
    → شبكة بأنواع كيانات + أنواع علاقات
  2. إيجاد الأطراف الميتة
    Which entities are referenced but never defined?✓ تم النسخ
    → قائمة موضوعات مشار إليها تحتاج صفحات
  3. اقتراح إعادة التنظيم
    Based on cluster structure, propose a 5-section TOC.✓ تم النسخ
    → قائمة أقسام مع الصفحات المخصصة

النتيجة: wiki يمكنك التنقل فيه فعلاً.

المزالق
  • العلاقات الضمنية تصبح ضوضاء (كل صفحة تذكر 'API') — اضبط قائمة توقف المستخرج؛ المهارة تكشف إعداداً للمصطلحات الضوضائية الشائعة
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

understand-anything-skill + filesystem

الاحتفاظ بالشبكات المُولَّدة لإعادة استخدام الفريق

Save the graph to .claude/graphs/ and check in. Refresh on each main merge.✓ تم النسخ
understand-anything-skill + git-mcp-idosal

بناء شبكة لمستودع عام بعيد دون استنساخ محلي

Use gitmcp for the repo source; pipe into understand-anything to build the graph in memory.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
build_structural_graph repo_path, languages? الخطوة الأولى على مستودع جديد 0
build_domain_graph docs_path الإقران مع الهيكلي للصورة الكاملة 0
semantic_search intent_query 'ما الذي يتعامل مع X؟' — البحث بالمعنى 0
impact_analysis node_id, change_kind تقييم التغيير ما قبل PR 0
feature_walkthrough feature_name وضع التأهيل / التعليمي 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا شيء — مهارة محلية
الرموز لكل استدعاء
بناء الشبكة رخيص؛ الاستعلامات تُعيد 200-1500 رمز حسب حجم الشبكة الفرعية
التكلفة المالية
مجاني
نصيحة
ابنِ مرة واحدة لكل main، خزّن مؤقتاً؛ أعد البناء في عمليات إعادة الهيكلة الكبيرة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: filesystem-read
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البناء بطيء على مستودع ضخم

مرّر --include و --exclude لتحديد النطاق؛ تخطَّ مجلدات generated/vendor

الاستدعاءات متعددة اللغات مفقودة

المهارة تعمل بشكل أفضل على مستودعات بلغة واحدة لكل مرور؛ لـ polyglot ابنِ شبكات منفصلة وارتبط يدوياً

الشبكة المجالية فارغة

مسار /docs لا يحتوي محتوى يتعرف عليه المستخرج؛ جرّب /README + /design-docs

المخرج كثيف جداً للقراءة

خفّض مستوى التفصيل؛ أو فلتر لشبكة فرعية لميزة بدلاً من عرض الشبكة الكاملة

البدائل

Understand-Anything مقابل البدائل

البديلمتى تستخدمهاالمقايضة
graphify-skillتريد مهارة شبكة كود أخف وزناًقدرة أقل في الشبكة المجالية
Sourcegraphتريد بحثاً في الكود على مستوى المؤسسة مع واجهة رسوميةمدفوع؛ حمل إعداد

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills