skill

تطوير مدفوع بالاختبار

التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبارات التكامل.

mattpocock1,046,962+ تثبيتموثوق

نبذة

# التطوير الموجه بالاختبار (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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل تطوير مدفوع بالاختبار مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل تطوير مدفوع بالاختبار ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
نشر Azure
نفذ عمليات نشر Azure للتطبيقات المعدة مسبقا والتي تحتوي على ملفات .azure/deployment-plan.md والبنية التحتية الموجودة. لا تستخدم هذه المهارة عندما يطلب…618,328+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة