كيف تكتب سكِل احترافي؟ دليل من التجربة العملية

الفرق بين سكِل يُستخدم كل يوم وسكِل ينساه صاحبه بعد أسبوع هو التفاصيل. هذي الدروس اللي طلعنا بها بعد بناء عشرات السكِلات.

١. الوصف أهم من المحتوى

الوصف هو ما يقرّر متى يُحمَّل السكِل. وصف غامض يعني سكِلاً لا يُستدعى أبداً، أو يُستدعى في غير محله. اكتب فيه المصطلحات الفعلية اللي يستخدمها الناس، بما فيها العامية والمرادفات والأخطاء الشائعة.

٢. اكتب إجراءً لا مقالاً

السكِل ليس شرحاً تعليمياً — هو إجراء تشغيلي. خطوات مرقّمة، وقرارات واضحة: «إن كان كذا، افعل كذا». المعلومات العامة اللي يعرفها النموذج أصلاً حشو يضعف السكِل ويشتّته.

٣. حدّد معيار الجودة

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

٤. افصل المرجع عن التعليمات

التعليمات قصيرة ومباشرة، والمواد الطويلة — قوالب، جداول، أمثلة كاملة — في ملفات منفصلة تُقرأ عند الحاجة. سكِل ضخم بملف واحد يستهلك مساحة السياق ويقلّ تركيزه.

٥. اذكر ما لا يجب فعله

الحدود توضّح المهمة أكثر من التوسّع في وصفها. «لا تضف أقساماً لم تُطلب»، «لا تخترع أرقاماً»، «لا تغيّر النبرة». هذي الأسطر تمنع أكثر الأخطاء تكراراً.

٦. اختبره على حالات حقيقية

• حالة نموذجية متوقّعة تماماً.
• حالة على الحافة: مدخلات ناقصة أو غريبة.
• حالة يجب ألا يُستدعى فيها السكِل أصلاً.

لو نجح في الثلاث، السكِل جاهز. ولو فشل، غالباً المشكلة في الوصف أو في غياب معيار الجودة.

نبني سكِلات مخصصة لطريقة عمل فريقك، ونشارك ما ينفع الجميع في متجرنا. عندك مهمة تتكرّر يومياً؟ هذي أول مرشّحة لسكِل خاص.