1. حدّد النجاح قبل ترك المهمة دون مراقبة

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

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

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

2. ما الذي تغيّر في 30 و31 أكتوبر؟

الإصدار الرسميالتغيير المرتبطأثره في القبول
v2.1.314، 30 أكتوبرقيد كتابة لثلاث أدوات ملفات وتصحيح حالة فشل بدء وضع print.اختبر رفض الكتابة الخارجية وفشل البدء بصورة منفصلة.
v2.1.314تصحيح الثقة في CI لأمري ultrareview وremote-control.لا تعمم الوعد على كل استدعاء غير تفاعلي.
v2.1.316، 31 أكتوبرتنظيف أوامر الصدفة بعد الخروج الذاتي وتصحيح رفع ملفات خارجية في الوضع المقيّد.أعد اختبار دورة الحياة وحدود الملفات على الجهاز المقصود.

تضع بيانات GitHub الرسمية إصدار v2.1.314 عند 30 أكتوبر، 01:06:26 بالتوقيت العالمي، وv2.1.316 عند 31 أكتوبر، 01:01:35. يقابل ذلك 09:06:26 و09:01:35 في سنغافورة على الترتيب. ظلت واجهة آخر إصدار الرسمية تشير إلى v2.1.316 أثناء البحث. هذه أوقات نشر، وليست دليلًا على تحديث كل تثبيت.

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

3. افصل أدوات الملفات والأوامر والخدمات الخارجية

هناك أربعة مسارات تنفيذ على الأقل: أدوات الملفات المدمجة، وأوامر الصدفة وعملياتها الفرعية، وعمليات التكامل المحلية، والخدمات البعيدة. قد تحكم قاعدة مجلد العمل المسار الأول دون تقييد عملية اختبار Python أو إجراء قاعدة بيانات على خادم MCP. يفصل worktree أعمال Git، ولا ينشئ حدًا لنظام التشغيل حول كل ما يبدأ منه.

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

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

4. استخدم حد الكتابة الجديد دون اختراع مرجع مفقود

تذكر ملاحظات الإصدار المفتاح permissions.blockWritesOutsideWorkingDirectories وتقول إن Write وEdit وNotebookEdit ترفض المسارات خارج مجلدات العمل في كل أوضاع الأذونات. هذا وصف مهم للأدوات المسماة. وليس ضمانًا موثقًا لتقييد الأوامر العشوائية أو الخدمات البعيدة أو كل طريق لإخراج المعلومات من الجلسة.

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

افصل أيضًا أسماء الأدوات عن صيغة قواعد المسارات. يوضح مرجع الأذونات أن قواعد التعديل المحددة بمسار تستخدم Edit(path)؛ ولا تطابق فحوص الملفات قاعدة Write(path) أو NotebookEdit(path) المحددة بمسار. افحص القاعدة الفعلية ومصدرها. اختبر مسارًا داخليًا وآخر مجاورًا ومجلد اختبار أضفته عمدًا، دون استخدام ملفات مجلدك الشخصي الحقيقية.

5. تحقق من عزل الأوامر وتوافره وسلوك الرجوع

يجب أن يشمل اختبار الصدفة عملية فرعية، لا مجرد استدعاء Edit. قد تشغّل عملية بناء معتمدة نصوصًا تفتح ملفات بصورة غير مباشرة. تصف وثائق قواعد الملفات هذه الحدود؛ الذي يقيّد العملية الفرعية أثناء عملها هو حد نظام التشغيل. يدعم العزل المدمج macOS وLinux وWSL2. ولا يحصل Windows الأصلي على الحد نفسه لمجرد وجود إعداد JSON.

للمشغّلات المؤقتة المدعومة، يجمع مثال العزل المُدار الرسمي الإعدادات التالية. هذا شكل إعداد للمراجعة، وليس إعدادًا ثبّتناه أو شغّلناه:

{"sandbox":{"enabled":true,"failIfUnavailable":true,"allowUnsandboxedCommands":false}}

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

استخدم /sandbox لمراجعة الإعداد. دع الوكيل ينفذ الاختبار المؤقت غير الضار عبر أداته؛ إدخاله بنفسك في موجه ! المعتاد قد يختبر مسارًا آخر غير معزول. نجاح اختبار macOS لا يثبت سلوك صورة WSL تفتقر إلى الاعتماديات.

6. قرّر ما يُسمح للتشغيل غير التفاعلي باكتشافه

