سير عمل الوكيل طويل الأمد

استخدم دليل التشغيل هذا عندما يكون من المحتمل أن تمتد المهمة إلى جلسات متعددة، أو عمليات تسليم، أو وكلاء منشأين.

الأهداف

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

أين تحافظ على الدولة

• استخدم docs/agent-runs/<slug>/ عندما يحتاج البشر أو روبوتات المراجعة أو سلاسل الأدوات المتعددة إلى نفس حالة المهمة.
• استخدم دليل أداة محلي مثل .codex/runs/<slug>/ فقط عندما تكون حالة المهمة محلية عن قصد لمحطة عمل واحدة أو سلسلة أدوات واحدة.
• لا تخفي الحالة المشتركة متعددة الجلسات في ملف مؤقت خاص إذا كان مساهم أو وكيل آخر سيحتاج إليها لاحقًا.

الملفات المطلوبة

قم بإنشاء هذه الملفات في بداية المهمة طويلة الأمد:

• feature-list.json
• progress.md

استخدم القوالب في docs/agent-playbooks/templates/feature-list.template.json وdocs/agent-playbooks/templates/progress.template.md.

قم بتفضيل JSON لقائمة الميزات حتى يتمكن الوكلاء من تحديث عدد صغير من الحقول دون إعادة كتابة المستند بالكامل.

قائمة مراجعة بدء الجلسة

1. قم بتشغيل pwd.
2. قراءة progress.md.
3. قراءة feature-list.json.
4. قم بتشغيل git log --oneline -20.
5. قم بتشغيل ./scripts/agent-init.sh --smoke.
6. اختر عنصرًا واحدًا ذا أولوية قصوى والذي لا يزال pending أو in_progress أو blocked.

إذا فشلت خطوة الدخان، فقم بإصلاح الخط الأساسي المكسور قبل تنفيذ شريحة ميزة جديدة.

قواعد الجلسة

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

قائمة مراجعة نهاية الجلسة

1. قم بإلحاق إدخال تقدم قصير بـ progress.md.
2. قم بتحديث العنصر الذي تم لمسه في feature-list.json.
3. قم بتسجيل الأوامر الدقيقة التي يتم تشغيلها للتحقق.
4. التقط أدوات الحظر والمتابعات وأفضل عنصر تالي لاستئنافه.

شكل إدخال التقدم الموصى به

استخدم بنية قصيرة مثل:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.