المهارات tdd-workflows-tdd-cycle
📦

tdd-workflows-tdd-cycle

آمن ⚙️ الأوامر الخارجية

إتقان سير عمل التطوير القائم على الاختبار (TDD)

يكافح المطورون للحفاظ على انضباط TDD أثناء إدارة المشاريع المعقدة. تقوم هذه المهارة بتنسيق الوكلاء المتخصصين من خلال دورات صارمة من الأحمر-الأخضر-إعادة الهيكلة مع التحقق التلقائي وتتبع التغطية.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "tdd-workflows-tdd-cycle". سير عمل TDD لواجهة API تسجيل المستخدم

النتيجة المتوقعة:

اكتملت المرحلة 1: تم إنشاء مواصفات الاختبار مع 12 سيناريو اختبار تغطي المسار السعيد، أخطاء التحقق من الصحة، المستخدمين المكررين، والحالات الحدية. اكتملت المرحلة 2: تم كتابة 12 اختبار وحدة فاشلة. اكتملت المرحلة 3: الحد الأدنى من التنفيذ يجتاز جميع الاختبارات. اكتملت المرحلة 4: تمت إعادة الهيكلة لتقليل التعقيد الحلقي من 12 إلى 6.

استخدام "tdd-workflows-tdd-cycle". سير عمل TDD مع تحليل التغطية لوحدة التحقق من صحة البيانات

النتيجة المتوقعة:

تقرير التغطية: تغطية السطور 87%، تغطية الفروع 79%، تغطية الدوال 92%. جميع الاختبارات ناجحة. توصيات إعادة الهيكلة: استخراج منطق التحقق من الصحة إلى استراتيجيات منفصلة، تقليل طول الطريقة في validateUserInput من 28 إلى 15 سطرًا.

التدقيق الأمني

آمن
v1 • 2/25/2026

All 15 static analysis findings are false positives. The external_commands pattern matched documentation references (opening markdown files, flag examples) not actual shell execution. Cryptographic and reconnaissance patterns matched unrelated TDD workflow text. This skill safely orchestrates Claude Task agents for test-driven development workflows.

1
الملفات التي تم فحصها
224
الأسطر التي تم تحليلها
2
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (1)
SKILL.md:23SKILL.md:134SKILL.md:144
External Command Pattern - False Positive
Static analyzer detected Ruby/shell backtick execution pattern. Line 23 references opening a markdown documentation file. Lines 134 and 144 show command-line flag examples (--incremental, --suite). No actual shell execution occurs.

عوامل الخطر

⚙️ الأوامر الخارجية (3)
SKILL.md:23 SKILL.md:134 SKILL.md:144
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
32
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

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

تطوير ميزات جديدة باختبار أولاً مع انضباط TDD صارم، مما يضمن تغطية 100% من البداية.

تغطية اختبار الأكواد القديمة

إضافة تغطية اختبار شاملة للأكواد الموجودة باستخدام وضع مجموعة الاختبار مع تطوير الدُفعات.

تحسين جودة الكود

إعادة هيكلة الكود الحالي مع الحفاظ على تغطية الاختبار، باستخدام التحقق الآلي في كل خطوة.

جرّب هذه الموجهات

دورة TDD الأساسية 
ابدأ سير عمل TDD لتنفيذ وحدة مصادقة المستخدم. ابدأ بتحليل متطلبات المرحلة 1 وانتقل عبر دورة الأحمر-الأخضر-إعادة الهيكلة.
تطوير الاختبار التدريجي 
نفذ سير عمل TDD لنقطة نهاية REST API مع علم --incremental. اكتب اختبارًا فاشلاً واحدًا في كل مرة، اجعله ينجح، ثم أعد الهيكلة قبل المتابعة.
مجموعة الاختبار الشاملة 
نفذ سير عمل TDD لوحدة معالجة المدفوعات مع علم --suite. اكتب جميع الاختبارات الفاشلة أولاً، ثم نفذها لاجتياز جميع الاختبارات، ثم أعد هيكلة الوحدة بالكامل.
تحسين التغطية 
حلل تغطية الاختبار الحالية لوحدة خدمة المستخدم ونفذ المرحلة 11 لإضافة اختبارات الأداء وتغطية الحالات الحدية. استهدف تغطية فرع 90%.

أفضل الممارسات

  • تحقق دائمًا من فشل الاختبارات للأسباب الصحيحة قبل تنفيذ الكود
  • نفذ الحد الأدنى من الكود المطلوب لاجتياز الاختبارات - لا ميزات إضافية
  • شغّل الاختبارات بعد كل تغيير في إعادة الهيكلة للتأكد من بقاء الاختبارات خضراء
  • توقف فورًا إذا تم كسر انضباط TDD وتراجع إلى الحالة الصالحة
  • حافظ على تنفيذ الاختبار تحت 5 ثوانٍ لاختبارات الوحدة للحفاظ على سرعة التغذية الراجعة

تجنب

  • كتابة كود التنفيذ قبل كتابة الاختبارات الفاشلة
  • كتابة اختبارات ناجحة بالفعل بدلاً من توجيه وظائف جديدة
  • تخطي مرحلة إعادة الهيكلة وتراكم الديون التقنية
  • تعديل الاختبارات لجعلها ناجحة بدلاً من إصلاح التنفيذ
  • تجاهل الاختبارات الفاشلة والمتابعة إلى الميزة التالية

الأسئلة المتكررة

ما هي دورة الأحمر-الأخضر-إعادة الهيكلة؟
أحمر: اكتب اختبارًا فاشلاً. أخضر: نفذ الحد الأدنى من الكود لجعله ناجحًا. إعادة الهيكلة: حسّن جودة الكود مع الحفاظ على نجاح الاختبارات. تضمن هذه الدورة التطوير القائم على الاختبار مع تحسين الجودة المستمر.
كيف أختار بين الوضع التدريجي ووضع المجموعة؟
استخدم الوضع التدريجي للمنطق المعقد الذي يتطلب تطويرًا حذرًا خطوة بخطوة. استخدم وضع المجموعة للميزات البسيطة حيث يمكنك تصميم جميع الاختبارات مسبقًا والتنفيذ على دفعات.
ماذا يحدث إذا فشلت اختباراتي أثناء إعادة الهيكلة؟
توقف فورًا وتراجع إلى آخر حالة صالحة. يجب ألا تغير إعادة الهيكلة السلوك. إذا فشلت الاختبارات، فقد قمت بتغيير الوظيفة بدلاً من مجرد تحسين البنية.
هل يمكنني تعديل عتبات التغطية؟
نعم. العتبات الافتراضية هي 80% لتغطية السطور، 75% لتغطية الفروع، و100% لتغطية المسار الحرج. اضبط بناءً على متطلبات المشروع وقيود الأكواد القديمة.
ما الأدوات التي تتطلبها هذه المهارة؟
تتطلب هذه المهيمرة أداة Claude Task مع الوصول إلى الوكلاء الفرعيين للاختبار ومراجعة الكود وتطوير الواجهة الخلفية. تقوم بتنسيق وكلاء متخصصين لكل مرحلة من مراحل TDD.
كيف تعمل استعادة الفشل؟
إذا تم كسر انضباط TDD، توقف فورًا، حدد المرحلة المنتهكة، تراجع إلى آخر حالة صالحة باستخدام التحكم في الإصدار، استأنف من المرحلة الصحيحة، ووثّق الدرس المستفاد.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/tdd-workflows-tdd-cycle

مرجع

main

بنية الملفات

📄 SKILL.md