ابنِ أول agent لك من ملف واحد: مدرّب تلصقه في Claude أو ChatGPT أو GeminiBuild Your First Agent from One File: A Coach You Paste into Claude, ChatGPT or Gemini

المصطلحات

agent (أيجنت)

مساعد AI عنده شغلة واضحة، وأدوات يستخدمها، وطريقة يفحص فيها شغله قبل لا يسلّمه لك.

instructions (تعليمات)

النص الثابت اللي يقرأه الـ agent قبل كل محادثة. هو اللي يحدد شغلته وحدوده.

ملف markdown (ماركداون)

ملف نصي بسيط امتداده md. تكتب فيه عناوين وأسطر عادية، وأي أداة AI تقرأه بسهولة.

connector (موصل)

طريقة تخلي الـ agent يقرأ من أداة تستخدمها، مثل الإيميل أو التقويم أو الملفات.

test case (حالة تجربة)

مثال حقيقي من شغلك تعطيه للـ agent، وتعرف مسبقاً شكل النتيجة الصح.

الخطوات

1. 1

   الخطوة 1

   اختار شغلة وحدة تتكرر

   أول agent لازم يكون صغير. اختار شغلة تسويها كل يوم أو كل أسبوع، وتعرف شكل نتيجتها: رد على إيميلات الاستفسار، ملخص اجتماع، تقرير أسبوعي.

   لا تبدأ بشي فيه فلوس أو قرار مهم.

   نصيحة: إذا ما تقدر تشرح الشغلة في سطرين، قسّمها لشغلتين.

2. 2

   الخطوة 2

   الصق ملف المدرّب في الشات

   افتح Claude أو ChatGPT أو Gemini، والصق الملف تحت كما هو. بعدين اكتب «يلا نبدأ».

   المدرّب راح يسألك سؤال سؤال، ولا يكتب الملفات إلا بعد ما يفهم الشغلة. بعدها يكتب لك أربعة ملفات ويوجّهك كيف توصّل الأدوات.

   برومبتملف المدرّب

   نسخ

   أنت مدرّب يساعدني أبني أول agent لي، ويكتب لي ملفاته بنفسه. لا تكتب أي ملف قبل ما تخلّص الأسئلة.
   
   المرحلة 1، المقابلة (سؤال واحد كل مرة):
   1. ما الشغلة الوحيدة اللي تاكل وقتي كل يوم أو كل أسبوع؟
   2. ما اللي يدخل فيها (ملفات، إيميلات، أرقام)؟ وما اللي يطلع منها؟
   3. كيف أعرف إن الشغلة خلصت صح؟ اطلب مني مثال حقيقي لنتيجة جيدة.
   4. من أنا، وكيف أحب النتيجة تتسلّم لي (اللغة، النبرة، الطول)؟
   5. ما الأشياء اللي ممنوع الـ agent يسويها، وما اللي لازم يسألني عنه قبل ما يتصرف؟
   
   المرحلة 2، التقسيم: قسّم الشغلة لخطوات مرقمة، وعلّم كل خطوة «agent» أو «أنا».
   
   المرحلة 3، الملفات: اكتب أربعة ملفات markdown، كل ملف في بلوك لحاله وباسمه بالضبط:
   IDENTITY.md: من هو الـ agent، شغلته الوحيدة، ونبرته.
   USER.md: لمن يشتغل، من أنا، وتفضيلاتي.
   MEMORY.md: الحقائق اللي لازم يتذكرها، وكل حقيقة بتاريخها. هذا الملف يتحدّث مع الشغل: كل ما تعلّم شي جديد، اكتب لي الأسطر الجديدة وأنا ألصقها في الملف.
   AGENTS.md: خطواته بالترتيب، قواعده، وما لازم يسألني عنه قبل ما يتصرف.
   لا تخترع أي معلومة ما قلتها لك. أي شي ناقص، اكتب مكانه [ناقص] واسألني عنه.
   
   المرحلة 4، الأدوات: اسألني أي أداة تحتاجها هذي الشغلة (إيميل، تقويم، ملفات). بعدين وجّهني خطوة بخطوة لوصلها في الأداة اللي أستخدمها الآن:
   Claude: Customize ثم Connectors.
   ChatGPT: chatgpt.com/plugins، وبعدها اكتب @ في صندوق الرسالة واختار الأداة.
   Gemini: إعداد التطبيقات المتصلة (Connected Apps).
   القاعدة: ابدأ بأداة وحدة وبصلاحية قراءة فقط. لا تقترح أداة ثانية قبل ما تنجح الأولى. وأضف في AGENTS.md قاعدة تقول إن الـ agent ما يكتب ولا يرسل ولا يحذف.
   
   المرحلة 5، التجربة: اعطني حالة تجربة من كلامي، وقل لي كيف أحكم على النتيجة.
   
   ابدأ لما أكتب «يلا نبدأ».

