حلقه گیر

هنوز در حال اجرا. هیچ جایی نمی‌رود.

اقدام تکراری پنهان‌شده در یک جلسه پرمشغله را شناسایی کنید.

مشکل را ببینید. یافته را درک کنید.

روایت انگلیسی با زیرنویس.

چگونه نادیده گرفته می‌شود

عامل شما هنوز در حال کار است. ترمینال همچنان پیش می‌رود. اما همان چیز را برای پنجمین بار درخواست کرده است. فعالیت می‌تواند آرامش‌بخش به نظر برسد، حتی وقتی جلسه در یک حلقه گیر کرده است.

تصور کنید یک وظیفه کدنویسی که عامل به طور مکرر وضعیت Git را بررسی می‌کند. یک بار مفید است. پنج فراخوانی یکسان پشت سر هم ممکن است به معنای از دست دادن گام بعدی باشد. در طول چند جلسه، این الگو به راحتی قابل غفلت است تا زمانی که دوباره به همان وظیفه ناتمام برگردید.

آنچه ClawMetry شناسایی می‌کند

ClawMetry به دنبال فراخوانی‌های ابزار تکراری با آرگومان‌های یکسان و چرخه‌های کوتاه تکراری از نام ابزارها می‌گردد. وقتی تکرار از آستانه مربوطه عبور کند، یک هشدار حلقه گیر ایجاد می‌کند. یافته الگو، ابزار و تعداد تکرار را به شما نشان می‌دهد.

تفاوتی که یافته را تغییر می‌دهد

مثال محرک

5 فراخوانی یکسان

یافته هشداری

مقایسه بدون هشدار

8 آرگومان متفاوت

هیچ یافته‌ای برای این آشکارساز وجود ندارد.

در مثال بررسی‌شده، پنج فراخوانی یکسان وضعیت Git یک هشدار ایجاد می‌کند. هشت فراخوانی با آرگومان‌های متفاوت برای این آشکارساز ساکت می‌ماند. تفاوت مهم اقدام تکراری است. آستانه‌ها می‌توانند منعکس‌کننده زمان اجرا و خط پایه یادگرفته‌شده آن باشند، بنابراین پنج یک مثال است، نه یک قانون جهانی.

نتیجه آشکارساز را بررسی کنید
{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}
ورودی‌ها و نتایج کامل را دانلود کنید (JSON)
چگونه مثال بررسی شد

این مثال‌ها آشکارساز منتشرشده را با داده‌های رویداد نوشته‌شده یا فایل‌های پیکربندی موقت ارزیابی می‌کنند. ویدیوها آن رفتارها را نشان می‌دهند. آنها ضبط عوامل زنده یا رابط محصول نیستند. هیچ دستوری در مثال‌ها اجرا نشده است.

نتیجه رفتار را برای این ورودی‌ها تعیین می‌کند. این نتیجه جذب زمان اجرا، پیشگیری یا یک نقض واقعی را ثابت نمی‌کند. قرارداد منبع ثابت‌شده را بررسی کنید.

آنچه بعداً باید بررسی کنید

مرحله تکراری و نتایج آن را بررسی کنید. آیا عامل منتظر چیزی است که نمی‌تواند تغییر کند؟ آیا به یک وابستگی گمشده یا یک اقدام بعدی واضح‌تر نیاز دارد؟ از یافته برای شکستن چرخه استفاده کنید، سپس بررسی کنید آیا کار مفید از سر گرفته می‌شود.

  1. مرحله تکراری را بررسی کنید
  2. بررسی کنید چه چیزی کم است
  3. یک اقدام بعدی مشخص تعریف کنید

آنچه این سیگنال ثابت می‌کند

تکرار می‌تواند عمدی باشد. این یافته علت را تعیین نمی‌کند، جلسه را متوقف نمی‌کند یا هزینه را محدود نمی‌کند.

لحظه‌های مهم را مرئی نگه دارید.

فعالیت عامل را دنبال کنید، یافته‌ها را بررسی کنید و تصمیم بگیرید چه چیزی نیاز به توجه دارد.