/ الدليل / الملعب / project-memory
← كل الخوادم ↗ GitHub
● مجتمع SpillwaveSolutions ⚡ فوري

project-memory

بواسطة SpillwaveSolutions · SpillwaveSolutions/project-memory

أربعة ملفات يمكن قراءتها بواسطة الإنسان - bugs.md، وsolutions.md، وkey_facts.md، وissues.md - يقرأها كلود قبل اقتراح التغييرات. ذاكرة المشروع بدون قاعدة بيانات.

ذاكرة المشروع هي مهارة كلود كود التي تقوم بتثبيت أربع ملاحظات خفيفة الوزن ضمن docs/project_notes/ وتعلم كلود الرجوع إليها قبل إجراء تغييرات معمارية. على عكس MCPs الخاصة ببنك الذاكرة، فهي ملفات عادية تقوم بمراجعتها في العلاقات العامة: يلتقط bugs.md أنماط الخطأ باستخدام استراتيجيات الوقاية، وcisions.md هو سجل ADR الخاص بك، وkey_facts.md يحتوي على تكوين غير حساس، وissues.md هو سجل عمل. يمكن تثبيته عالميًا أو لكل مشروع أو لكل مساحة عمل.

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

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

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

عرض مباشر

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

project-memory-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "project-memory-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

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

claude mcp add project-memory-skill -- pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory

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

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

استخدامات عملية: project-memory

ذاكرة مشروع Bootstrap على قاعدة تعليمات برمجية موجودة

👤 سئمت الفرق من إعادة شرح نفس السياق لوكيلهم ⏱ ~15 min beginner

متى تستخدمه: لقد كنت تستخدم Claude Code في هذا الريبو ولكن السياق يعيد ضبط كل جلسة.

المتطلبات الأساسية
  • بايثون 3.10+ لتثبيت Skillz — pyenv أو نظام بايثون
الخطوات
  1. تثبيت في نطاق المشروع
    تثبيت النقطة سكيلز && سكيلز تثبيت SpillwaveSolutions_project-memory/project-memory --scope project✓ تم النسخ
    → يظهر .claude/skills/project-memory/SKILL.md
  2. قم بتشغيل أمر التمهيد
    / ذاكرة المشروع - تهيئة الملفات الأربعة لهذا الريبو.✓ تم النسخ
    → docs/project_notes/ التي تم إنشاؤها باستخدام الملفات الأساسية الأربعة
  3. قرارات البذور.md مع 2-3 خيارات معروفة
    قم بإضافة ADRs لاختيار ORM الخاص بنا، واتفاقية معالجة الأخطاء الخاصة بنا، ومشغل CI الخاص بنا.✓ تم النسخ
    → ثلاثة مداخل ADR مرتبة

النتيجة: يتمتع كلود الآن بعقل مثابر وقابل للمراجعة لهذا الريبو.

المزالق
  • إلزام key_facts.md بالأسرار — تشير المهارة بشكل واضح إلى key_facts.md على أنها "غير حساسة" - لا تضع بيانات الاعتماد هناك أبدًا
اجمعها مع: memory-bank-mcp

التقط السبب الجذري للخطأ حتى لا يعود أبدًا

👤 مهندسون تحت الطلب يقومون بإخماد حريق ⏱ ~5 min beginner

متى تستخدمه: لقد أصلحت للتو شيئًا صعبًا وتريد أن يدوم الدرس.

الخطوات
  1. اطلب من كلود تسجيله
    أضف هذا إلى bugs.md — كان الخطأ هو NonType في billing.retry؛ السبب الجذري: ذاكرة التخزين المؤقت لمفتاح العجز التي لا معنى لها؛ الوقاية: TTL على ذاكرة التخزين المؤقت.✓ تم النسخ
    → إدخال bugs.md جديد مع السبب الجذري + الوقاية

النتيجة: كتالوج الأخطاء الذي يؤتي ثماره في المرة القادمة التي تظهر فيها أعراض مماثلة.

