/ الدليل / الملعب / mex
← كل الخوادم ↗ GitHub
● مجتمع theDakshJaitly ⚡ فوري

mex

بواسطة theDakshJaitly · theDakshJaitly/mex

سقالة ذاكرة المشروع + كاشف الانجراف — تبقي وكلاء الترميز الذكي متجذّرين في الحالة الفعلية لمشروعك، لا في لقطة الأمس.

تُثبّت mex سقالة ذاكرة منظمة في مستودعك (البنية، الاصطلاحات، العمل الجاري، العوائق) وتشحن أداة CLI تكشف الانجراف بين الذاكرة والواقع. عندما تتعارض تغييرات الكود مع الذاكرة، تُشير CLI إليها لتتمكن من التحديث أو إعادة المحاذاة. خفيفة الوزن — مصممة للعيش في المستودع والانتقال مع الفريق.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

جاهز

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

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

استخدامات عملية: mex

إعداد ذاكرة المشروع في بداية مشروع جديد

👤 أصحاب المستودعات الجديدة ⏱ ~25 min beginner

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

الخطوات
  1. التهيئة
    Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ تم النسخ
    → سقالة /.mex/ مُنشأة بالقوالب
  2. ملء البذور
    Auto-extract architecture from existing code and a starter convention list.✓ تم النسخ
    → الأقسام مُبذّرة بمحتوى ابتدائي
  3. تعيين الحداثة
    Mark each section verified today.✓ تم النسخ
    → علامات الحداثة مُعيَّنة

النتيجة: مشروع جديد يبدأ بسياق وكيل مشترك.

المزالق
  • الاستخراج التلقائي يجلب تفاصيل غير ذات صلة — اقطع بلا رحمة — الذاكرة للمبادئ لا للبحث
اجمعها مع: filesystem

إيجاد أين تختلف ذاكرة المشروع مع الكود

👤 أصحاب المشاريع طويلة الأمد ⏱ ~30 min intermediate

متى تستخدمه: الذاكرة أُعدّت منذ أشهر؛ لا أحد متأكد من قدم التحديث.

الخطوات
  1. تشغيل الكشف عن الانجراف
    Use mex. Run drift detection. Report claims that no longer match reality.✓ تم النسخ
    → تقرير انجراف مع دليل ↔ مطالبة
  2. التحديث أو الحذف
    For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ تم النسخ
    → قرار لكل عنصر؛ فتح PRs لإصلاحات جانب الكود
  3. إعادة التحقق
    After resolving, mark sections verified today.✓ تم النسخ
    → الذاكرة محاذاة مجدداً

النتيجة: الذاكرة تبقى عقداً موثوقاً لا موروثاً شعبياً.

المزالق
  • كاشف الانجراف يُبلّغ بشكل مفرط — ضبط --strictness؛ استخدم 'medium' للمشاريع الحية
اجمعها مع: github

تسليم العمل الجاري بين أعضاء الفريق

👤 المطورون المقبلون على إجازة / المغادرون ⏱ ~20 min beginner

متى تستخدمه: لديك 3 مميزات قيد التطوير وشخص آخر يحتاج الاستلام.

الخطوات
  1. التقاط العمل الجاري
    Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ تم النسخ
    → مدخلات في /.mex/in-flight/
  2. التحقق بـ CLI
    Run drift on in-flight; ensure entries reflect actual branch state.✓ تم النسخ
    → انجراف نظيف
  3. التسليم
    Generate a teammate-ready summary linking each entry to its branch.✓ تم النسخ
    → ملخص جاهز للـ Slack/بريد إلكتروني

النتيجة: استلام سلس؛ لا حاجة للتنقيب.

المزالق
  • مدخلات العمل الجاري غامضة ('أعمل على X') — أجبر حقل 'الخطوات التالية' في القالب؛ ملموس أو لن يُفيد

التركيبات

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

mex-skill + filesystem

الذاكرة تعيش في المستودع؛ أودعها

Commit /.mex/ to git so memory travels with the codebase.✓ تم النسخ
mex-skill + github

فحص CI للانجراف على PRs

On every PR, run mex drift and post the report as a PR comment.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
init scaffold_options مرة واحدة لكل مشروع 0
drift section?, strictness? أسبوعياً / قبل دمج الفروع طويلة الأمد 0 (uses local checks + LLM for fuzzy claims)
verify section بعد تحديث الذاكرة لمطابقة الواقع 0
in_flight_add branch, goal, next_steps عند بدء فرع ميزة جديدة 0
summary format التسليم / تقرير الحالة 0

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

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

حصة API
لا يوجد — محلي
الرموز لكل استدعاء
الانجراف يستخدم LLM للمطالبات الغامضة؛ محدود لكل تشغيل
التكلفة المالية
مجاني
نصيحة
استخدم strict=high في CI لاكتشاف الانجراف الحقيقي؛ medium للفحوصات اليومية المحلية

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-write
تخزين بيانات الاعتماد: لا يوجد
نقل البيانات الخارجي: لا يوجد إلا إذا كان LLM للانجراف مُعدَّداً لمزود بعيد

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

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

الانجراف يُبلّغ بإيجابيات كاذبة

خفّض الصرامة؛ أو صغ المطالبة بشكل أكثر قابلية للتحقق

الذاكرة تنمو بلا حدود

لكل قسم حد أقصى غير رسمي؛ دمّج دورياً — احتفظ بالمبادئ، أرشف التفاصيل

CLI لا تجد /.mex/

شغّل من جذر المستودع؛ أو مرّر --root <path>

الاستخراج التلقائي يفوّت الثوابت الأساسية

الاستخراج التلقائي مجرد بداية؛ اكتب الثوابت الحرجة يدوياً

البدائل

mex مقابل البدائل

البديلمتى تستخدمهاالمقايضة
claude-mem-skillتريد استمرارية الجلسة لا ذاكرة معرفة المشروعمشكلة مختلفة؛ mex للثوابت على مستوى المشروع
Plain CLAUDE.mdمشروع صغير، لا حاجة لكشف الانجرافلا بنية؛ لا فحوصات حداثة آلية
pilot-shell-skillتريد المواصفات/الخطة/البوابات إضافة إلى استمرارية المعرفةسطح عمل أوسع؛ آراء أكثر

المزيد

الموارد

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

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

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