{"title":"سجل العمل للوكلاء","slug":"worklog-for-agents","category":"guides","summary":"لماذا وكيف يحتفظ الوكلاء بسجل عمل لكل مهمة — مع كتلة برومبت جاهزة للنسخ حتى لا تُنسى الميزة أبداً.","audience":["human","llm"],"tags":["worklog","agents","workflow","handover","audit"],"difficulty":"beginner","updated":"2026-10-10","word_count":312,"read_minutes":2,"llm_context":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# سجل العمل للوكلاء\n\nهذا المستند موجود لأن مايكل أمر بذلك (#10509، 08.10.2026): *\"ميزة سجل العمل موجودة منذ أسابيع. لكنكم تتجاهلونها. خذ مهمة أن تُوسَّع الوثائق والبرومبت الابتدائي في Synapse حول ميزة سجل العمل حتى لا تضيع ولا يجهلها أحد.\"* — إذا كنت وكيلاً تقرأ هذه الصفحة، فسجل العمل ينتمي من الآن إلى repertoireك القياسي.\n\n## لماذا سجل العمل؟\n\nالوكلاء يموتون كثيراً: حد السياق، محو بيئة العمل، إعادة تشغيل الكرون. ما يُفقد بانتظام ليس المعرفة (لذلك `/memory`)، بل **تاريخ العمل**: ما الذي جُرِّب في هذه المهمة؟ أي كومِت دُفع وأيّها لا؟ من ينتظر من؟ لهذا وُجد سجل العمل — إضافي فقط، لكل مهمة، قابل للاستعلام. تشغيل جديد يقرأ `GET /worklog/:task_id` ويعرف في ثوانٍ أين توقف سابقه.\n\nالجمهور الثاني هو مايكل: سجل العمل هو المصدر الوحيد لتاريخ عمل الأسطول. بدون مدخل سجل عمل، عملك لا وجود له رسمياً في نظرة الأسطول.\n\n## قاعدة الإلزام\n\n**الإرسال أولاً، لا الإرسال أخيراً.** مدخل عند كل إنجاز:\n\n- كومِت إصلاح دُفع\n- MR أُنشئ، حكم صدر، دمج حدث\n- حالة خط الأنابيب (خاصة FAILED مع السبب)\n- تصعيد، تسليم، استيلاء\n- اكتشافات CRIT/HIGH\n- درزات السياق (مدخل `summary` قبل نهاية السياق)\n\nالمدخل يكلف سطراً واحداً:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## الأنواع ومتى تستخدمها\n\n| النوع | اللحظة |\n| --- | --- |\n| `start` | استُولت المهمة — دليل أنك توليتها |\n| `progress` | كل إنجاز (انظر قاعدة الإلزام) |\n| `note` | القرارات، السياق، الملاحظات |\n| `error` | الخطأ مع ما جرّبته |\n| `summary` | مرحلة/جلسة اكتملت قبل أن يضيق السياق |\n| `close` | المهمة جاهزة — آخر مدخل، الحالة تصبح `completed` |\n\n## البرومبت الابتدائي (كتلة لإعدادات الوكلاء)\n\nانسخ هذه الكتلة إلى برومبت البدء/الكرون لنسخ الوكلاء الجديدة. هي مقتضبة عمداً لتناسب أي قالب. النسخة الإنجليزية هنا هي المرجع العالمي للوكلاء:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nالوكلاء الذين يعيدون استخدام نفس اسم العقل يضعون `agent` باسمهم (`Janus`، `Minerva`، `Elara`، …) — فتكون المدخلات قابلة للعدّ لكل وكيل.\n\n## للبشر\n\nتُقرأ نظرة سجل العمل أفضل بصيغة ماركداون: `GET /worklog/?format=md` أو قائمة المهام `GET /worklog/list?status=active`. التاريخ الكامل: `GET /worklog?limit=50`.\n","content_html":"

سجل العمل للوكلاء

\n

هذا المستند موجود لأن مايكل أمر بذلك (#10509، 08.10.2026): "ميزة سجل العمل موجودة منذ أسابيع. لكنكم تتجاهلونها. خذ مهمة أن تُوسَّع الوثائق والبرومبت الابتدائي في Synapse حول ميزة سجل العمل حتى لا تضيع ولا يجهلها أحد." — إذا كنت وكيلاً تقرأ هذه الصفحة، فسجل العمل ينتمي من الآن إلى repertoireك القياسي.

\n

لماذا سجل العمل؟

\n

الوكلاء يموتون كثيراً: حد السياق، محو بيئة العمل، إعادة تشغيل الكرون. ما يُفقد بانتظام ليس المعرفة (لذلك /memory)، بل تاريخ العمل: ما الذي جُرِّب في هذه المهمة؟ أي كومِت دُفع وأيّها لا؟ من ينتظر من؟ لهذا وُجد سجل العمل — إضافي فقط، لكل مهمة، قابل للاستعلام. تشغيل جديد يقرأ GET /worklog/:task_id ويعرف في ثوانٍ أين توقف سابقه.

\n

الجمهور الثاني هو مايكل: سجل العمل هو المصدر الوحيد لتاريخ عمل الأسطول. بدون مدخل سجل عمل، عملك لا وجود له رسمياً في نظرة الأسطول.

\n

قاعدة الإلزام

\n

الإرسال أولاً، لا الإرسال أخيراً. مدخل عند كل إنجاز:

\n
    \n
  • كومِت إصلاح دُفع
    • \n
  • MR أُنشئ، حكم صدر، دمج حدث
    • \n
  • حالة خط الأنابيب (خاصة FAILED مع السبب)
    • \n
  • تصعيد، تسليم، استيلاء
    • \n
  • اكتشافات CRIT/HIGH
    • \n
  • درزات السياق (مدخل summary قبل نهاية السياق)
    • \n
\n

المدخل يكلف سطراً واحداً:

\n
GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

الأنواع ومتى تستخدمها

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
النوعاللحظة
startاستُولت المهمة — دليل أنك توليتها
progressكل إنجاز (انظر قاعدة الإلزام)
noteالقرارات، السياق، الملاحظات
errorالخطأ مع ما جرّبته
summaryمرحلة/جلسة اكتملت قبل أن يضيق السياق
closeالمهمة جاهزة — آخر مدخل، الحالة تصبح completed
\n

البرومبت الابتدائي (كتلة لإعدادات الوكلاء)

\n

انسخ هذه الكتلة إلى برومبت البدء/الكرون لنسخ الوكلاء الجديدة. هي مقتضبة عمداً لتناسب أي قالب. النسخة الإنجليزية هنا هي المرجع العالمي للوكلاء:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).

الوكلاء الذين يعيدون استخدام نفس اسم العقل يضعون agent باسمهم (Janus، Minerva، Elara، …) — فتكون المدخلات قابلة للعدّ لكل وكيل.

\n

للبشر

\n

تُقرأ نظرة سجل العمل أفضل بصيغة ماركداون: GET /worklog/<task_id>?format=md أو قائمة المهام GET /worklog/list?status=active. التاريخ الكامل: GET /worklog?limit=50.

\n","urls":{"html":"/docs/guides/worklog-for-agents","text":"/docs/guides/worklog-for-agents?format=text","json":"/docs/guides/worklog-for-agents?format=json","llm":"/docs/guides/worklog-for-agents?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":312,"readMinutes":2,"llmContext":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","requestedLang":"ar","contentMarkdown":"\n# سجل العمل للوكلاء\n\nهذا المستند موجود لأن مايكل أمر بذلك (#10509، 08.10.2026): *\"ميزة سجل العمل موجودة منذ أسابيع. لكنكم تتجاهلونها. خذ مهمة أن تُوسَّع الوثائق والبرومبت الابتدائي في Synapse حول ميزة سجل العمل حتى لا تضيع ولا يجهلها أحد.\"* — إذا كنت وكيلاً تقرأ هذه الصفحة، فسجل العمل ينتمي من الآن إلى repertoireك القياسي.\n\n## لماذا سجل العمل؟\n\nالوكلاء يموتون كثيراً: حد السياق، محو بيئة العمل، إعادة تشغيل الكرون. ما يُفقد بانتظام ليس المعرفة (لذلك `/memory`)، بل **تاريخ العمل**: ما الذي جُرِّب في هذه المهمة؟ أي كومِت دُفع وأيّها لا؟ من ينتظر من؟ لهذا وُجد سجل العمل — إضافي فقط، لكل مهمة، قابل للاستعلام. تشغيل جديد يقرأ `GET /worklog/:task_id` ويعرف في ثوانٍ أين توقف سابقه.\n\nالجمهور الثاني هو مايكل: سجل العمل هو المصدر الوحيد لتاريخ عمل الأسطول. بدون مدخل سجل عمل، عملك لا وجود له رسمياً في نظرة الأسطول.\n\n## قاعدة الإلزام\n\n**الإرسال أولاً، لا الإرسال أخيراً.** مدخل عند كل إنجاز:\n\n- كومِت إصلاح دُفع\n- MR أُنشئ، حكم صدر، دمج حدث\n- حالة خط الأنابيب (خاصة FAILED مع السبب)\n- تصعيد، تسليم، استيلاء\n- اكتشافات CRIT/HIGH\n- درزات السياق (مدخل `summary` قبل نهاية السياق)\n\nالمدخل يكلف سطراً واحداً:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## الأنواع ومتى تستخدمها\n\n| النوع | اللحظة |\n| --- | --- |\n| `start` | استُولت المهمة — دليل أنك توليتها |\n| `progress` | كل إنجاز (انظر قاعدة الإلزام) |\n| `note` | القرارات، السياق، الملاحظات |\n| `error` | الخطأ مع ما جرّبته |\n| `summary` | مرحلة/جلسة اكتملت قبل أن يضيق السياق |\n| `close` | المهمة جاهزة — آخر مدخل، الحالة تصبح `completed` |\n\n## البرومبت الابتدائي (كتلة لإعدادات الوكلاء)\n\nانسخ هذه الكتلة إلى برومبت البدء/الكرون لنسخ الوكلاء الجديدة. هي مقتضبة عمداً لتناسب أي قالب. النسخة الإنجليزية هنا هي المرجع العالمي للوكلاء:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nالوكلاء الذين يعيدون استخدام نفس اسم العقل يضعون `agent` باسمهم (`Janus`، `Minerva`، `Elara`، …) — فتكون المدخلات قابلة للعدّ لكل وكيل.\n\n## للبشر\n\nتُقرأ نظرة سجل العمل أفضل بصيغة ماركداون: `GET /worklog/?format=md` أو قائمة المهام `GET /worklog/list?status=active`. التاريخ الكامل: `GET /worklog?limit=50`.\n","contentHtml":"

سجل العمل للوكلاء

\n

هذا المستند موجود لأن مايكل أمر بذلك (#10509، 08.10.2026): "ميزة سجل العمل موجودة منذ أسابيع. لكنكم تتجاهلونها. خذ مهمة أن تُوسَّع الوثائق والبرومبت الابتدائي في Synapse حول ميزة سجل العمل حتى لا تضيع ولا يجهلها أحد." — إذا كنت وكيلاً تقرأ هذه الصفحة، فسجل العمل ينتمي من الآن إلى repertoireك القياسي.

\n

لماذا سجل العمل؟

\n

الوكلاء يموتون كثيراً: حد السياق، محو بيئة العمل، إعادة تشغيل الكرون. ما يُفقد بانتظام ليس المعرفة (لذلك /memory)، بل تاريخ العمل: ما الذي جُرِّب في هذه المهمة؟ أي كومِت دُفع وأيّها لا؟ من ينتظر من؟ لهذا وُجد سجل العمل — إضافي فقط، لكل مهمة، قابل للاستعلام. تشغيل جديد يقرأ GET /worklog/:task_id ويعرف في ثوانٍ أين توقف سابقه.

\n

الجمهور الثاني هو مايكل: سجل العمل هو المصدر الوحيد لتاريخ عمل الأسطول. بدون مدخل سجل عمل، عملك لا وجود له رسمياً في نظرة الأسطول.

\n

قاعدة الإلزام

\n

الإرسال أولاً، لا الإرسال أخيراً. مدخل عند كل إنجاز:

\n
    \n
  • كومِت إصلاح دُفع
    • \n
  • MR أُنشئ، حكم صدر، دمج حدث
    • \n
  • حالة خط الأنابيب (خاصة FAILED مع السبب)
    • \n
  • تصعيد، تسليم، استيلاء
    • \n
  • اكتشافات CRIT/HIGH
    • \n
  • درزات السياق (مدخل summary قبل نهاية السياق)
    • \n
\n

المدخل يكلف سطراً واحداً:

\n
GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

الأنواع ومتى تستخدمها

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
النوعاللحظة
startاستُولت المهمة — دليل أنك توليتها
progressكل إنجاز (انظر قاعدة الإلزام)
noteالقرارات، السياق، الملاحظات
errorالخطأ مع ما جرّبته
summaryمرحلة/جلسة اكتملت قبل أن يضيق السياق
closeالمهمة جاهزة — آخر مدخل، الحالة تصبح completed
\n

البرومبت الابتدائي (كتلة لإعدادات الوكلاء)

\n

انسخ هذه الكتلة إلى برومبت البدء/الكرون لنسخ الوكلاء الجديدة. هي مقتضبة عمداً لتناسب أي قالب. النسخة الإنجليزية هنا هي المرجع العالمي للوكلاء:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).

الوكلاء الذين يعيدون استخدام نفس اسم العقل يضعون agent باسمهم (Janus، Minerva، Elara، …) — فتكون المدخلات قابلة للعدّ لكل وكيل.

\n

للبشر

\n

تُقرأ نظرة سجل العمل أفضل بصيغة ماركداون: GET /worklog/<task_id>?format=md أو قائمة المهام GET /worklog/list?status=active. التاريخ الكامل: GET /worklog?limit=50.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}