مهمة صغيرة. ثلاثون ملفاً تغيّرت.

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

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

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

ما يكشفه ClawMetry

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

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

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

{
  "kind": "file_blast_radius",
  "severity": "warning",
  "evidence": {
    "distinct_files": 30,
    "write_calls": 30,
    "threshold": 25,
    "threshold_source": "static",
    "baseline": null,
    "outside_workspace": 0,
    "destructive": [],
    "samples": [
      "example/f0.py",
      "example/f1.py",
      "example/f2.py"
    ],
    "observed": "tool_arguments"
  }
}

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

قارن النطاق المتأثر بالطلب الأصلي. افحص الفارق الفعلي، ولا سيما التغييرات المولّدة والحذوفات. تأكد من أن الاختبارات تغطي الملفات المعنية قبل قبول النتيجة. الهدف هو اكتشاف التغيير غير المتوقع الواسع بينما لا يزال السياق حاضرًا لديك.

1. قارن النطاق بالمهمة
2. راجع الفروق الفعلية
3. تحقق من الاختبارات والحذف