أوقف الاختصارات التي يتخذها الوكلاء. نظّف الديون التقنية المتراكمة لديك.

اختبار تم تخطيه، خطأ مخفي، رمز مؤقت، أو فحص نوع مكتوم؛ تكتشف أداة anti-slop هذه في كل تغيير يقوم به الوكلاء، وتُرسل التغييرات مرة أخرى مع كل نتيجة؛ بينما يصلح تنظيف الديون الأسبوعي الديون القديمة.

مهمةتطبيق أكواد القسائم عند إتمام عملية الشراءقيد المراجعة
بوابات الجودة
مطور بوابة الجودةحاول تنفيذ 2تمت الموافقة
Anti-slop
لا دينونة برمجية جديدةتمت الموافقة
0 تعيق العمل · تم إدخال 0 · تم تعديل 1 · موجودة من 14
مطور بوابة الجودةحاول تنفيذ 1محجوب · تم إرساله إلى مطور
Anti-slop
لا دينونة برمجية جديدةتحتاج إلى إصلاح
2 تعيق العمل · تم إدخال 2 · تم تعديل 1 · موجودة من 14
  • اختبار تم تخطيهsrc/checkout/coupon.test.ts:88it.skip('rejects an expired coupon', …)
  • خطأ تم ابتلاعهsrc/checkout/apply-coupon.ts:41} catch {}
مشكلات تم العثور عليها
  • تم إصلاحهاختبار تم تخطيهAnti-slop
  • تم إصلاحهخطأ تم ابتلاعهAnti-slop

عرض المهمة هو إعادة تصور لبوابة CoRoid. المهمة والملفات والنتائج الموجودة فيه هي للتوضيح فقط.

قواعد
١١٦
مجموعات
١٣
قواعد تحظر التغيير بشكل افتراضي
٤٦
نتائج موجودة تحظر التغيير
٠

ما الذي يبحث عنه النظام

تُصنّف القواعد في عائلات؛ حيث يمنع كل قاعدة أو يقدم توصية أو يسجل الملاحظات فقط؛ ويمكن للمالك تغيير ذلك على مستوى المؤسسة أو لكل مشروع.

اختبارات
اختبارات مركزة أو تم تخطيها، اختبارات محذوفة، تأكيدات تم إزالتها أو أصبحت أضعف، اختبارات لا يمكن أن تفشل، وعمليات إعادة تشغيل تخفي اختبارًا غير مستقر.
  • .only
  • .skip
  • expect(true).toBe(true)
عمليات كتم
تعطيلات تنبيهات جديدة، أخطاء نوعية تم تجاهلها، تحويلات إلى أي نوع، وكتلة كود مستبعدة من التغطية.
  • @ts-ignore
  • as any
  • eslint-disable
بناء وCI
خطوات اختبار تم إزالتها أو سُمح لها بالفشل، حدود تغطية أقل، عمليات تشغيل اختبارات تمر دون اختبارات، خطافات التزام تم تخطيها، ومخرجات بناء تم الالتزام بها.
  • continue-on-error: true
  • --passWithNoTests
أدلة اختبار
عملية تشغيل اختبار لم تقم بتشغيل أي شيء، عدد اختبارات أقل من آخر عملية تشغيل ناجحة، عملية تشغيل جزئية تم الإبلاغ عنها على أنها كاملة، ونتائج مخزنة مؤقتًا قديمة تم عرضها كعملية تشغيل جديدة.
  • Tests: 0 total
  • --onlyChanged
كود الإنتاج
كود موضعي، كود تصحيح أخطاء، ملاحظات مثل "في تنفيذ حقيقي"، تعليمات موجهة للأشخاص، بيانات محاكاة، وكود إنتاج يستورد كود اختبار.
  • throw new Error('Not implemented')
  • debugger;
معالجة الأخطاء
أخطاء تم إخفاؤها أو استبدالها بقيمة افتراضية، عمليات تحقق من الصلاحيات تسمح بالوصول حتى عند فشلها، وعمليات إعادة تشغيل بدون حد.
  • except: pass
  • .catch(() => {})
أمان
البيانات السرية المشفرة في الكود، وتعطيل فحوصات TLS، وإزالة عمليات تسجيل الدخول، وسماح CORS باستخدام بيانات الاعتماد، وإنشاء استعلامات SQL من سلاسل نصية. الأمن هو من يملك هذه القواعد ويحدد ما ستفعله.
  • rejectUnauthorized: false
  • verify=False
