سكل احترافي من الصفر

الهدف

تبني سكلًا احترافيًا في كلود كود بملف SKILL.md وسكربتات وقوالب، وتفهم كيف يتفعّل، وكيف تشاركه مع الفريق.

الشرح

في المتوسط بنيت سكلًا بسيطًا (تعليمات). الآن نبني سكلًا احترافيًا: مجلد كامل فيه تعليمات، وسكربتات تنفّذ خطوات، وقوالب جاهزة، وأمثلة.

المكان

• للمشروع: .claude/skills/اسم-السكل/SKILL.md (يُشارك مع الفريق عبر Git).
• شخصي: ~/.claude/skills/اسم-السكل/SKILL.md (لك في كل المشاريع).

الهيكل

.claude/skills/quote-generator/
├── SKILL.md            ← التعليمات (إجباري)
├── template.docx       ← قالب عرض السعر بهوية الشركة
├── prices.csv          ← قائمة الأسعار المعتمدة
├── scripts/
│   └── build_quote.py  ← سكربت يعبّي القالب ويصدّر PDF
└── examples/
    └── sample-quote.md ← مثال عرض نهائي ممتاز

ملف SKILL.md

---
name: quote-generator
description: يبني عرض سعر رسمي بهوية الشركة من طلب الزبون. يُستخدم عند أي طلب فيه «عرض سعر» أو «تسعيرة» أو «كم يكلّف».
---
# خطوات العمل
1. اقرأ طلب الزبون واستخرج: المنتجات، الكميات، المقاسات، الموعد.
2. إذا ناقص شي من الأربعة، اسأل عنه قبل أي حساب.
3. احسب الأسعار من prices.csv فقط. لا تخمّن سعرًا.
4. الضريبة ١٥٪ تُضاف على الإجمالي. مدة الصلاحية ١٤ يومًا.
5. شغّل scripts/build_quote.py لإنتاج PDF من template.docx.
6. اعرض ملخص العرض قبل الإرسال.

# القواعد
- اللغة عربية رسمية. الأرقام إنجليزية.
- لا خصومات إلا بطلب صريح مني.
- راجع examples/sample-quote.md للمستوى المطلوب.

الوصف هو مفتاح التفعيل: كلود يقرأه ليقرر هل السكل مناسب. اكتبه بالكلمات اللي يستخدمها الناس فعلًا.

كيف يتفعّل؟

تكتب في أي جلسة: «زبون يبي ٣ أبواب WPC مقاس ٩٠×٢١٠ وتسليم بعد أسبوعين، سوّ عرض سعر». كلود يلاحظ تطابق الوصف، يقرأ SKILL.md، ويمشي على الخطوات. وتقدر تستدعيه مباشرة بـ /quote-generator.

السكربتات

السكربت يضمن النتيجة الثابتة: نفس القالب، نفس الحساب، نفس الإخراج. اطلب من كلود كود: «اكتب سكربت build_quote.py يقرأ JSON فيه البنود ويعبّي القالب ويصدّر PDF» وهو يبنيه ويختبره.

المشاركة

السكل داخل المشروع يُرفع مع Git، فكل من يسحب المشروع يحصل عليه. للفريق: مجلد سكلز موحّد في مستودع مشترك.

خطوة بخطوة

1. اختر مهمة متكررة بمخرج ثابت.
2. اجمع: قالب، بيانات معتمدة، مثال ممتاز.
3. أنشئ المجلد واكتب SKILL.md (اسم، وصف دقيق، خطوات، قواعد).
4. اطلب من كلود كود كتابة السكربت واختباره.
5. جرّب بطلب طبيعي بدون ذكر اسم السكل.

برومبتات جاهزة

ابنِ لي سكلًا احترافيًا في .claude/skills/[الاسم]/ للمهمة: [اشرحها]. يجب أن يتضمن: SKILL.md بوصف يتفعّل عند [الكلمات]، خطوات واضحة، قواعد [...]، سكربت في scripts/ ينفّذ [الخطوة الآلية] ويختبر نفسه، ومثالًا ممتازًا في examples/. بعد البناء جرّبه على طلب تجريبي واعرض النتيجة.

السكل تفعّل في طلب ما يخصه / ما تفعّل في طلب يخصه. راجع الوصف في SKILL.md وأعد صياغته ليتطابق مع الطلبات الحقيقية التالية: [أمثلة] ولا يتطابق مع: [أمثلة].

أخطاء شائعة

• وصف غامض: لا يتفعّل أو يتفعّل خطأ.
• بدون مثال ممتاز: المستوى يتذبذب.
• سكربت غير مختبر: يفشل عند أول زبون.

تمرين

ابنِ سكل «عرض سعر» (أو ما يعادله في نشاطك) كاملًا: SKILL.md، قالب، بيانات، سكربت، مثال. اطلب عرضًا بطلب طبيعي وتأكد إنه تفعّل وأخرج PDF.

الخلاصة

السكل الاحترافي مجلد: تعليمات + سكربتات + قوالب + أمثلة. الوصف يفعّله، السكربت يثبّت النتيجة، وGit يشاركه مع الفريق.