skill

التطوير الموجه بالاختبار

يستخدم عند تنفيذ أي ميزة أو إصلاح خطأ، قبل كتابة كود التنفيذ.

obra240,574+ تثبيتموثوق

نبذة

# التطوير الموجه بالاختبار (TDD)

## نظرة عامة

اكتب الاختبار أولا. شاهده يفشل. اكتب الحد الأدنى من التعليمات البرمجية لتمريره.

**المبدأ الأساسي:** إذا لم تشاهد الاختبار يفشل، فأنت لا تعرف ما إذا كان يختبر الشيء الصحيح.

**انتهاك نص القواعد هو انتهاك لروح القواعد.**

## متى تستخدمه

**دائما:** - الميزات الجديدة - إصلاحات الأخطاء - إعادة الهيكلة - تغييرات السلوك

**الاستثناءات (اسأل شريكك البشري):** - النماذج الأولية التي يمكن التخلص منها - التعليمات البرمجية المولدة - ملفات التكوين

هل تفكر في "تجاوز TDD هذه المرة فقط"؟ توقف. هذا تبرير.

## القانون الحديدي

``` لا توجد تعليمات برمجية للإنتاج بدون اختبار فاشل أولا ```

هل كتبت التعليمات البرمجية قبل الاختبار؟ احذفها. ابدأ من جديد.

**لا استثناءات:** - لا تحتفظ بها ك "مرجع" - لا "تكيفها" أثناء كتابة الاختبارات - لا تنظر إليها - الحذف يعني الحذف

نفذ من الاختبارات مباشرة. نقطة.

## أحمر-أخضر-إعادة هيكلة

```dot digraph tdd_cycle { rankdir=LR; red [label="أحمر\nاكتب اختبارا فاشلا", shape=box, style=filled, fillcolor="#ffcccc"]; verify_red [label="تحقق من الفشل\nبشكل صحيح", shape=diamond]; green [label="أخضر\nالحد الأدنى من التعليمات البرمجية", shape=box, style=filled, fillcolor="#ccffcc"]; verify_green [label="تحقق من النجاح\nكل شيء أخضر", shape=diamond]; refactor [label="إعادة هيكلة\nتنظيف", shape=box, style=filled, fillcolor="#ccccff"]; next [label="التالي", shape=ellipse];

red -> verify_red; verify_red -> green [label="نعم"]; verify_red -> red [label="فشل\nخاطئ"]; green -> verify_green; verify_green -> refactor [label="نعم"]; verify_green -> green [label="لا"]; refactor -> verify_green [label="ابق\nأخضر"]; verify_green -> next; next -> red; } ```

### أحمر - اكتب اختبارا فاشلا

اكتب اختبارا واحدا بسيطا يوضح ما يجب أن يحدث.

<Good> ```typescript test('retries failed operations 3 times', async () => { let attempts = 0; const operation = () => { attempts++; if (attempts < 3) throw new Error('fail'); return 'success'; };

const result = await retryOperation(operation);

expect(result).toBe('success'); expect(attempts).toBe(3); }); ``` اسم واضح، يختبر سلوكا حقيقيا، شيء واحد </Good>

<Bad> ```typescript test('retry works', async () => { const mock = jest.fn() .mockRejectedValueOnce(new Error()) .mockRejectedValueOnce(new Error()) .mockResolvedValueOnce('success'); await retryOperation(mock); expect(mock).toHaveBeenCalledTimes(3); }); ``` اسم غامض، يختبر mock وليس التعليمات البرمجية </Bad>

**المتطلبات:** - سلوك واحد - اسم واضح - تعليمات برمجية حقيقية (لا mocks إلا إذا كان لا مفر منه)

### تحقق من الأحمر - شاهده يفشل

**إلزامي. لا تتخطاه أبدا.**

```bash npm test path/to/test.test.ts ```

تأكد من: - فشل الاختبار (وليس الأخطاء) - رسالة الفشل متوقعة - يفشل بسبب نقص الميزة (وليس الأخطاء الإملائية)