هندسة معمارية
حلقات استيراد جديدة، عمليات استيراد عبر الحدود التي حددتها، كتل مكررة، كود تركه التغيير دون استخدام، ونسخ جديدة من أنماط قمت بإلغائها.
تبعيات
ملف تكوين تغيّر دون ملف القفل الخاص به، مكتبة ثانية لمهمة تقوم بها مكتبة واحدة بالفعل، إصدارات لم يتم تثبيتها، وتحديثات لم يطلبها أحد.
  • "latest"
تخزين مؤقت
مفاتيح ذاكرة تخزين مؤقتة بدون المستأجر، ذاكرات تخزين مؤقتة في الذاكرة لا تنتهي صلاحيتها، وقيم وقت البناء التي يجب أن يقرأها الكود أثناء تشغيله.
تعليقات
تعليقات تكرر السطر التالي، أو تصف التعديل، أو تحيد عنه، أو تتعارض مع الكود المجاور لها.
  • // Updated to
  • // should work
نطاق التغيير
ملفات لا تتضمنها المواصفات، تغييرات في التنسيق فقط، وإعادة تسمية لم تكن مطلوبة في المهمة.
مسار العمل الخاص بالوكيل
ما قام به الوكيل أثناء عمله، مثل حذف الاختبار الذي فشل، أو تغيير قيمة متوقعة لتصبح ما طبعته عملية الفشل.

يتم حظر فقط ما تم إدخاله حديثًا عبر التغييرات

تحتوي معظم المستودعات بالفعل على بعض هذه الأنماط. يصنّف anti-slop كل نتيجة حسب مصدرها، كي لا تعرقل الديون القديمة العمل الجديد.

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

نقل الكود لا يُعد إدخالاً له. أما نسخه فهو كذلك.

اصلح الديون القديمة، قليلاً كل أسبوع.

الديون القديمة لا تعيق العمل، لكن ليس من الضروري أن تبقى. فعّل تنظيف الديون الأسبوعي لمشروع ما، وستقوم CoRoid بإصلاحه على خطوات صغيرة.

  • كل أسبوع، تفحص CoRoid الفرع الافتراضي بحثًا عن الديون الموجودة.
  • وتنشئ مهام تنظيف صغيرة تضم بضع ملفات في كل مرة.
  • أنت تحدد عدد مهام التنظيف التي يمكن أن تكون مفتوحة في آن واحد، حتى تأتي طلباتك أولاً.
  • يتم اختبار كل مهمة تنظيف ومراجعتها مثل أي مهمة أخرى، وتوافق أنت على pull request.
مراقبة الجودة
حدد المعايير التي يتم وفقها فحص كل مشروع؛ يُطبق التغيير فورًا على الأعمال الجديدة بمجرد إعداده.
مكافحة الفوضى
واجهة المتجر
مدى انتشار التغيير
ينطبق على كل عمليات التحقق من مكافحة الفوضى في هذا الإعداد.
دقيقمتوازنتصحيحي
ما الذي يتم فحصه
المجموعات الحاجزة تعيد التغيير إلى الوراء، بينما المجموعات الاستشارية تقوم بالإبلاغ فقط.
  • اختباراتحواجز
  • عمليات قمعحواجز
  • كود الإنتاجحواجز
  • معالجة الأخطاءحواجز
  • تعليقاتتوصيات
  • نطاق التغييرتوصيات
هذا المستودع
يتم الإبلاغ عن الديون الموجودة دون حظرها، حتى يستمر العمل غير المرتبط بها في التقدم.
١٤٢ نتائج موجودة في الخط الأساسي السابق
تنظيف الديون أسبوعيًا
كل أسبوع، يفحص CoRoid الفرع الافتراضي ويُنشئ مهام تنظيف صغيرة للديون الموجودة، بحيث لا يتجاوز عدد المهام المفتوحة ٢ مهام في كل مرة.
مهام مفتوحة في كل مرة2

أنت من يحدد مدى اتساع نطاق التغيير المسموح به.

تحدد انضباطية التغيير لوكيل المطور ما يمكنه تنظيفه أثناء عمله.

  1. جراحيفقط ما تحتاجه المواصفات. أما المشاكل الأخرى فيتم الإبلاغ عنها، ولا يتم إصلاحها.
  2. متوازنافتراضيكما يصلح مشاكل صغيرة في الأسطر التي يعدلها التغيير على أي حال.
  3. إصلاحيكما ينظف النتائج الموجودة في الدوال التي يعدلها التغيير.

يتبع وكيل المطور نفس القواعد.

