كيفية إسناد مهمتك الأولى إلى وكيل برمجة بالذكاء الاصطناعي

ملخص سريع: لإسناد مهمتك الأولى إلى وكيل ذكاء اصطناعي، اختر مهمة صغيرة يمكن للوكيل التحقق من صحتها بنفسه، واكتب العنوان بصيغة النتيجة المطلوبة، واجعل الوصف يحدد نطاق العمل ومعايير الاكتمال (Done when)، ثم سلّم المهمة وراجع النتيجة بدلاً من توجيهه خطوة بخطوة. في Sharkly، يعني هذا ربط جهاز كمبيوتر (Computer) مسجّل عليه الدخول في Claude Code أو Codex، وإنشاء وكيل (Agent) بمهمة واحدة محددة، وإنشاء مهمة (Task) وتعيين الوكيل في خانة المسؤول (Assignee). يؤدي تعيين المسؤول إلى بدء التشغيل تلقائياً، ثم تعود النتيجة إلى صفحة المهمة، ليقوم شخص بتغيير حالتها إلى مكتملة (Done).

لقد اعتدت على استخدام Claude Code أو Codex في موجه الأوامر (Terminal) لأسابيع؛ تكتب، فيُجري التعديل، تصححه، فيعدل مجدداً. لكن إسناد المهام خطوة من نوع مختلف: فأنت تدوّن العمل المطلوب مرة واحدة، وتسلّمه للوكيل، ثم تعود لتجد النتيجة جاهزة. غالباً ما تفشل المحاولة الأولى لأسباب بسيطة ومبتذلة: كأن تكتفي المهمة بعبارة «أصلح خطأ تسجيل الدخول» دون أي تفاصيل أخرى، أو أن أداة البرمجة على الـ Computer لم تكن مسجلة الدخول، أو لعدم وجود اختبار برمجي يمكن للوكيل تشغيله، مما يدفعه إلى التخمين ثم اعتبار المهمة منتهية.

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

اختر مهمة أولى يستطيع وكيل الذكاء الاصطناعي إنجازها

إسناد مهمة إلى وكيل ذكاء اصطناعي يعني تسليم وكيل البرمجة وحدة عمل مكتوبة لينفذها بمفرده، ثم مراجعة النتيجة، بدلاً من توجيهه أمراً بأمر (Prompt by prompt). احرص على أن تكون المهمة الأولى بسيطة وروتينية عن قصد؛ فأنت هنا تختبر سلامة الإعداد والتهيئة، لا أقصى قدرات الوكيل.

المهمة الأولى الجيدة تكون صغيرة بما يكفي لوصف الفارق البرمجي (diff) في جملة واحدة، وتحتوي على وسيلة تحقق يستطيع الوكيل تشغيلها، وتقتصر على وحدة برمجية واحدة (module)، ولا تمس أي شيء قد تتردد في التراجع عنه: كملفات ترحيل قواعد البيانات (migrations)، أو إعدادات بيئة الإنتاج، أو البيانات السرية والمفاتيح (secrets).

المهام في العمود الأيسر ليست أعمالاً خاطئة في حد ذاتها، لكنها مهام بلا حدود واضحة؛ مما يجبر الوكيل على ابتداع نطاق العمل بنفسه، ويتركك في حيرة لتخمين ما إذا كان قد حقق المطلوب أم لا. يشير دليل العمل مع Claude Code من Anthropic إلى السمة الأهم على الإطلاق: «امنح Claude وسيلة تحقق يمكنه تشغيلها: مثل الاختبارات، أو عملية البناء (build)، أو لقطة شاشة للمقارنة». فالوكيل الذي لا يملك وسيلة تحقق لا يملك إلا أن يدّعي أنه انتهى، أما الوكيل المزود بأداة فحص فيستطيع أن يُثبت لك ذلك عملياً.

صياغة المهمة لتمكين وكيل الذكاء الاصطناعي من إنهائها

تحدد وثائق المهام (Tasks) في Sharkly قاعدة أساسية لكتابة العناوين: «العنوان المفيد هو الذي يحدد النتيجة المرجوة لا مجرد موضوع العمل». بعد ذلك، يتضمن الوصف كل ما يحتاجه مطور جديد أو وكيل ذكاء اصطناعي: سبب أهمية هذا العمل، وما يقع داخل نطاق المهمة وخارجه، والملفات والأمثلة ذات الصلة، والقرارات المتخذة مسبقاً، وكيفية مراجعة الإنجاز. ويعتمد دليل صياغة الأوامر لـ Codex من OpenAI الإطار نفسه تقريباً: الهدف (Goal)، والسياق (Context)، والقيود (Constraints)، ومعايير الاكتمال (Done when).

إليك نموذجاً لمهمة أولى صيغت بهذه الطريقة (المهمة SH-312):

Title: Reject empty and malformed strings in parseDate()

Why: Support tickets show a 500 when the import form gets a blank date.

Scope: src/dates/parse.ts and its tests only. Do not change callers.

Context: Follow the pattern in src/dates/format.ts.
Errors use InvalidInputError from src/errors.ts.

Constraints: No new dependencies. Keep the public signature.

Done when:
- parseDate("") and parseDate("31/02/2026") throw InvalidInputError
- npm test passes
- Your final comment lists the files you changed and the test command you ran

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

هناك عادتان تضمنان تنظيم المهام بوضوح مع تزايد عددها: الأولى هي تثبيت الهدف ونطاق العمل ومعايير القبول داخل الوصف بدلاً من تشتيتها عبر التعليقات. والثانية هي وضع التعليمات الدائمة والمتكررة، مثل «اسأل عندما يكون الطلب غير واضح»، ضمن تعليمات الوكيل (Agent Instructions)، بحيث تقتصر كل مهمة (Task) على التفاصيل الخاصة بها فقط.

إسناد مهمتك الأولى إلى وكيل ذكاء اصطناعي في Sharkly

أنت تملك بالفعل وكلاء برمجة، وتطبيق Sharkly يحوّلهم إلى فريق عمل متكامل. يتطلب التشغيل الأول أربعة عناصر: مساحة عمل (Workspace)، وجهاز كمبيوتر (Computer)، ووكيل (Agent)، ومهمة (Task). تتبع هذه الخطوات إرشادات دليل البدء السريع لـ Sharkly:

1. تسجيل الدخول وإنشاء مساحة العمل. سجّل الدخول عبر app.sharkly.ai باستخدام رمز عبر البريد الإلكتروني، أو حساب Google، أو GitHub، ثم أنشئ مؤسسة (Organization)، وعند خطوة تهيئة مساحة العمل (Initialize workspace) اختر Software development. سيُنشئ Sharkly مساحة افتراضية (Default Space) مزودة بنوعي المهام: المتطلبات (Requirement) والأخطاء البرمجية (Bug).
2. ربط جهاز كمبيوتر (Computer). ثبّت Claude Code، أو Codex، أو Gemini، أو OpenClaw، أو Hermes، أو Pi Agent على الجهاز الذي سيتولى تنفيذ العمل، وسجّل الدخول إليه. سيتعرف تطبيق سطح المكتب على هذه الأدوات تلقائياً ويقوم بتسجيل الجهاز. أما من خلال واجهة الويب، فتوجه إلى Get started ثم Connect Computer لتحصل على أمر لتشغيله هناك. تنبه وثائق المساعدة إلى أن «حالة متصل (Online) تعني فقط أن الاتصال قائم»، لذا افتح صفحة الـ Computer وتأكد من أن بيئة التشغيل (Runtime) بحالة متاح (Available). يوضح مقال الأجهزة (Computers) في Sharkly الفروق بين استخدام الحواسيب المحمولة والخوادم.
3. إنشاء وكيل بمهمة واحدة محددة. افتح Agents، واختر New Agent، ثم حدد Code development، ثم فعّل خيار «the Agent automatically pulls Git repositories» وأضف المستودع البرمجي. حدد الـ Computer واجعل التعليمات موجزة ومباشرة. اترك مجلد العمل على الخيار الافتراضي Create temporary directory ليحصل كل Task على شجرة عمل (worktree) خاصة به، واجعل مستوى الرؤية (visibility) على وضع شخصي (Personal) حتى تتأكد من فاعلية الوكيل. لا يوجد زر لاختيار النموذج؛ لذا إذا أردت نموذجاً محدداً، فحدده في خانة المعاملات المخصصة (Custom arguments).
4. إجراء فحص للقراءة فقط. قبل البدء بأي عمل يُعدل الأكواد، تقترح وثائق المستودعات تشغيل مهمة استطلاعية مثل: «افحص المستودع البرمجي وقدّم تقريراً عن اللغة الأساسية، ومدير الحزم، وأقرب أمر لتشغيل الاختبارات. لا تعدل أي ملفات». يؤكد هذا الفحص قدرة الوكيل على الوصول إلى المستودع واستخدام صلاحيات Git وتنفيذ الأوامر بنجاح.
5. إنشاء المهمة وإسنادها. في صفحة المهام (Tasks)، اختر New Task والصق العنوان والوصف. تبدأ أي مهمة جديدة بحالة Todo. قم بتعيين الوكيل في خانة المسؤول (Assignee). وبحسب دليل البدء السريع: «تعيين المسؤول يبدأ عمل الوكيل مباشرة، ولا داعي لتغيير الحالة يدوياً أولاً». الاستثناء الوحيد هو حالة Backlog، وهي بمثابة قائمة انتظار؛ فالمهمة الموجودة هناك لا تبدأ حتى تنقلها منها.

متابعة تشغيل وكيل الذكاء الاصطناعي ومراجعة النتيجة