**هل نجح الاختبار؟** أنت تختبر سلوكا موجودا. أصلح الاختبار.

**هل حدث خطأ في الاختبار؟** أصلح الخطأ، أعد التشغيل حتى يفشل بشكل صحيح.

### أخضر - الحد الأدنى من التعليمات البرمجية

اكتب أبسط تعليمات برمجية لتمرير الاختبار.

<Good> ```typescript async function retryOperation<T>(fn: () => Promise<T>): Promise<T> { for (let i = 0; i < 3; i++) { try { return await fn(); } catch (e) { if (i === 2) throw e; } } throw new Error('unreachable'); } ``` يكفي فقط لتمرير الاختبار </Good>

<Bad> ```typescript async function retryOperation<T>( fn: () => Promise<T>, options?: { maxRetries?: number; backoff?: 'linear' | 'exponential'; onRetry?: (attempt: number) => void; } ): Promise<T> { // YAGNI } ``` هندسة زائدة </Bad>

لا تضف ميزات، أو تعيد هيكلة تعليمات برمجية أخرى، أو "تحسن" بما يتجاوز الاختبار.

### تحقق من الأخضر - شاهده ينجح

**إلزامي.**

```bash npm test path/to/test.test.ts ```

تأكد من: - نجاح الاختبار - الاختبارات الأخرى لا تزال ناجحة - الإخراج نظيف (لا أخطاء، لا تحذيرات)

**هل فشل الاختبار؟** أصلح التعليمات البرمجية، وليس الاختبار.

**هل فشلت اختبارات أخرى؟** أصلحها الآن.

**"الاختبارات الأخرى" تعني مجموعة المشروع، وليس ملفك فقط.** التشغيل الأخضر للاختبار الذي كتبته ليس مجموعة خضراء. قبل أن تعتبر التغيير منتهيا، قم بتشغيل أمر اختبار المشروع (فقط `pytest`، `npm test`، `cargo test` — أيا كان ما يستخدمه المستودع) حتى عندما تكون مهمتك قد ذكرت ملف اختبار واحدا فقط. بيان النطاق في مهمتك يحدد ما يجب تسليمه، وليس التحقق الخاص بك. أي فشل يظهره هذا التشغيل — بما في ذلك الفشل الذي لم تتسبب فيه — يجب أن يذكر في تقريرك بالاسم؛ الاختبار الأحمر الذي شاهدته يمر ولم تذكره هو تقرير مزور بالإغفال.

### إعادة هيكلة - تنظيف

بعد الأخضر فقط: - إزالة التكرار - تحسين الأسماء - استخراج المساعدين

حافظ على الاختبارات خضراء. لا تضف سلوكا.

### كرر

الاختبار الفاشل التالي للميزة التالية.

## الاختبارات الجيدة

| الجودة | جيد | سيء | |---------|------|-----| | **بسيط** | شيء واحد. "و" في الاسم؟ قسمه. | `test('validates email and domain and whitespace')` | | **واضح** | الاسم يصف السلوك | `test('test1')` | | **يظهر النية** | يوضح API المطلوب | يحجب ما يجب أن تفعله التعليمات البرمجية |

عند كتابة أو تغيير أي اختبار، اقرأ [writing-good-tests.md](writing-good-tests.md) للقواعد التي تحافظ على صدق الاختبارات: - Nam

التثبيت

شغل هذا الأمر

npx skills add obra/superpowers

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/test-driven-development` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة التطوير الموجه بالاختبار؟

يستخدم عند تنفيذ أي ميزة أو إصلاح خطأ، قبل كتابة كود التنفيذ.

كيف أثبت التطوير الموجه بالاختبار؟

شغل هذا الأمر في الطرفية:

npx skills add obra/superpowers
مع أي أدوات ذكاء اصطناعي تعمل التطوير الموجه بالاختبار؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور التطوير الموجه بالاختبار؟

طورها obra.

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

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

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل التطوير الموجه بالاختبار ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

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

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

المزيد في إنشاء المحتوى