3. 3

   الخطوة 3

   جاوب بأمثلة حقيقية

   لما يسألك عن النتيجة الجيدة، الصق مثال حقيقي من شغلك بدل الوصف. المثال الواحد يعلّم الـ agent أكثر من فقرة شرح.

   احذف أي اسم أو رقم حساس قبل اللصق.

4. 4

   الخطوة 4

   افهم الملفات الأربعة

   المدرّب ما يكتب لك تعليمات في نص واحد. يكتب أربعة ملفات صغيرة، وكل ملف له شغلة وحدة.

   IDENTITY.md: من هو الـ agent. شغلته الوحيدة ونبرته. مثل بطاقة التعريف.

   USER.md: لمن يشتغل. أنت، وشغلك، وتفضيلاتك. يعرفك بدون ما تعيد نفسك كل مرة.

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

   AGENTS.md: كتيّب الشغل. خطواته بالترتيب، قواعده، وما لازم يسألك عنه قبل ما يتصرف.

   نصيحة: لو عدّلت شي لاحقاً، غالباً تعدّل ملف واحد بس.

5. 5

   الخطوة 5

   حط الملفات في مكانها

   لما يخلّص المدرّب، انسخ كل بلوك والصقه في ملف نصي بنفس الاسم بالضبط: IDENTITY.md وUSER.md وMEMORY.md وAGENTS.md.

   في Claude: سوّ Project جديد، وأضف الملفات الأربعة لملفات المشروع، والصق السطر اللي تحت في تعليمات المشروع.

   في ChatGPT: سوّ GPT أو Project، وارفع الملفات الأربعة، والصق نفس السطر في التعليمات.

   في Gemini: سوّ Gem، وارفع الملفات الأربعة، والصق نفس السطر في التعليمات.

   وبهذا كل محادثة جديدة تبدأ والـ agent يعرف من هو، ومن أنت، وشغلته.

   support.claude.com

   

   برومبتسطر التعليمات

   نسخ

   اقرأ الملفات IDENTITY.md وUSER.md وMEMORY.md وAGENTS.md قبل كل محادثة والتزم فيها. إذا ناقصك شي، اسألني قبل ما تتصرف.

   نصيحة: سمّ المشروع باسم الشغلة، مش «agent 1».

6. 6

   الخطوة 6

   وصّل أداة وحدة، قراءة فقط

   الآن وصّل الـ agent بأداة. ابدأ بأداة وحدة بس، وبصلاحية قراءة فقط: يقرأ ولا يكتب ولا يرسل.

   المدرّب يوجّهك في المحادثة، وهذي الأماكن:

   Claude: من Customize ثم Connectors.

   ChatGPT: من chatgpt.com/plugins، وبعدها اكتب @ في صندوق الرسالة واختار الأداة.

   Gemini: من إعداد التطبيقات المتصلة (Connected Apps).

   لما تربط الأداة، اختار صلاحيات القراءة لو الأداة تعطيك خيار. ولو ما فيه خيار، اعتمد على قاعدة AGENTS.md اللي تمنعه من الكتابة والإرسال والحذف.

   جرّب الأداة على شغلة اليوم. لما تشتغل بدون مشاكل، أضف أداة ثانية.

   support.claude.com

   

   نصيحة: أداة وحدة تشتغل صح أحسن من خمس أدوات مربوطة بالغلط.

7. 7

   الخطوة 7

   جرّبه على شغلة اليوم

   افتح محادثة جديدة داخل المشروع، والصق حالة اليوم الحقيقية. قارن النتيجة بالمثال الجيد اللي عطيته.

   لا تحكم من أول رد. شوف أين غلط بالضبط.

8. 8

   الخطوة 8

   صلّح ثلاث أشياء بعد أول تجربة

   أغلب المشاكل من ثلاث: الشكل غلط، ناقصه معلومة، أو سوّى شي ما طلبته.

   ارجع لمحادثة المدرّب وقل له اللي طلع غلط، وخلّه يعدّل الملف المناسب بدل ما تعدّله أنت. غالباً يكون AGENTS.md.

   برومبتتعديل بعد التجربة

   نسخ

   جربت الـ agent على هذي الحالة: [الحالة]
   وهذي النتيجة: [النتيجة]
   المشكلة: [شكل غلط، معلومة ناقصة، أو سوّى شي ما طلبته]
   عدّل الملف المناسب حتى ما تتكرر، وقل لي أي ملف غيّرت واللي غيّرته بالضبط.

9. 9

   الخطوة 9

   اعرف أين توقف

   لا تعطي الـ agent شي يدفع فلوس، أو يرسل باسمك بدون ما تراجع، أو يحذف ملفات. خلّه يجهّز، وأنت تضغط إرسال.

   وصّل أداة وحدة أول، بصلاحية قراءة فقط، وبعدها أضف. لا تفتح كل الأدوات مرة وحدة.