المزالق
  • كتابة العرض بدلاً من السبب — فرض الإدخال على قسم "السبب الجذري" و"المنع" - وليس فقط "ما أصلحته"
اجمعها مع: github

اسمح لكلود باستشارة القرارات.md قبل اقتراح إعادة البناء

👤 الفرق التي تكره إعادة التقاضي بشأن الخيارات المستقرة مع وكيلها ⏱ ~10 min beginner

متى تستخدمه: يستمر وكيلك في اقتراح الأطر/الأنماط التي رفضها الفريق بالفعل.

الخطوات
  1. تأكد من أن القرار موجود في القرارات.md
    السجل: "نحن نستخدم نمط المستودع، وليس السجل النشط." الأساس المنطقي: <x>.'✓ تم النسخ
    → مسح ADR في القرارات.md
  2. اطلب إعادة البناء
    اقتراح إعادة بناء src/billing/ - احترام قراراتنا.md.✓ تم النسخ
    → يشير الاقتراح إلى قرار المستودع ولا يقترح Active Record

النتيجة: عدد أقل من المقترحات المسدودة التي يتم رفضها أثناء المراجعة.

اجمعها مع: git

التركيبات

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

project-memory-skill + memory-bank-mcp

استخدم ذاكرة المشروع للملفات الأربعة الأساسية المنسقة، وذاكرة البنك-mcp للذاكرة العاملة ذات الشكل الحر عبر المشاريع

كتابة ADRs المنظمة إلى القرارات.md؛ تفريغ ملاحظات الجلسة الأولية في بنك الذاكرة.✓ تم النسخ
project-memory-skill + github

بعد دمج العلاقات العامة، قم بتحديث القرارات.md والقضايا.md كجزء من وصف العلاقات العامة

افتح العلاقات العامة وقم بتضمين الفرق في القرارات.md في الوصف.✓ تم النسخ
project-memory-skill + git

قم بمراجعة اختلافات الذاكرة قبل الالتزام بالحفاظ عليها صادقة

git diff docs/project_notes/ — اقرأ قبل الالتزام؛ إصلاح أي شيء مضلل.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
/project-memory subcommand: init|add-bug|add-decision|add-fact|log-issue قم بتمهيد الملفات وتسجيل الإدخالات الجديدة 0

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

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

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

الأمان

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

تخزين بيانات الاعتماد: بشكل صريح: key_facts.md مخصص للتكوين غير الحساس فقط. احتفظ بالأسرار في إنف أو قبو، ليس هنا.
نقل البيانات الخارجي: الملفات المحلية؛ لا يوجد نشاط شبكي من المهارة نفسها

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

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

/ لم يتم التعرف على أمر ذاكرة المشروع

لم يتم تثبيت المهارة في النطاق المتوقع. أعد التثبيت باستخدام Skillz وأعد تشغيل Claude.

تحقق: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/
كلود يتجاهل القرارات.md

التأكد من أن القرارات.md تحتوي على إدخالات واضحة بنمط ADR مع رؤوس "القرار" و"الأساس المنطقي"؛ الحصول على منزوع الدسم النقاط النقطية الغامضة.

تحقق: head docs/project_notes/decisions.md
الملفات تستمر في النمو

الأرشفة ربع سنوية - انقل الإدخالات القديمة إلى docs/project_notes/archive/ بحيث تظل الملفات النشطة قابلة للفحص.

تحقق: wc -l docs/project_notes/*.md

البدائل

project-memory مقابل البدائل

البديلمتى تستخدمهاالمقايضة
memory-bank-mcpتريد الوصول إلى الذاكرة المشتركة بين المشاريع عن طريق الأداة، وليس الملفاتالمزيد من المرونة، وأقل وضوحًا في مراجعات العلاقات العامة
codebase-memoryتريد رسمًا بيانيًا رمزيًا للكود، وليس ملاحظات سرديةطبقة مختلفة من الذاكرة
marm-systemsتريد إطار ذاكرة أكثر تفصيلاًإعداد أثقل

المزيد

الموارد

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

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

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