لا يقتصر دور anti-slop على التقييم في النهاية. يتلقى الوكيل القواعد أثناء كتابة التغيير، ولا يمكنه تجاوزها.

  1. يبدأ الوكيل بانضباطية التغيير الخاصة بك والأنماط التي حظرتها، كل منها مع النمط الذي يجب استخدامه بدلاً منه.
  2. يرى القواعد السريعة بعد كل تعديل، ويحصل على فرصة واحدة لإصلاح النتائج المحظورة قبل تشغيل اختبارات الجودة.
  3. لا يمكن للوكلاء قبول نتائجهم الخاصة. إذا قال وكيل إن اختبارًا كان خاطئًا وقام بتغييره، فيجب على المراجع الموافقة على ذلك التغيير.
  4. يمكن لملف مستودع، .coroid/anti-slop.yml، إضافة قواعد واستبعاد مسارات تم إنشاؤها. تقرأه CoRoid من قاعدة التغيير، بحيث لا يمكن للتغيير إضعاف قواعده الخاصة.

يقوم الوكلاء بإنشاء أسماء للحزم البرمجية، ويقوم المهاجمون بتسجيلها.

يُطلق على هذا اسم slopsquatting. يقترح نموذج حزمة غير موجودة. ينشر شخص ما حزمة بهذا الاسم، ووكيل التالي الذي يقوم بتثبيتها يشغل كوده.

في دراسة شملت 2.23 مليون عينة كود من 16 نموذجًا، وجد أن 19.7% منها تضمنت اسم حزمة غير موجودة. وعند تشغيل نفس الاستعلامات عشر مرات، ظهرت 43% من تلك الأسماء في كل مرة، مما يسمح للمهاجمين بتوقعها.
المصدر: ملاحظة بحثية من تحالف الأمان السحابي، أبريل 2026.

ما الذي تتحقق منه CoRoid في كل تبعية جديدة؟

  • تقوم CoRoid بالبحث عن كل حزمة npm أو PyPI يضيفها الوكيل في سجلها العام.
  • إذا كانت الحزمة غير موجودة، يتم إعادة التغيير إلى وكيل المطور. ويجب على المالك أولاً التأكد من أن مشاريعكم تُثبت البرامج من السجلات العامة.
  • تقوم CoRoid بتمييز الحزمة للمراجعة إذا كان عمرها أقل من 30 يومًا. كما تميز الأسماء التي تختلف بحرف أو حرفين عن حزمة شائعة، والحزم npm ذات عدد التنزيلات القليل جدًا.
  • تحت نفس الإعداد، تُعاد التغييرات أيضًا إذا كانت الحزمة مدرجة كضارة في قاعدة بيانات OSV. بالنسبة لـ PyPI، لا تعرف CoRoid الإصدار الذي سيقوم متطلب ما بتثبيته، لذا يتم تصنيف التحذيرات المتعلقة بإصدارات معينة فقط.
  • تقوم CoRoid بتمييز حزم npm الجديدة التي تنفذ كودًا عند تثبيتها (برامج تثبيت).

ماذا لو تم تثبيت حزمة ضارة على أي حال؟

تُنفذ أوامر الوكلاء في بيئة معزولة. ولا تحتوي على مفاتيح مزود النماذج، أو رموز المستودع، أو متغيرات سرية من مشاريعكم.

تنتمي هذه القواعد إلى فحص الكود في قسم الأمان. وهي تتحقق من التبعيات التي يضيفها التغيير. أما بالنسبة للحزم الموجودة لديكم، فيراقب قسم الأمان الإعلانات الجديدة المتعلقة بها.

طبّق نفس القواعد على الوكلاء الذين لديك بالفعل.

يمكن للمهندسين الذين يستخدمون وكلاء برمجة خاصين بهم الاستفادة من قواعد مؤسستك أيضًا.

AGENTS.md snippet
قم بتنزيل قسم لتعليمات وكلائك، مع انضباطية التغيير في المشروع، والأنماط المحظورة، وأهم القواعد.
CoRoid MCP Server
anti_slop_rules يصف سياسة المنظمة المنشورة. anti_slop_scan يفحص فرعًا من مشروع متزامن. كلاهما للقراءة فقط.
CoRoid ضبط الجودة على طلبات السحب
مع تفعيل عمليات التحقق من pull request، تُجرى نفس العملية على طلبات سحب GitHub التي يفتحها مطوريكم، وتُوضح كل نتيجة على سطرها.

تم اختباره أولاً على كودنا الخاص.

CoRoid مبني على CoRoid، لذا فإن anti-slop عمل على مستودع CoRoid الخاص قبل أن يعمل على مستودعات الآخرين.

فحص لكل ملف مصدر

لقد فحصنا جميع ملفات المصدر ١١٬٥٣٦ في مستودع CoRoid وكأن وكيلًا قد كتبها للتو. كشف الفحص عن 6 نمطًا اعتبرتها القواعد خاطئة. قمنا بإصلاحها، وانخفض عدد النتائج التي تسبب حظرًا من ٥٬٣٦٦ إلى ٢٬٢٥٣.

ما لا يزال يحظره هو ما يجب أن تكتشفه القواعد، مثل ملاحظة في كود الإشعارات لدينا: "في تنفيذ حقيقي، ستقوم بجلب رمز FCM الخاص بالمستخدم."

القواعد التي يحكم عليها النموذج

تطلب قاعدتان من النموذج تقييم سطر واحد في كل مرة: تفقد وجود شيء يمنعه الكود مسبقًا، وتبحث عن تعليق يتعارض مع الكود المجاور له. كلاهما يقدمان نصيحة فقط. من بين ٦٠٠ سطرًا من التغييرات المدمجة الفعلية، قاما بتمييز ليس رقمًا عن طريق الخطأ، وتكلف كل عملية فحص ما يصل إلى ‏٠٫٠٠١٥ US$.

قم بتفعيله ضمن عنصر التحكم في الجودة.

يمكن للمالكين والمسؤولين تفعيل anti-slop كإعداد افتراضي للمؤسسة أو لمشروع واحد. وسيستخدمه التشغيل التالي لذلك المشروع.

  1. افتح وحدة التحكم في الجودة واختر الإعداد الافتراضي للمؤسسة أو مشروعًا.
  2. فعّل anti-slop. سيضيف خمسة متطلبات إلى السياسة.
  3. اختر مستوى انضباط التغيير والمجموعات التي يؤدي إخفاقها إلى الحظر. ويمكنك أيضًا تفعيل التنظيف الأسبوعي للديون لمشروع واحد. إذا أوقفت anti-slop، فسيحتفظ CoRoid بهذه الإعدادات للمرة القادمة.

الخمسة متطلبات التي يضيفها

  • الاختبارات لا تزال تثبت صحة التغيير
  • لا يتم إرسال أي شيء غير مكتمل أو مخصص للاختبار فقط إلى الإنتاج
  • لا يوجد دين تقني هيكلي جديد
  • يبقى التغيير ضمن النطاق ويتماشى مع بنية الكود الحالية
  • الحزم الجديدة حقيقية وموثوقة.
اقرأ دليل anti-slop
مراقبة الجودة
حدد المعايير التي يتم وفقها فحص كل مشروع؛ يُطبق التغيير فورًا على الأعمال الجديدة بمجرد إعداده.
واجهة المتجرإعداد مخصص
يعمل عند فحص المهام، طلبات السحب، والتحقق من الإصدارات.
عمليات التفتيش على كل تغيير
أي تغيير يفشل في اجتياز عملية التفتيش يعود إلى المطور قبل أن يقوم أي شخص بمراجعته.
  • مكافحة الفوضىتُعيد التغيير إلى المصدر إذا أدى إلى إضعاف اختبارات الوحدة، أو إخفاء الأخطاء، أو نشر عناصر نائبة، أو إضافة ديون تقنية.
  • اختبارات الوحدةتكتشف اختبارات الوحدة الموجودة في المستودع وتنفذها مع كل تغيير يتم إدخاله.
  • اختبارات المتصفح2 من أصل 3يختلف عن الإعداد الافتراضيتشغل سيناريوهات التصفح الخاصة بك لتقييم التغييرات المدخلة.
  • الترجماتيختلف عن الإعداد الافتراضيتتحقق من ترجمة النصوص المعدلة والتأكد من تطابق العناصر النائبة وأشكال الجمع فيها.
  • عمليات تفتيش المستودعتنفذ الأوامر المخصصة لديك، مثل تنسيق الكود، وقياس حجم الملفات، وتشغيل اختبارات التكامل، وفحوصات الأمان.
ضمان الجودة
  • ضمان جودة شاملشاملتجمع أداة ضمان الجودة أدلة ولقطات شاشة حية مقارنةً بالمواصفات المحددة؛ وعند تعطيلها، يتم تطبيق إجراءات ضمان الجودة القياسية.

راجع فقط الأعمال التي اجتازت الفحص.

فعّل خاصية anti-slop لمشروع واحد، واطلع على ما سيتم إرساله قبل رؤية العمل النهائي.