كيف يُغفَل عنه
يفشل البناء. يحاول الوكيل مجدداً. يفشل مجدداً. كل محاولة تضيف مخرجات أكثر، لكن المشكلة الجذرية لا تزال قائمة. إذا اكتفيت بالتحقق من نشاط الجلسة، قد تغفل الفشل الذي يتكرر.
تأمل وكيلاً يُعدّ تغييراً بينما تعيد أداة Shell باستمرار خطأً. قد يكون السبب تبعية مفقودة، أو أمراً غير صالح، أو وصول غير متاح. السؤال المفيد: أي أداة تفشل باستمرار، وكم مرة؟
ما يكشفه ClawMetry
يحصي ClawMetry الأخطاء المنسوبة للأداة ذاتها في نافذة الأحداث. حين يتجاوز العدد الحد المعتمد، يرفع تحذير فشل أداة متكررة. تُسمي النتيجة الأداة وعدد الإخفاقات والحد المستخدم.
الفارق الذي يغير النتيجة
مثال مُفعِّل
4 أخطاء من Bash
نتيجة تحذيرية
مقارنة هادئة
خطأ واحد من Bash
لا نتيجة لهذا الكاشف.
في المثال المفحوص، تنتج أربعة نتائج shell فاشلة تحذيراً. فشل واحد يبقى دون الحد. هذا يختلف عن حلقة استدعاء متطابقة: يمكن للأوامر أن تتغير بينما تستمر الأداة ذاتها في إعادة الأخطاء.
افحص نتيجة الكاشف
{
"kind": "repeated_tool_failure",
"severity": "warning",
"evidence": {
"tool": "Bash",
"failures": 4,
"threshold": 3,
"threshold_source": "static"
}
}كيف تم فحص المثال
تُقيِّم هذه الأمثلة الكاشف المنشور باستخدام بيانات أحداث محررة أو ملفات إعداد مؤقتة. الفيديوهات توضح تلك السلوكيات. ليست تسجيلات لوكلاء حية أو لواجهة المنتج. لم يُنفَّذ أي أمر في الأمثلة.
تحدد النتيجة السلوك لهذه المدخلات. لا تُثبت استيعاب بيئة التشغيل أو الوقاية أو اختراقاً فعلياً. افحص عقد المصدر المثبَّت.
ماذا تفحص بعد ذلك
افتح النتائج الفاشلة وابحث عن السبب المشترك. أصلح مشكلة البيئة أو الوصول، أو ضيِّق نطاق مهمة الوكيل قبل أن تتراكم المحاولات. ثم تحقق من أن نتيجة الأداة التالية تنجح فعلاً.
- اقرأ نتائج الأخطاء
- أصلح السبب المشترك
- تحقق من النتيجة التالية
ما تُثبته هذه الإشارة
هذه إشارة موثوقية. لا تشخص السبب الجذري ولا تُثبت أن الوكيل يتعرض لهجوم.