يمر التشغيل بحالات خاصة به تختلف عن حالة المهمة نفسها. توضح صفحة تنفيذ مهام الوكيل (Agent task execution) هذه الحالات:

داخل صفحة المهمة، يعرض تبويب Activity التعليقات متضمنةً ما توصل إليه الوكيل وتقريره النهائي، بينما يعرض تبويب Executions سجل عمليات التشغيل السابقة. وكل ما يتطلب تدخلك يصلك مباشرة في صندوق الوارد (Inbox) تحت تبويب Primary: مثل محادثة بانتظار ردك أو مراجعتك، أو مهام تعثرت أو توقفت، أو إشارات مباشرة إليك (@mentions).

عند انتهاء التشغيل، راجع التغييرات في شجرة العمل (worktree)، ثم قرر الاحتفاظ بها أو دمجها أو تجاهلها. وإذا وجدت خطأً ما، فاذكر الوكيل بإشارة (@mention) في تعليق يحدد التعديل المطلوب بدقة: «حالة النص الفارغ لا تزال تُرجع null. أرسل استثناء InvalidInputError». فالتعليق العادي لا يؤدي إلى تشغيل الوكيل؛ بل الإشارة إليه هي ما تطلقه. وعندما تكون النتيجة سليمة، يقوم شخص بتغيير حالة المهمة إلى مكتملة (Done). إن دور الوكلاء يكمن في البحث والتنفيذ والاختبار وإعداد التقارير، في حين يتولى البشر تحديد الاتجاه ومنح الصلاحيات واعتماد النتائج. لمعرفة ما ينبغي البحث عنه عند فحص الفروق البرمجية، راجع مقال مراجعة الأكواد البرمجية المولدة بالذكاء الاصطناعي مع أدلة على مستوى المهمة.

وكيل واحد، أم فريق عمل (Crew)، أم الاكتفاء بموجه الأوامر؟

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

تضع وثائق فرق العمل (Crews) في Sharkly القاعدة التالية: «بالنسبة للمهام الصغيرة والمحددة بوضوح، أسند المهمة مباشرة إلى وكيل واحد. واستخدم فريق عمل (Crew) عندما يحتاج قائد الفريق إلى تحليل الهدف وتوزيع المهام على وكلاء آخرين وجمع نتائجهم». لذا ينبغي أن تُسند مهمتك الأولى إلى وكيل واحد فقط. ويتناول مقال Sharkly Crews الحالة الثانية بالتفصيل.

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

إذا كنت ترغب في تسليم العمل لوكلاء البرمجة الذين تدفع مقابلهم بالفعل والحصول على كافة النتائج في مكان واحد، فهذه هي المشكلة الأساسية التي صُمم Sharkly لحلها.

الأسئلة الشائعة

هل يؤدي إسناد المهمة إلى بدء تشغيل وكيل الذكاء الاصطناعي فوراً؟ في العادة، نعم؛ فتعيين المسؤول (Assignee) يُطلق عملية التشغيل مباشرة ما لم تكن المهمة في حالة Backlog، أو Completed، أو Canceled، أو Duplicate. ومع ذلك، قد تظل عملية التشغيل في قائمة الانتظار (Queued) حتى يتوفر الـ Computer، أو بسبب حدود التنفيذ المتزامن، أو بانتظار توفر دليل عمل فارغ.

ماذا يحدث إذا انقطع اتصال جهازي (Computer)؟ عادةً ما تنتظر عمليات التشغيل الجديدة إعادة اتصاله، وقد تبقى العملية في قائمة الانتظار إذا انقطع اتصال الجهاز قبل مرحلة الإرسال (dispatch). احرص على تفعيل خيار منع السكون (Prevent sleep) على الحواسيب المحمولة لضمان استمرارها في استقبال المهام وتنفيذها.

هل أدفع ثمن استخدام النموذج عبر Sharkly؟ لا، حيث يتم احتساب تكلفة التشغيل على خطة Claude Code أو Codex أو واجهة برمجة التطبيقات (API) المسجلة بالفعل على جهازك، وتطبيق Sharkly لا يبيع رموز الاستخدام (tokens). كما أن Sharkly نفسه مجاني حالياً للفرق والمؤسسات التي تضم حتى 5 أفراد؛ راجع مقال شرح أسعار Sharkly لمزيد من التفاصيل.

ما الذي يستطيع الوكيل الوصول إليه على جهازي؟ كل ما يتيحه الـ Computer له: «نظام التشغيل، والملفات، وبيانات الاعتماد، والوصول إلى الشبكة، والأدوات التي يتطلبها عمل الوكيل». احرص على إبقاء الوكيل والجهاز في الوضع الشخصي (Personal) طالما أنهما يستخدمان بيانات اعتمادك الخاصة، ولا تلصق أبداً رموز المصادقة السرية (tokens) داخل المهمة، واطّلع على مقال ما ينبغي وما لا ينبغي السماح للوكيل بفعله.