skill
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبارات التكامل.
نبذة
# التطوير الموجه بالاختبار (TDD)
التطوير الموجه بالاختبار (TDD) هو حلقة "أحمر ← أخضر". هذه المهارة هي المرجع الذي يجعل هذه الحلقة تنتج اختبارات تستحق الاحتفاظ بها: ما هو الاختبار الجيد، أين توضع الاختبارات، الأنماط المضادة، وقواعد الحلقة. ينطبق كل قسم على كل دورة: استشرها قبل وأثناء الحلقة، وليس بعدها.
عند استكشاف قاعدة الكود، اقرأ `GLOSSARY.md` (إذا كان موجودا) بحيث تتطابق أسماء الاختبارات ومفردات الواجهة مع لغة المجال للمشروع، واحترم ADRs في المنطقة التي تعمل عليها.
## ما هو الاختبار الجيد
تتحقق الاختبارات من السلوك من خلال الواجهات العامة، وليس تفاصيل التنفيذ. يمكن أن يتغير الكود بالكامل؛ لا ينبغي أن تتغير الاختبارات. يقرأ الاختبار الجيد كالمواصفات: "يمكن للمستخدم إتمام الشراء بسلة تسوق صالحة" يخبرك بالضبط ما هي القدرة الموجودة، ويصمد أمام عمليات إعادة الهيكلة لأنه لا يهتم بالهيكل الداخلي.
انظر [tests.md](tests.md) للأمثلة و [mocking.md](mocking.md) لإرشادات المحاكاة.
## نقاط الاتصال (Seams): أين توضع الاختبارات
**نقطة الاتصال (Seam)** هي الحدود العامة التي تختبر عندها: الواجهة التي تلاحظ عندها السلوك دون الوصول إلى الداخل. تعيش الاختبارات عند نقاط الاتصال، ولا تكون أبدا ضد الأجزاء الداخلية.
**اختبر فقط عند نقاط الاتصال المتفق عليها مسبقا.** قبل كتابة أي اختبار، اكتب نقاط الاتصال قيد الاختبار وقم بتأكيدها مع المستخدم. لا يتم كتابة أي اختبار عند نقطة اتصال غير مؤكدة. لا يمكنك اختبار كل شيء، لذا فإن الاتفاق على نقاط الاتصال مقدما هو كيف يتركز جهد الاختبار على المسارات الحرجة والمنطق المعقد بدلا من كل حالة حافة.
اسأل: "ما هي الواجهة العامة، وما هي نقاط الاتصال التي يجب أن نختبرها؟" أعط كل نقطة اتصال مقترحة ملاحظة من سطر واحد حول ما تلتقطه وما تفوته.
عندما يكون شكل تلك الواجهة نفسه موضع تساؤل (مدى عمق الوحدة، أين تنتمي نقطة الاتصال، ما الذي يجب أن تكشفه الواجهة)، استدع أداة Skill باستخدام "codebase-design" للمفردات. إنه المصدر المشترك لمصطلحات الوحدة، الواجهة، العمق، نقطة الاتصال، المحول، الرافعة المالية، والمحلية، وهو مرجع للاستشارة، وليس جلسة لتشغيلها.
## الأنماط المضادة (Anti-patterns)
- **مرتبط بالتنفيذ (Implementation-coupled)**: يحاكي المتعاونين الداخليين، يختبر الطرق الخاصة، أو يتحقق من خلال قناة جانبية (الاستعلام عن قاعدة البيانات بدلا من استخدام الواجهة). العلامة: ينكسر الاختبار عند إعادة الهيكلة ولكن السلوك لم يتغير. - **تكراري (Tautological)**: يعيد التأكيد حساب القيمة المتوقعة بنفس الطريقة التي يعمل بها الكود (`expect(add(a, b)).toBe(a + b)`، لقطة مشتقة يدويا بنفس الطريقة، ثابت مؤكد يساوي نفسه)، لذلك يمر بالبناء ولا يمكن أن يختلف أبدا مع الكود. يجب أن تأتي القيم المتوقعة من مصدر مستقل للحقيقة: حرفي معروف جيد، مثال عملي، المواصفات. - **التقطيع الأفقي (Horizontal slicing)**: كتابة جميع الاختبارات أولا، ثم جميع عمليات التنفيذ. تتحقق الاختبارات المجمعة من السلوك _المتخيل_: تختبر _شكل_ الأشياء بدلا من السلوك الموجه للمستخدم، وتصبح الاختبارات غير حساسة للتغييرات الحقيقية، وتلتزم بهيكل الاختبار قبل فهم التنفيذ. اعمل في **شرائح عمودية (vertical slices)** بدلا من ذلك: اختبار واحد ← تنفيذ واحد ← كرر، كل اختبار هو **رصاصة تتبع (tracer bullet)** تستجيب لما علمته الدورة الأخيرة.
## قواعد الحلقة
- **أحمر قبل أخضر.** اكتب الاختبار الفاشل أولا، ثم فقط ما يكفي من الكود لتمريره. لا تتوقع الاختبارات المستقبلية أو تضيف ميزات تخمينية. - **شريحة واحدة في كل مرة.** نقطة اتصال واحدة، اختبار واحد، تنفيذ واحد بحد أدنى لكل دورة. - **إعادة الهيكلة ليست جزءا من الحلقة.** إنها تنتمي إلى مرحلة المراجعة (انظر مهارة `code-review`)، وليس دورة التنفيذ "أحمر ← أخضر".
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/tdd` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تطوير مدفوع بالاختبار؟
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبارات التكامل.
كيف أثبت تطوير مدفوع بالاختبار؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل تطوير مدفوع بالاختبار؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تطوير مدفوع بالاختبار؟
طورها mattpocock.
هل تطوير مدفوع بالاختبار مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى