لا يزال يعمل. لا يتقدم.

كيف يُغفَل عنه

وكيلك لا يزال يعمل. الطرفية في حركة مستمرة. لكنه طلب الشيء نفسه للمرة الخامسة. النشاط قد يبدو مطمئناً حتى حين تكون الجلسة عالقة في حلقة.

تخيل مهمة برمجية يظل فيها الوكيل يتحقق من حالة Git. مرة واحدة مفيد. خمس استدعاءات متطابقة تتالياً قد تعني أنه فقد خطوته التالية. عبر جلسات متعددة، يسهل إغفال هذا النمط حتى تعود إلى المهمة ذاتها غير منتهية.

ما يكشفه ClawMetry

يبحث ClawMetry عن استدعاءات أدوات متكررة بنفس المعطيات، ودورات قصيرة متكررة من أسماء الأدوات. حين يتجاوز التكرار الحد المعتمد، يرفع تحذير حلقة متوقفة. تخبرك النتيجة بالنمط والأداة وعدد التكرارات.

الفارق الذي يغير النتيجة

في المثال المفحوص، تنتج خمس استدعاءات متطابقة لحالة Git تحذيراً. ثماني استدعاءات بمعطيات ملفات مختلفة لا تُفعِّل هذا الكاشف. الفارق المهم هو الإجراء المتكرر. يمكن أن تعكس الحدود بيئة التشغيل وخطها الأساسي المكتسب، فخمسة مثال لا قاعدة شاملة.

{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}

ماذا تفحص بعد ذلك

افحص الخطوة المتكررة ونتائجها. هل ينتظر الوكيل شيئاً لا يمكن تغييره؟ هل يحتاج تبعية مفقودة أو إجراء تالٍ أوضح؟ استخدم النتيجة لكسر الحلقة بنفسك، ثم تحقق من استئناف العمل المفيد.

1. افحص الخطوة المتكررة
2. تحقق مما يغيب
3. حدد الإجراء التالي بوضوح