# ScheduleWakeup

يُجدوِل موعد استئناف العمل في الوضع الديناميكي `/loop`. تتيح هذه الأداة لـ Claude إدارة وتيرة تكرارات المهمة ذاتيًا، بالدخول في وضع السكون للمدة المختارة ثم إعادة التشغيل بنفس موجّه الحلقة.

## متى يُستخدم

- لإدارة وتيرة مهمة ديناميكية `/loop` بشكل ذاتي حيث يعتمد فاصل التكرار على حالة العمل لا على ساعة ثابتة
- لانتظار اكتمال بناء طويل أو نشر أو تشغيل اختبارات قبل فحص النتائج
- لإدراج علامات انتظار خامل بين التكرارات عندما لا يوجد إشارة محددة للمراقبة في الوقت الحالي
- لتشغيل حلقة مستقلة بدون موجّه من المستخدم — مرّر الـ sentinel الحرفي `<<autonomous-loop-dynamic>>` كـ `prompt`
- لاستطلاع حالة عملية على وشك التغيير (استخدم تأخيرًا قصيرًا للحفاظ على دفء الذاكرة المؤقتة)

## المعاملات

- `delaySeconds` (رقم، مطلوب): الثواني حتى الاستئناف. يقيّد وقت التشغيل القيمة تلقائيًا في النطاق `[60, 3600]`، لذا لا يلزم التقييد اليدوي.
- `reason` (نص، مطلوب): جملة قصيرة تشرح التأخير المختار. تُعرض للمستخدم وتُسجَّل في بيانات القياس عن بُعد. كن محددًا — "التحقق من بناء bun الطويل" أفيد من "في انتظار."
- `prompt` (نص، مطلوب): إدخال `/loop` الذي يُطلَق عند الاستيقاظ. مرّر نفس النص في كل دور لكي يُكرر التشغيل التالي المهمة. في حالة حلقة مستقلة بدون موجّه من المستخدم، مرّر الـ sentinel الحرفي `<<autonomous-loop-dynamic>>`.

## أمثلة

### مثال 1: تأخير قصير لإعادة التحقق من إشارة سريعة التغيير (الحفاظ على دفء الذاكرة المؤقتة)

بدأ البناء للتو ويستغرق عادةً دقيقتين إلى ثلاث دقائق.

```json
{
  "delaySeconds": 120,
  "reason": "التحقق من بناء bun المتوقع اكتماله خلال ~2 دقيقة",
  "prompt": "التحقق من حالة البناء والإبلاغ عن أي أخطاء"
}
```

120 ثانية تحافظ على سياق المحادثة في الذاكرة المؤقتة لـ Anthropic (TTL 5 دقائق)، مما يجعل الاستيقاظ التالي أسرع وأرخص.

### مثال 2: علامة انتظار خامل طويلة (قبول إغفال الذاكرة المؤقتة، وتوزيعه على فترة انتظار أطول)

تجري عملية ترحيل قاعدة البيانات وتستغرق عادةً 20–40 دقيقة.

```json
{
  "delaySeconds": 1200,
  "reason": "الترحيل يستغرق عادةً 20–40 دقيقة؛ التحقق بعد 20 دقيقة",
  "prompt": "التحقق من حالة الترحيل والمتابعة عند الاكتمال"
}
```

ستكون الذاكرة المؤقتة باردة عند الاستيقاظ، لكن انتظار 20 دقيقة يعوّض بما يكفي تكلفة إغفال الذاكرة المؤقتة الواحد. الاستطلاع كل 5 دقائق سيدفع نفس تكلفة الإغفال 4 مرات دون أي فائدة.

## ملاحظات

- **مدة صلاحية الذاكرة المؤقتة 5 دقائق**: تنتهي صلاحية الذاكرة المؤقتة لـ Anthropic بعد 300 ثانية. التأخيرات أقل من 300 ثانية تحافظ على دفء السياق؛ التأخيرات فوق 300 ثانية تُسبب إغفال الذاكرة المؤقتة في الاستيقاظ التالي.
- **تجنب 300 ثانية بالضبط**: هذا أسوأ الحالتين — تدفع ثمن إغفال الذاكرة المؤقتة دون الحصول على فترة انتظار أطول بشكل ملموس. إما انخفض إلى 270 ثانية (حافظ على دفء الذاكرة المؤقتة) أو التزم بـ 1200 ثانية أو أكثر (إغفال واحد يشتري انتظارًا أطول بكثير).
- **القيمة الافتراضية للانتظار الخامل**: عندما لا توجد إشارة محددة للمراقبة، استخدم **1200–1800 ثانية** (20–30 دقيقة). يتيح ذلك للحلقة التحقق دوريًا دون إهدار الذاكرة المؤقتة 12 مرة في الساعة دون سبب.
- **التقييد التلقائي**: يقيّد وقت التشغيل `delaySeconds` في النطاق `[60, 3600]`. القيم أقل من 60 تصبح 60؛ القيم فوق 3600 تصبح 3600. لا يلزم التعامل مع هذه الحدود يدويًا.
- **احذف الاستدعاء لإنهاء الحلقة**: إذا كنت تنوي إيقاف التكرارات، لا تستدعِ ScheduleWakeup. مجرد حذف الاستدعاء ينهي الحلقة.
- **مرّر نفس `prompt` في كل دور**: يجب أن يحمل حقل `prompt` تعليمات `/loop` الأصلية في كل استدعاء حتى يعرف الاستيقاظ التالي أي مهمة يستأنف.