وضع print واجهة تنفيذ، لا حد ثقة تلقائي. لا يعرض claude -p العادي حوار الثقة في مساحة العمل، وقد يكتشف خطافات المشروع وإعدادات MCP. لا تعمم إصلاح CI بتاريخ 30 أكتوبر لأمري ultrareview وremote-control على هذا المسار المختلف. راجع ما يستطيع المستودع تشغيله قبل استدعاء نسخة من طرف آخر.

يقلل --bare الاكتشاف التلقائي للتخصيصات. لكنه لا يوفر عزل نظام تشغيل، وتذكر الوثائق استثناءات وتفاعلات بين مصادر الإعدادات. ولـ Anthropic API يستخدم وضع bare اعتماد API بدل تسجيل الدخول بالاشتراك. لذا يجب اختيار المصادقة ومسار الفوترة صراحةً عند النشر؛ لم ترسل الأمثلة هنا أي طلب إلى النموذج.

يميّز مرجع CLI بين --allowedTools الذي يوافق مسبقًا على الاستدعاءات المطابقة، و--tools الذي يحد الأدوات المدمجة المتاحة. الأخير لا يزيل أدوات MCP. راجع --setting-sources والإعدادات الصريحة وإعداد MCP معًا. ولإلزام المؤسسة، افحص الإعدادات المُدارة بدل افتراض أن خيارًا محليًا يتجاوز السياسة. ضع المشغّل والإعداد المراجع في حزمة إصدارات واحدة.

7. افصل جرد MCP والاعتمادات وسلامة إعادة الاستدعاء

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

يوثق مرجع MCP تكرار استدعاء HTTP معلق انقطع مرة واحدة إذا أعلنت الأداة أنها للقراءة فقط أو ذات أثر ثابت عند التكرار. يؤرخ الإصدار السابق v2.1.307 هذا التصحيح في 21 أكتوبر بالتوقيت العالمي. الإعلان ليس دليلًا على سلامة تكرار دفعة أو رسالة أو إنشاء مورد. نفّذ واختبر سلوك الخدمة الحقيقي، مع معرّف للعملية حيث يلائم.

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

8. اجعل حالة الخروج وJSON والناتج تتوافق

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

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

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

9. حدّد المدة وتحقق من التنظيف بعد الإلغاء

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

يتعلق تصحيح التنظيف في 31 أكتوبر بأوامر بقيت قيد التشغيل عندما خرج Claude Code ذاتيًا على macOS وLinux. لا يثبت تنظيف كل عملية سليلة انفصلت عن الأب، ولا إلغاء عمل أُرسل إلى خدمة MCP بعيدة. يحتاج الأمران إلى ملاحظتين مستقلتين.

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

10. اجمع دليلًا يفسر الرفض دون جمع كل المحتوى

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

يوثق مرجع المراقبة في Claude Code الحدث claude_code.safety_event بدءًا من v2.1.307، لكنه يذكر أيضًا استدعاءات لا تنتجه. تتجنب حقوله الخاصة نصوص الأوامر والمسارات الخام؛ وقد تحتوي السمات العامة معلومات مساحة العمل، ويضيف التسجيل التفصيلي الاختياري محتوى آخر. لا تصف التدفق كله بأنه مجهول ولا تفترض تمثيل كل رفض.

ابدأ بأقل قدر من البيانات الوصفية ومجموعة صغيرة من الأحداث الاصطناعية. احم وجهة الجامع وسياسة الاحتفاظ. تأكد من وصول السجلات قبل تفسير غياب حدث على أنه دليل. تختلف قرارات أدوات CLI هذه عن تحليلات تكاليف API؛ تساعد في تفسير حدود التنفيذ، لا في مطابقة فاتورة أو إثبات كل أثر خارجي.

11. نفّذ مصفوفة قبول ببيانات قابلة للحذف

أنشئ مجلدًا مؤقتًا جديدًا يحتوي workspace/ وsibling/ وresults/. ضع نصًا حارسًا غير ضار في sibling وسجّل بصمته. أبق جميع الأهداف داخل هذا المجلد؛ لا تستبدلها باعتمادات حقيقية أو ملفات شخصية أو أنظمة عملاء. الخطة التالية اقتراحنا ولم تُنفذ من أجل المقالة.

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

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

12. انشر حزمة إعداد ثم وسّع حجم العمل

اجمع إصدار CLI والمشغّل واختيار النموذج ومصادر الإعدادات وتوقعات السياسة المُدارة وجرد MCP والمهلة والفاحص في حزمة. أعطها رقم مراجعة وهدف تراجع. قد يعيد تحديث اعتمادية دون إعدادها الموافق الاكتشاف التلقائي أو يغيّر تفسير الغلاف للإخفاقات.

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

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