هل سبق وأن واجه فريقك موقفًا حيث توقفت إعدادات وكيل الترميز الخاص بك – سواء كان ذلك CLAUDE.md أو مهاراته أو خطافاته – عن العمل كما هو متوقع؟ غالبًا ما يحدث هذا بسبب تغييرات خفية في الخلفية، وقد لا تكتشف المشكلة إلا بعد أسابيع. هنا يأتي دور مدقق انحراف التكوين (Config Drift Checker) ليقدم الحل.
ما هو انحراف التكوين ولماذا يهم؟
إن مهارات وخطافات CLAUDE.md أصبحت جزءًا لا يتجزأ من طريقة كتابة التعليمات البرمجية اليوم. ومع ذلك، فإن هذه التكوينات عرضة للتغيير المستمر من مصادر متعددة؛ فقد يقوم Claude Code بإصدار تحديثات متكررة، أو قد يتغير النموذج الأساسي وراء اسم مستعار مثل sonnet من جانب الخادم دون سجل تغيير واضح، أو قد يقوم أحد أعضاء الفريق بتعديل مهارة في طلب سحب (PR) دون اختبار كافٍ. غالبًا ما يتم اكتشاف هذه التغييرات بعد أن يلاحظ مطور ما أن الوكيل توقف عن تشغيل الاختبارات قبل الالتزام، وهو ما يحدث عادة بعد أسابيع من المشكلة الأصلية.
تقديم الحل: مدقق انحراف التكوين
يحوّل مدقق انحراف التكوين (Config Drift Checker) ما يجب أن يفعله إعدادك إلى حالات اختبار قابلة للتنفيذ. يقوم بعد ذلك بتشغيل الوكيل الفعلي مقابل هذه الحالات ويحتفظ بالنتائج بمرور الوقت، مما يوفر لك رؤية شاملة وحماية استباقية.
كيف يعمل مدقق انحراف التكوين؟
يعمل هذا المدقق من خلال عملية منهجية تضمن تغطية شاملة:
- حالات الاختبار: يتم تعريف حالات الاختبار بتنسيق
claude plugin evalالخاص بـ Anthropic، بما في ذلك الموجهات والمصنفات (مثل التعبيرات العادية، استخدام الأدوات، الملفات، وقواعد تقييم نماذج اللغة الكبيرة LLM)، بالإضافة إلى سقالات اختيارية لإعداد مستودع مؤقت أو نسخ مصدرك الحقيقي. يقوم المدقق تلقائيًا بكتابة الحالات الأولية من إعدادك الفعلي لكي لا تبدأ من الصفر. - التشغيل: يتم تشغيل الاختبارات عند كل إصدار جديد من Claude Code، وفي كل طلب سحب (PR) يمس الإعداد، أو عند الطلب. يتم ذلك في مساحة عمل سريعة، مع تحميل المكون الإضافي الخاص بك، ويتم تشغيل كل حالة عدة مرات.
- النتائج والأسباب: لا يكتفي المدقق بإعطاء درجة، بل يقدم حكم كل مصنف وشرحًا من المقيم، واستدعاءات الأداة، والاستجابة الكاملة، مما يوفر رؤية عميقة لما حدث.
- المقارنة مع خط الأساس: يقوم المدقق بمقارنة النتائج الحالية مع خط الأساس، مما يؤدي إلى فحص باللون الأحمر أو الأخضر، وتعليق على طلبات السحب، وتنبيهات Slack، وتقرير HTML مفصل، ولوحة معلومات لكل حالة في كل إصدار من إصدارات Claude Code، والتي يتم عرضها من فرع النتائج الخاص بك بواسطة GitHub Pages.
ميزات متقدمة لمدقق انحراف التكوين
يقدم المدقق ميزتين رئيسيتين مبنيتين فوق هذه الآلية الأساسية:
- الاختبار الإزالى (Ablation): يتم تشغيل نفس الحالات مع وبدون المكون الإضافي الخاص بك. يخبرك الفرق بالقيمة الفعلية لكل مهارة أو خطاف. على سبيل المثال، في العرض التوضيحي الخاص بنا، كان خطاف الأمان (safety hook) هو الوحيد الذي أوقف أمرًا مدمرًا بشكل موثوق، بينما لم تضيف مهارة الاصطلاحات شيئًا لم يكن موجودًا بالفعل في قاعدة التعليمات البرمجية و CLAUDE.md.
- الحالات المولدة: يقرأ المدقق تكوين المهارة ويكتب حالات التعليمات البرمجية الحقيقية، وحالات التشغيل السلبية، وحالات الخطاف لها، ثم يقوم بإصلاح أدوات الصف الخاصة بها للتأكد من نجاحها.
ما ليس كذلك: يجب التوضيح أن مدقق انحراف التكوين ليس أداة تحليل (linter) لـ CLAUDE.md (فهو يشغل الوكيل الفعلي)، ولا هو اختبار للجودة العامة للنموذج (فهو يختبر تكوينك الخاص على مهامك الخاصة)، كما أنه ليس خدمة مستضافة (يعمل على جهازك وفي نظام التكامل المستمر CI الخاص بك باستخدام مفتاحك، ولا يتم إرسال أي شيء إلى أي مكان). يعمل المدقق مع أي قاعدة تعليمات برمجية، فهو يختبر سلوك الوكيل، وليس تطبيقك.
التكامل السلس والتثبيت
للبدء، قم بإضافة المدقق إلى سوق مكونات كلود الإضافية ثم تثبيته:
claude plugin marketplace add jameskomo/config-drift-checkerclaude plugin install config-drift-checker@jameskomo
بعد ذلك، في المستودع الذي ترغب في حماية إعداده:
claude> /config-drift-checker:setup
ستقوم هذه الخطوات بالبحث عن CLAUDE.md ومهاراتك وخطافاتك، وكتابة حالات التقييم الأولية منها، وتشغيلها، وكتابة سير عمل GitHub. كل ما عليك فعله هو إضافة سر واحد (ANTHROPIC_API_KEY) والدفع بالرمز (push). ومنذ ذلك الحين، سيتم تشغيل المجموعة مع كل إصدار جديد من Claude Code وكل طلب سحب يمس إعدادك، مما يوفر لك فحصًا باللون الأحمر أو الأخضر، وتعليقًا على طلب السحب، وتنبيهًا عبر Slack، وتقرير HTML مفصل مع سبب لكل حالة.
إذا كان لديك مجموعة اختبار بالفعل، أو كنت ترغب فقط في إعداد التشغيل، يمكنك استخدام هذا في إجراءات GitHub:
- uses: jameskomo/config-drift-checker/action@v0 with: { plugin-dir: . }
لمشاهدة الأمر من البداية إلى النهاية، يمكنك زيارة المثال التوضيحي: config-drift-checker-demo.
بنية المشروع الرئيسية
يتضمن المشروع المكونات الأساسية التالية: المكون الإضافي لمدقق انحراف التكوين نفسه، والذي يحتوي على مهارات الإعداد والتشغيل وكتابة الحالات؛ مجموعة من الأدوات المساعدة مثل eval-shim.mjs لتشغيل الاختبارات، وeval-diff.mjs لمقارنة النتائج، وeval-report.mjs لإنشاء تقارير HTML، وeval-dashboard.mjs لعرض لوحات المعلومات التاريخية، بالإضافة إلى release-watch.mjs لتتبع إصدارات Claude Code. كما يتضمن خطاف الأمان safety-net.mjs، وإجراءات GitHub المركبة للتثبيت والمقارنة والتخزين والإبلاغ والتنبيه، وأمثلة لمكونات إضافية مع نتائج خط الأساس، وقسم توثيق شامل يغطي دليل المستخدم والهندسة المعمارية والأمان.
الموارد والتوثيق
للبدء، نوصي بالاطلاع على دليل المستخدم. يمكن العثور على الفهرس الكامل للوثائق في قسم المستندات.
الترخيص
يخضع المشروع لترخيص FSL-1.1-أباتشي-2.0، وهو مجاني للاستخدام والتعديل والاستضافة الذاتية، مع قيد عدم تقديمه كخدمة تجارية منافسة. يصبح كل إصدار Apache-2.0 بعد عامين من النشر.
في عالم التطوير السريع لوكلاء الذكاء الاصطناعي، يعد الحفاظ على استقرار وموثوقية التكوينات أمرًا بالغ الأهمية. يوفر مدقق انحراف التكوين أداة قوية وفعالة لمساعدة فرقك على اكتشاف المشكلات المحتملة ومعالجتها قبل أن تؤثر على سير العمل. بفضل قدرته على تتبع التغييرات، وتحويل التوقعات إلى اختبارات، وتقديم تقارير مفصلة، يضمن لك هذا المدقق أن وكلاء CLAUDE.md ومهاراتهم وخطافاتهم تعمل دائمًا كما هو مخطط لها.