skill
التطوير الموجه بالاختبار
يستخدم عند تنفيذ أي ميزة أو إصلاح خطأ، قبل كتابة كود التنفيذ.
نبذة
# التطوير الموجه بالاختبار (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يعمل مع
خطوات التثبيت
ثبت باستخدام `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.
هل التطوير الموجه بالاختبار مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى