مراجعة عمل الوكيل دون إعادة قراءة كل شيء

المراجعة قائمة تحقّق، لا تدقيق شامل

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

1. 1

   امشِ على المعايير، وتحقّق من كل ادّعاء.

   يقول المعيار «الطلب الحادي والستون يعيد 429 مع Retry-After»؟ أرسل 61 طلبًا، أو اقرأ الاختبار الذي يفعل ذلك. دقيقتان لكل معيار على الأكثر. وإن استغرق التحقق أطول من ذلك، فـالمعيار كان باهظًا أكثر مما ينبغي؛ عالج ذلك في المنبع للمرة القادمة.
2. 2

   اقرأ الفرق بحثًا عن قواعد البيت.

   المعايير تفحص ما بُني؛ والقراءة السريعة تفحص كيف. هل احترم أعرافك، أم اخترع نمطًا جديدًا؟ (وإن اخترع نمطًا فتلك ثغرة في ذاكرة المشروع؛ سجّل القرار حتى لا تكرّره الجلسة العاشرة.)
3. 3

   افحص صدق الوكيل نفسه.

   الإعادة الجيدة تقول أحيانًا «المعيار 3: غير مستوفى، معلّق على س». وهذا هو النظام يعمل: وكيل يبلّغ عن معيار غير مستوفى خير من وكيل يتستّر عليه. لا تعاقب الإنجاز الجزئي الصادق بإعادة كاملة من الصفر؛ بل أعِد المهمة بدقة.

الإعادة

حين يكون شيء ما مختلًّا، دقةٌ تدخل فدقةٌ تخرج:

❌ «هذا ليس صحيحًا تمامًا، ألقِ نظرة أخرى.»
✅ «المعيار 2 غير مستوفى: الروابط المنتهية تعرض صفحة الخطأ العامة، لا شاشة إعادة الإرسال. كما أن authRedirect يكرّر منطقًا موجودًا في lib/auth/redirects.ts؛ استخدم ذاك.»

علّق على المهمة، وأعِدها، واطلب من وكيلك المتابعة. تعيش الملاحظات على المهمة، فتكون في سياقها حين يُستأنف العمل، لذلك الوكيل أو للذي يليه.

متى تتوقف عن الثقة بملخص

افحص بعمق أكبر حين:

• يمسّ الفرق المصادقة أو المال أو حذف البيانات؛
• يكون ملخص الوكيل أغمض من عادته؛
• أو تكون كل المعايير «مستوفاة» بينما لا يُظهر موجز التقدّم أي تحديثات متعلقة بالاختبارات.

ثق بالعقد لا بالانطباع. وهذا يسري في الاتجاهين.

الحالة المستقرة

صُفّ مهام «جاهز» بمعايير محكمة ← يُفرغ الوكلاء العمود ← تقيّم أنت الإعادات في دقائق لكل واحدة ← ويعود غير المستوفى بملاحظات جراحية. ينتقل دورك من كتابة الكود إلى تعريف «منجَز» والتحقق منه، وهو الجزء الذي كان يحتاجك دائمًا.