/ الدليل / الملعب / claude-reflect
● مجتمع BayramAnnakov ⚡ فوري

claude-reflect

بواسطة BayramAnnakov · BayramAnnakov/claude-reflect

Claude Code الذي يتعلم بهدوء من طريقة تصحيحك له — يلتقط القواعد والتفضيلات والإطراء، ثم يكتبها في CLAUDE.md / AGENTS.md.

يعمل claude-reflect في خلفية جلسات Claude Code، يراقب اللحظات التي تُصحّح فيها أو تُثني على تفضيلاتك أو تُعيد تأكيدها. يُقطّر هذه اللحظات إلى قواعد دائمة ويحدّث CLAUDE.md و AGENTS.md حتى تستفيد منها الجلسات المستقبلية. بديل خفيف الوزن لتنظيم ملف التعليمات يدوياً.

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

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

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

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

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

استخدامات عملية: claude-reflect

تطوير CLAUDE.md دون تنظيم يدوي

👤 المطورون المنفردون الذين يكرهون الاحتفاظ بملفات توثيق ⏱ ~5 min beginner

متى تستخدمه: تريد أن يواكب CLAUDE.md تفضيلاتك دون أن يكون عبئاً في الكتابة.

المتطلبات الأساسية
  • المهارة مثبتة — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
  • التأمل مُفعَّل — أضف use claude-reflect إلى مقدمة CLAUDE.md للمشروع
الخطوات
  1. العمل باعتيادية
    Just code with Claude as usual. Correct it when wrong, praise it when right.✓ تم النسخ
    → المهارة تلتقط بصمت — لا تلاحظها
  2. مراجعة نهاية اليوم
    Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ تم النسخ
    → 5-10 قواعد مرشحة مع المصدر (أي جلسة، أي prompt)
  3. الالتزام بالفرق
    Apply approved rules and commit CLAUDE.md.✓ تم النسخ
    → فرق git نظيف؛ القواعد مُفعَّلة الآن

النتيجة: CLAUDE.md ينمو معك، لا ضريبة صيانة يدوية.

المزالق
  • المهارة تلتقط سياقاً لمرة واحدة كقواعد دائمة — راجع دائماً المرشحين اليوميين؛ ارفض أي شيء ظرفي
اجمعها مع: filesystem

بناء اتفاقيات ذكاء اصطناعي للفريق من التصحيحات الجماعية

👤 القادة التقنيون الذين يُوحّدون سير عمل الذكاء الاصطناعي ⏱ ~60 min intermediate

متى تستخدمه: مطورون متعددون يُصحّحون Claude على أشياء مشابهة؛ تريد مجموعة قواعد مشتركة.

الخطوات
  1. جمع مسودات لكل مطور
    Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ تم النسخ
    → فرع مع N مسودات معلقة
  2. دمج الجلسات
    Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ تم النسخ
    → مجموعة قواعد أرضية مشتركة
  3. الطرح
    Merge to main. New AGENTS.md applies to everyone.✓ تم النسخ
    → الفريق يستخدم نفس الأساس؛ القواعد الخاصة بكل مطور تبقى

النتيجة: توحيد من القاع إلى الأعلى دون لجنة إجراءات.

المزالق
  • المطورون الصاخبون يهيمنون؛ أنماط الهادئين تُفوَّت — تأكد أن الجميع يشغّل المهارة؛ رجّح بأحداث التأمل لا تعديلات الملفات
اجمعها مع: github

مراجعة وتقليص القواعد القديمة في CLAUDE.md

👤 المستخدمون القدامى لـ CLAUDE.md ⏱ ~25 min intermediate

متى تستخدمه: CLAUDE.md الخاص بك الآن 600 سطراً وسياق Claude منتفخ.

الخطوات
  1. تسجيل درجة الصلة
    Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ تم النسخ
    → درجة لكل قاعدة
  2. اقتراح الحذف
    Suggest 30 rules to remove (stale or obsolete).✓ تم النسخ
    → قائمة حذف مع المبرر
  3. الفرق والالتزام
    Apply approved removals; commit with message 'reflect: prune stale rules'.✓ تم النسخ
    → CLAUDE.md أكثر إيجازاً

النتيجة: CLAUDE.md الذي يُقرأ فعلاً، لا يُتصفَّح.

المزالق
  • حذف قاعدة لم تُطبَّق لأن Claude كان يحترمها — في حالة الشك، احتفظ بها — لكن ضع علامة 'آخر تحقق' حتى تراجعها في الربع القادم

التركيبات

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

claude-reflect-skill + pro-workflow-skill

pro-workflow للالتقاط الصريح، claude-reflect للسلبي — قناتا تعلم

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ تم النسخ
claude-reflect-skill + github

تغييرات قواعد قابلة للمراجعة عبر PR

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
watch_session عملية خلفية دائمة التشغيل 0
review_candidates since? حلقة اعتماد يومية / أسبوعية 0
consolidate scope? إزالة التكرار / حل التناقض الدوري 0
score_rules مراجعة ما قبل التقليص 0
apply_to_files approved_ids[], files[] وضع المرشحين المعتمدين في CLAUDE.md / AGENTS.md 0

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

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

حصة API
لا شيء — محلي
الرموز لكل استدعاء
الالتقاط في الخلفية مجاني؛ المراجعة/التوحيد تستخدم نموذجاً محلياً إذا ضُبط
التكلفة المالية
مجاني
نصيحة
اعتمد المرشحين بتحفظ — الجودة > الكمية

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-write
تخزين بيانات الاعتماد: حالة المهارة في .claude/reflect/؛ الالتزام بالمستودع إذا أردت مشاركتها
نقل البيانات الخارجي: لا شيء افتراضياً

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

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

لا مرشحات مُلتقطة

تحقق أن المهارة مُستدعاة في مقدمة CLAUDE.md؛ تحقق من .claude/reflect/log للإدخالات

المرشحات ضوضاء

شدّد حساسية المُشغِّل؛ التقط فقط من التصحيحات الصريحة، لا من المحادثة العامة

AGENTS.md ينجرف من CLAUDE.md

شغّل consolidate دورياً؛ الأداة مُصمَّمة لإبقائهما متزامنين لكن التعديلات اليدوية تُفرّقهما

موجة اعتماد ساحقة

شغّل المراجعة مع --limit 5 يومياً؛ ابنِ عادة بدلاً من معالجة 50 مرة واحدة

البدائل

claude-reflect مقابل البدائل

البديلمتى تستخدمهاالمقايضة
pro-workflow-skillتفضل الالتقاط الصريح وتنسيق worktreeأكثر يدوية؛ أقوى للعمل المتوازي
Manual CLAUDE.md curationأنت منضبط كفاية لكتابة القواعد بنفسكيُهمَل كثيراً؛ يعتمد على الإرادة

المزيد

الموارد

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

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

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