● مجتمع
BayramAnnakov
⚡ فوري
claude-reflect
بواسطة BayramAnnakov · BayramAnnakov/claude-reflect
Claude Code الذي يتعلم بهدوء من طريقة تصحيحك له — يلتقط القواعد والتفضيلات والإطراء، ثم يكتبها في CLAUDE.md / AGENTS.md.
يعمل claude-reflect في خلفية جلسات Claude Code، يراقب اللحظات التي تُصحّح فيها أو تُثني على تفضيلاتك أو تُعيد تأكيدها. يُقطّر هذه اللحظات إلى قواعد دائمة ويحدّث CLAUDE.md و AGENTS.md حتى تستفيد منها الجلسات المستقبلية. بديل خفيف الوزن لتنظيم ملف التعليمات يدوياً.
لماذا تستخدمه
الميزات الأساسية
- يكتشف التصحيحات الضمنية ('في الواقع، افعلها هكذا') والإشارات الإيجابية
- يصيغ إضافات القواعد؛ تعتمدها قبل وضعها في CLAUDE.md
- نفس القواعد تظهر في AGENTS.md للأدوات غير-Claude
- توحيد دوري يزيل القواعد المتناقضة أو القديمة
- تحديثات قائمة على الفروق تُبقي تاريخ git مقروءاً
عرض مباشر
كيف يبدو في الممارسة
جاهز
حالات الاستخدام
استخدامات عملية: claude-reflect
متى تستخدمه: تريد أن يواكب CLAUDE.md تفضيلاتك دون أن يكون عبئاً في الكتابة.
الخطوات
-
العمل باعتيادية
Just code with Claude as usual. Correct it when wrong, praise it when right.✓ تم النسخ
→ المهارة تلتقط بصمت — لا تلاحظها
-
مراجعة نهاية اليوم
Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ تم النسخ
→ 5-10 قواعد مرشحة مع المصدر (أي جلسة، أي prompt)
-
الالتزام بالفرق
Apply approved rules and commit CLAUDE.md.✓ تم النسخ
→ فرق git نظيف؛ القواعد مُفعَّلة الآن
النتيجة: CLAUDE.md ينمو معك، لا ضريبة صيانة يدوية.
المزالق
- المهارة تلتقط سياقاً لمرة واحدة كقواعد دائمة — راجع دائماً المرشحين اليوميين؛ ارفض أي شيء ظرفي
متى تستخدمه: مطورون متعددون يُصحّحون Claude على أشياء مشابهة؛ تريد مجموعة قواعد مشتركة.
الخطوات
-
جمع مسودات لكل مطور
Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ تم النسخ
→ فرع مع N مسودات معلقة
-
دمج الجلسات
Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ تم النسخ
→ مجموعة قواعد أرضية مشتركة
-
الطرح
Merge to main. New AGENTS.md applies to everyone.✓ تم النسخ
→ الفريق يستخدم نفس الأساس؛ القواعد الخاصة بكل مطور تبقى
النتيجة: توحيد من القاع إلى الأعلى دون لجنة إجراءات.
المزالق
- المطورون الصاخبون يهيمنون؛ أنماط الهادئين تُفوَّت — تأكد أن الجميع يشغّل المهارة؛ رجّح بأحداث التأمل لا تعديلات الملفات
متى تستخدمه: CLAUDE.md الخاص بك الآن 600 سطراً وسياق Claude منتفخ.
الخطوات
-
تسجيل درجة الصلة
Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ تم النسخ
→ درجة لكل قاعدة
-
اقتراح الحذف
Suggest 30 rules to remove (stale or obsolete).✓ تم النسخ
→ قائمة حذف مع المبرر
-
الفرق والالتزام
Apply approved removals; commit with message 'reflect: prune stale rules'.✓ تم النسخ
→ CLAUDE.md أكثر إيجازاً
النتيجة: CLAUDE.md الذي يُقرأ فعلاً، لا يُتصفَّح.
المزالق
- حذف قاعدة لم تُطبَّق لأن Claude كان يحترمها — في حالة الشك، احتفظ بها — لكن ضع علامة 'آخر تحقق' حتى تراجعها في الربع القادم
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
pro-workflow للالتقاط الصريح، claude-reflect للسلبي — قناتا تعلم
Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ تم النسخ
تغييرات قواعد قابلة للمراجعة عبر PR
Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء — محلي
- الرموز لكل استدعاء
- الالتقاط في الخلفية مجاني؛ المراجعة/التوحيد تستخدم نموذجاً محلياً إذا ضُبط
- التكلفة المالية
- مجاني
- نصيحة
- اعتمد المرشحين بتحفظ — الجودة > الكمية
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: filesystem-write
تخزين بيانات الاعتماد: حالة المهارة في .claude/reflect/؛ الالتزام بالمستودع إذا أردت مشاركتها
نقل البيانات الخارجي: لا شيء افتراضياً
- سجلات التأمل قد تتضمن مقتطفات كود حساسة — أضف السجل الخام إلى gitignore؛ الزم فقط القواعد المُقطَّرة
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
لا مرشحات مُلتقطة
تحقق أن المهارة مُستدعاة في مقدمة CLAUDE.md؛ تحقق من .claude/reflect/log للإدخالات
المرشحات ضوضاء
شدّد حساسية المُشغِّل؛ التقط فقط من التصحيحات الصريحة، لا من المحادثة العامة
AGENTS.md ينجرف من CLAUDE.md
شغّل consolidate دورياً؛ الأداة مُصمَّمة لإبقائهما متزامنين لكن التعديلات اليدوية تُفرّقهما
موجة اعتماد ساحقة
شغّل المراجعة مع --limit 5 يومياً؛ ابنِ عادة بدلاً من معالجة 50 مرة واحدة
البدائل
claude-reflect مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| pro-workflow-skill | تفضل الالتقاط الصريح وتنسيق worktree | أكثر يدوية؛ أقوى للعمل المتوازي |
| Manual CLAUDE.md curation | أنت منضبط كفاية لكتابة القواعد بنفسك | يُهمَل كثيراً؛ يعتمد على الإرادة |