Claude Code Prompt Library: اكتب prompt ناجحًا من أول مرة

فتحت Claude Code، وظهرت لك خانة الكتابة فارغة. تعرف أنك تريد مساعدة، لكن ماذا تكتب بالضبط؟ هذا شعور طبيعي جدًا عند كل مبتدئ. لهذا صنع فريق Claude Code Prompt library فيها prompts جاهزة تنسخها وتعدّلها. في هذا الدرس ستتعرّف عليها، وتتعلّم الأسرار التي تجعل أي prompt ينجح.

🎯 ماذا ستتعلم؟

بنهاية هذا الدرس ستكون قادرًا على:

• شرح ما هي Prompt library، وكيف تستخدم prompt فيه slots.
• اختيار prompt مناسب لبدء العمل على مشروع جديد عليك.
• تطبيق الأسرار الستة لكتابة prompt واضح.
• توجيه Claude Code عندما تأتي النتيجة غير ما أردت.
• تحويل prompt ناجح إلى شيء تعيد استخدامه.

🧰 ماذا تحتاج قبل أن تبدأ؟

Claude Code مثبّت، وتعرف كيف تبدأ جلسة. إن لم تفعل، فاقرأ ما هو Claude Code؟ دليل التثبيت والبداية. وتذكّر أن حساب Claude يملكه شخص بالغ (18 سنة فأكثر) يتعلّم معك.

الفكرة ببساطة

تذكّر ورقة العمل في المدرسة: «أكمل الفراغ: عاصمة السعودية هي ______». الجملة جاهزة، وأنت تضع الكلمة المناسبة فقط.

Prompt library تعمل بالطريقة نفسها. فيها prompts كتبها خبراء، وفي كل prompt فراغات صغيرة. تملأ الفراغ بما يناسب مشروعك، ثم تنسخ الـ prompt إلى Claude Code.

الـ prompt هو الرسالة التي تكتبها لـ Claude Code لتخبره بما تريد. وكلما كان الـ prompt أوضح، كان العمل أدق.

الخطوة 1: كيف تُنظَّم Prompt library؟

المكتبة مقسّمة حسب مراحل العمل على أي مشروع برمجي، من أوله إلى آخره:

وفي كل prompt كلمات بين قوسين معقوفين مثل {path}. هذه هي slots. تستبدلها بشيء من مشروعك، مثل اسم ملف.

الخطوة 2: prompts «Start here»

بعض الـ prompts في المكتبة عليها علامة Start here. فهي أنسب ما تبدأ به. هذه ترجمة لها، مطبّقة على مشروع لعبة أسئلة:

أعطني نظرة عامة على هذا المشروع: طريقة بنائه، وأهم مجلداته، وكيف ترتبط أجزاؤه

أين نحسب نقاط اللاعب في هذه اللعبة؟

اكتب اختبارات لملف quiz.py، ثم شغّلها، وأصلح أي فشل

راجع تغييراتي التي لم أحفظها بعد، ونبّهني لأي شيء يبدو خطرًا قبل أن أحفظ

اختبار test_score يفشل. اعرف السبب وأصلحه

لاحظ أن الـ prompts الأولين لا يغيّران شيئًا في ملفاتك. لذلك هما بداية آمنة مع أي مشروع جديد.

الخطوة 3: الأسرار الستة للـ prompt الناجح

prompts المكتبة تشترك في ستة أسرار. إن فهمتها، تستطيع كتابة prompts خاصة بك بثقة.

1. صِف النتيجة، لا الخطوات. قل ماذا تريد، ودع Claude Code يجد الملفات بنفسه.

أضف مؤقتًا لكل سؤال في اللعبة، وتأكد أن الاختبارات الحالية ما زالت تنجح

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

أصلح دالة حساب المعدّل، ثم شغّلها على الدرجات 80 و90 و100 وتأكد أن الناتج 90

3. أشِر إلى مثال موجود. اذكر ملفًا يشبه ما تريد، ليكون الكود الجديد متّسقًا معه.

أضف صفحة لنتائج الفرق بنفس تصميم صفحة جدول المباريات

4. حدّد هدفًا يمكن قياسه. بدل «اجعله أسرع» قل رقمًا واضحًا. هكذا يعرف الجميع متى انتهى العمل.

اجعل تحميل الصفحة أقل من ثانيتين، وأخبرني ماذا غيّرت

5. أعطه الشيء نفسه. الصق رسالة الخطأ كما هي، أو اكتب @ ثم اسم الملف. فيقرأ Claude Code الأصل، لا وصفك له.

لماذا يفشل البرنامج؟ @error.log

6. قل كيف تريد الإجابة. حدّد الشكل والطول ولمن الشرح.

اشرح كيف تعمل دالة ترتيب اللاعبين في خمس نقاط قصيرة لطالب مبتدئ

الخطوة 4: عندما لا تعجبك النتيجة

الخطأ جزء طبيعي من العمل، حتى مع مساعد ذكي. في المكتبة prompts خاصة لتوجيه Claude Code عندما يبتعد عمّا تريد:

هذا ليس صحيحًا: أردت أن تظهر النتيجة بعد كل سؤال، لا في النهاية فقط. جرّب طريقة أخرى

هذا أكثر من اللازم. احتفظ بتغييرات ملف quiz.py فقط، وتراجع عن باقي التعديلات

أنت تكرّر استخدام أسماء متغيّرات بالعربي. أضف قاعدة إلى CLAUDE.md حتى لا يتكرر هذا

الـ prompt الأخير ذكي جدًا. فهو لا يصلح الخطأ الآن فقط، بل يمنعه في كل الجلسات القادمة.

الخطوة 5: اجعل الـ prompt الناجح يتكرر

وجدت prompt يعمل جيدًا مع مشروعك؟ لا تكتبه من جديد كل مرة. عندك طريقتان:

• احفظه Skill. كما تعلّمت في درس Skills، فتشغّله بأمر قصير مثل /check-quiz.
• سجّل ما تعلّمه Claude Code في CLAUDE.md. فتبدأ كل جلسة وهو يعرف قواعد مشروعك.

وفي نهاية أي جلسة مفيدة، جرّب هذا الـ prompt من المكتبة:

لخّص ما فعلناه في هذه الجلسة، واقترح ما يجب إضافته إلى CLAUDE.md

🚀 للمتقدمين: قبل بناء ميزة كبيرة، جرّب أن تطلب من Claude Code أن يسألك هو. مثلًا: «أريد أن أبني لوحة صدارة للعبة. اسألني عن طريقة التنفيذ والحالات الخاصة حتى نغطي كل شيء، ثم اكتب المواصفات في ملف SPEC.md». هكذا تكتشف أسئلة لم تفكر فيها قبل أن تكتب سطرًا واحدًا.

⚠️ أخطاء شائعة

1. prompt بلا طريقة للتحقق.

❌ أصلح دالة المعدّل

✅ الحل: أضف ما يثبت النجاح: «أصلح دالة المعدّل، ثم شغّلها على مثال وأرني الناتج».

2. وصف الخطأ بدل لصقه.

❌ البرنامج فيه خطأ في المتغيّر تقريبًا

✅ الحل: الصق رسالة الخطأ كاملة كما ظهرت لك. فهي تحمل اسم الملف ورقم السطر.

3. هدف غامض.

❌ حسّن اللعبة

✅ الحل: حدّد ماذا تعني «أحسن»: «أضف 5 أسئلة جديدة عن الفضاء، واجعل اللعبة تعرض النتيجة بالنسبة المئوية».

🧪 جرّب بنفسك

التحدي 1 (سهل): املأ الـ slot في هذا الـ prompt من المكتبة ليناسب مشروع جدول حصص مدرسي: اشرح ماذا يفعل {path} وكيف تنتقل البيانات خلاله.

اشرح ماذا يفعل ملف timetable.py وكيف تنتقل البيانات خلاله

التحدي 2 (متوسط): هذا الـ prompt ضعيف: «اكتب دالة تجمع مصروفي». أعد كتابته باستخدام سرّين على الأقل من الأسرار الستة.

اكتب دالة في ملف money.py تجمع مصروفي الأسبوعي من قائمة أرقام. شغّلها على 5 و10 و15 وتأكد أن الناتج 30

التحدي 3 (للمتقدمين): Claude Code يكتب دائمًا تعليقات طويلة جدًا في الكود. اكتب prompt توجيه يصلح هذا في كل الجلسات القادمة.

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

✅ اختبر نفسك

1. ماذا تعني الكلمة {path} داخل prompt من المكتبة؟ (أ) أمر يجب كتابته كما هو (ب) slot تستبدله بشيء من مشروعك (ج) خطأ في الـ prompt
2. صح أم خطأ: إضافة طريقة للتحقق إلى الـ prompt تجعل Claude Code يحاول ويصحّح بدل التوقف بعد محاولة واحدة.
3. ماذا تكتب في الـ prompt لتشير إلى ملف اسمه build.log؟

📝 الخلاصة

• Prompt library مجموعة prompts جاهزة مقسّمة حسب مراحل العمل، وفيها slots تملؤها.
• prompts «Start here» بداية آمنة، وأولها يشرح لك المشروع دون أن يغيّر شيئًا.
• الأسرار الستة: النتيجة، والتحقق، والمثال، والهدف المقيس، ولصق الأصل، وشكل الإجابة.
• عندما لا تعجبك النتيجة، وجّه Claude Code بوضوح، وأضف قاعدة إلى CLAUDE.md.
• الـ prompt الناجح احفظه Skill، ليعمل بأمر قصير.

⏭️ الخطوة التالية

صرت تعرف كيف تتحدث مع Claude Code بوضوح. في الدرس التالي ستربطه بأدواتك الأخرى: MCP Servers: اربط Claude Code بأدواتك. وتستطيع متابعة كل الدروس في مسار Claude.