● مجتمع
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 هو سجل عمل. يمكن تثبيته عالميًا أو لكل مشروع أو لكل مساحة عمل.
لماذا تستخدمه
الميزات الأساسية
- الكنسي المكون من أربعة ملفات: bugs.md، وsolutions.md، وkey_facts.md، وissues.md
- يقرأها كلود قبل أن يقترح التغييرات المعمارية
- يمكن تثبيته عبر Skillz (pip) أو نسخة عادية
- لا توجد قاعدة بيانات — فقط Markdown يمكنك الاختلاف والمراجعة
عرض مباشر
كيف يبدو في الممارسة
project-memory-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: project-memory
متى تستخدمه: لقد كنت تستخدم Claude Code في هذا الريبو ولكن السياق يعيد ضبط كل جلسة.
المتطلبات الأساسية
- بايثون 3.10+ لتثبيت Skillz — pyenv أو نظام بايثون
الخطوات
-
تثبيت في نطاق المشروع
تثبيت النقطة سكيلز && سكيلز تثبيت SpillwaveSolutions_project-memory/project-memory --scope project✓ تم النسخ
→ يظهر .claude/skills/project-memory/SKILL.md
-
قم بتشغيل أمر التمهيد
/ ذاكرة المشروع - تهيئة الملفات الأربعة لهذا الريبو.✓ تم النسخ
→ docs/project_notes/ التي تم إنشاؤها باستخدام الملفات الأساسية الأربعة
-
قرارات البذور.md مع 2-3 خيارات معروفة
قم بإضافة ADRs لاختيار ORM الخاص بنا، واتفاقية معالجة الأخطاء الخاصة بنا، ومشغل CI الخاص بنا.✓ تم النسخ
→ ثلاثة مداخل ADR مرتبة
النتيجة: يتمتع كلود الآن بعقل مثابر وقابل للمراجعة لهذا الريبو.
المزالق
- إلزام key_facts.md بالأسرار — تشير المهارة بشكل واضح إلى key_facts.md على أنها "غير حساسة" - لا تضع بيانات الاعتماد هناك أبدًا
متى تستخدمه: لقد أصلحت للتو شيئًا صعبًا وتريد أن يدوم الدرس.
الخطوات
-
اطلب من كلود تسجيله
أضف هذا إلى bugs.md — كان الخطأ هو NonType في billing.retry؛ السبب الجذري: ذاكرة التخزين المؤقت لمفتاح العجز التي لا معنى لها؛ الوقاية: TTL على ذاكرة التخزين المؤقت.✓ تم النسخ
→ إدخال bugs.md جديد مع السبب الجذري + الوقاية
النتيجة: كتالوج الأخطاء الذي يؤتي ثماره في المرة القادمة التي تظهر فيها أعراض مماثلة.
المزالق
- كتابة العرض بدلاً من السبب — فرض الإدخال على قسم "السبب الجذري" و"المنع" - وليس فقط "ما أصلحته"
متى تستخدمه: يستمر وكيلك في اقتراح الأطر/الأنماط التي رفضها الفريق بالفعل.
الخطوات
-
تأكد من أن القرار موجود في القرارات.md
السجل: "نحن نستخدم نمط المستودع، وليس السجل النشط." الأساس المنطقي: <x>.'✓ تم النسخ
→ مسح ADR في القرارات.md
-
اطلب إعادة البناء
اقتراح إعادة بناء src/billing/ - احترام قراراتنا.md.✓ تم النسخ
→ يشير الاقتراح إلى قرار المستودع ولا يقترح Active Record
النتيجة: عدد أقل من المقترحات المسدودة التي يتم رفضها أثناء المراجعة.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
استخدم ذاكرة المشروع للملفات الأربعة الأساسية المنسقة، وذاكرة البنك-mcp للذاكرة العاملة ذات الشكل الحر عبر المشاريع
كتابة ADRs المنظمة إلى القرارات.md؛ تفريغ ملاحظات الجلسة الأولية في بنك الذاكرة.✓ تم النسخ
بعد دمج العلاقات العامة، قم بتحديث القرارات.md والقضايا.md كجزء من وصف العلاقات العامة
افتح العلاقات العامة وقم بتضمين الفرق في القرارات.md في الوصف.✓ تم النسخ
project-memory-skill +
gitقم بمراجعة اختلافات الذاكرة قبل الالتزام بالحفاظ عليها صادقة
git diff docs/project_notes/ — اقرأ قبل الالتزام؛ إصلاح أي شيء مضلل.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا أحد
- الرموز لكل استدعاء
- يعتمد ذلك على عدد الملفات الأربعة التي يقوم كلود بتحميلها؛ إبقاء الإدخالات قصيرة
- التكلفة المالية
- حر
- نصيحة
- تفضل الإدخالات القصيرة والمؤرخة على السرد الطويل، حيث يقوم كلود بمسحها ضوئيًا في كل جلسة، لذا فإن الحجم مهم.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: بشكل صريح: key_facts.md مخصص للتكوين غير الحساس فقط. احتفظ بالأسرار في إنف أو قبو، ليس هنا.
نقل البيانات الخارجي: الملفات المحلية؛ لا يوجد نشاط شبكي من المهارة نفسها
- إذا قمت بإلزام docs/project_notes/ بمستودع عام، فتذكر أن كلود ربما يكون قد سجل تفاصيل داخلية - قم بمراجعتها قبل الدفع.
- لا تسمح للوكلاء بالإلحاق التلقائي بالقرارات.md دون مراجعة؛ هذا هو المكان الذي يؤدي فيه السياق القديم أو الخاطئ إلى تآكل النظام بأكمله.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
كلود يتجاهل القرارات.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 | تريد إطار ذاكرة أكثر تفصيلاً | إعداد أثقل |