ربط ملفات أوبسيديان ماركداون بـ Claude Code لإنشاء محرك عمل آلي

تنظيف البيانات غير الضرورية التي يجلبها Web Clipper

تعد ملفات ماركداون التي يتم جلبها من الويب كتلة من الضجيج مثل الإعلانات وأشرطة القوائم. وجود هذه النصوص المختلطة يقلل بشكل ملحوظ من أداء RAG (توليد الاسترجاع المعزز). في الواقع، البيانات غير المنقحة تشتت انتباه النموذج، بينما تعمل ملفات ماركداون المنظمة بدقة على تحسين دقة البحث. من خلال التخلص من النصوص غير الضرورية، يمكنك تقليل عدد التوكنز (Tokens) التي يستهلكها نموذج LLM المحلي بنسبة تزيد عن 30%، مما يوفر عليك التكاليف.

يجب عليك استخدام مكتبة BeautifulSoup في بايثون لإزالة هذا الضجيج.

1. قم بإعداد البيئة عن طريق إدخال pip install beautifulsoup4 lxml في التيرمينال.
2. في السكريبت، استخدم طريقة decompose() لحذف فئات CSS غير الضرورية مثل .ad-container أو .nav-menu بالكامل.
3. استخدم محلل lxml لاستخراج نص الموضوع فقط وحفظه بتنسيق ماركداون ووضعه في مستودع أوبسيديان (Obsidian Vault).
   بهذه الطريقة، سيركز النموذج فقط على المحتوى الأساسي، مما يقلل من الهلوسة (Hallucinations) ويخفض استهلاك التوكنز إلى حوالي 25%.

تصميم المجلدات لضمان عدم ضياع Claude Code

عندما يتضخم عدد الملفات إلى المئات، يفقد حتى أذكى النماذج سياق الموضوع. لا تكتفِ بتكديس الملفات، بل قم بتقسيم المناطق بناءً على حالة المعلومات. أنا أستخدم هيكلًا مكونًا من 3 مراحل (01_Raw_Inbox، 02_Processed_Wiki، 03_Project_Action) كتعديل لإطار عمل PARA. هذا يوفر لـ Claude Code إرشادات مادية حول المعلومات التي يجب الوثوق بها والرجوع إليها.

استخدم أسماء الملفات وخيارات التيرمينال لضمان عدم تيه العميل البرمجي (Agent).

1. أضف YYYY-MM-DD قبل جميع أسماء الملفات لتعريف النموذج بمدى حداثة المعلومة.
2. عند تشغيل Claude Code، استخدم خيار --newer-than لجعله يقرأ فقط الملفات التي تغيرت خلال آخر 24 ساعة.
3. في مجلد 03_Project_Action ابقِ فقط الملفات التي تحتوي على حالة العمل.
   من خلال اعتماد هذا الهيكل، لن يقوم Claude بالبحث الغبي في كامل المستودع. وبفضل ذلك، سينتهي البحث الذي كان يستغرق 10 دقائق في 30 ثانية فقط.

سد ثغرات البحث باستخدام بيانات YAML الوصفية (Metadata)

البحث النصي البسيط لا يمكنه التمييز بين ما إذا كان هذا المستند "مهمًا" أو "عملاً منتهيًا". لذلك، يجب وضع YAML Frontmatter في الجزء العلوي من المستند. بوجود البيانات الوصفية، يمكنك إعطاء أوامر أكثر دقة لـ Claude Code.

ثلاثة حقول كافية لمحرك عمل رواد الأعمال المعرفيين:

1. اكتب topic لتقسيم المواضيع، و source_importance لتحديد الأهمية، و status لحالة العمل في الجزء العلوي من الملاحظة.
2. استخدم إضافة 'YAML Toolkit' في أوبسيديان لتطبيق هذه القواعد على مئات الملفات الموجودة دفعة واحدة.
3. في ملف إعدادات Claude Code المسمى (CLAUDE.md)، اكتب: "اطلع فقط على المستندات التي تكون حالتها (status) هي Doing لإعداد قائمة المهام".
   بهذا ستتحرر من عناء تنظيم البيانات لمدة ساعتين كل صباح، وتصبح في حالة تسمح لك بتلقي موجز العمل في 10 دقائق فقط.

روتين الموجز اليومي بأمر واحد فقط

تظهر القوة الحقيقية لـ Claude Code القائم على التيرمينال عندما يلتقي مع سكريبتات الشيل (Shell Scripts). بمجرد إدخال أمر واحد عند وصولك للعمل، يكتمل المحرك الذي يحلل ما درسته بالأمس ويستخرج حتى مسودة البريد الإلكتروني الذي سترسله اليوم. لا داعي لهدر الطاقة في التفكير فيما يجب فعله أولاً كل صباح.

يتم إعداد روتين الأتمتة كما يلي:

1. أنشئ سكريبت شيل (.sh أو .bat) يحتوي على أمر claude --bare لزيادة سرعة التشغيل الأولية.
2. امزج أمر find -mtime -1 في السكريبت لتمرير الملاحظات التي تم إنشاؤها خلال اليوم الأخير فقط إلى Claude.
3. استخدم ميزة PostToolUse في Claude Code لتصحيح الأخطاء المطبعية في مسودة البريد التي تم إنشاؤها وحفظها تلقائيًا في مجلد محدد.
   الوقت الذي كان يستغرقه كتابة بريد إلكتروني واحد سيقل من 30 دقيقة إلى 5 دقائق.

استراتيجية المرجعية الهرمية للتعامل مع انفجار البيانات

عندما يتجاوز عدد الملفات الألف، ستمتلئ نافذة السياق التي تبلغ 200 ألف توكن بسرعة. من هذه النقطة، يجب استخدام أسلوب ذو مرحلتين بجعل النموذج يطلع أولاً على master_index.md الذي يعمل كخريطة شاملة، بدلاً من جعله يقرأ كل الملفات. هذا الأسلوب يقلل عدد استدعاءات واجهة برمجة التطبيقات (API) بنسبة تقارب 60%.

للحفاظ على الأداء، يجب إدارة السياق بذكاء:

1. افهم وأدر إجمالي استهلاك التوكنز وفقًا للتكوين التالي:$$T_{total} = T_{system} + T_{index} + T_{active\_files} + T_{history}$$
2. اجعل Claude Code يقرأ الفهرس الرئيسي أولاً ليبحث فقط عن مسارات الملفات الضرورية للإجابة على السؤال.
3. اقرأ فقط الملفات الموجودة في المسارات التي تم العثور عليها لإنشاء الإجابة، وإذا طالت المحادثة، استخدم أمر /compact لتلخيص السجل.
   من خلال اعتماد هذا الهيكل الهرمي، يمكنك الحصول على دعم فوري لاتخاذ القرار دون أي تباطؤ، بغض النظر عن كمية البيانات المتراكمة.