● مجتمع
Shelpuk-AI-Technology-Consulting
⚡ فوري
agent-skill-tdd
بواسطة Shelpuk-AI-Technology-Consulting · Shelpuk-AI-Technology-Consulting/agent-skill-tdd
سير عمل سداسي المراحل يفرض على وكلاء البرمجة بالذكاء الاصطناعي التزام 'المتطلبات أولاً، الاختبار أولاً' — Serena + وثائق المتطلبات + مراجعة التصميم عبر Lad MCP + TDD + المراجعة من الأقران
مهارة تأديبية لوكلاء البرمجة. تفعّل Serena للملاحة الدلالية في الكود، وتفرض التحقيق قبل إجراء التغييرات، وتطالب بتأكيد المتطلبات الصريح، وتكتب وثائق .requirements/ مختومة بالتاريخ والوقت تتضمن الحالة الراهنة/الحالة المستهدفة/معايير القبول، وتتحقق من العمارة عبر خادم Lad MCP، ثم تشغل TDD صارمة مع مراجعة من الأقران لكل تغيير. تدّعي تحسناً في الجودة بنسبة 15–20%. تعمل مع Claude Code و Codex و Cursor و Windsurf و Antigravity
لماذا تستخدمه
الميزات الأساسية
- سير عمل بست مراحل: Serena -> التحقيق -> التوضيح -> التوثيق -> مراجعة التصميم -> TDD
- وثائق
.requirements/ مختومة بالتاريخ والوقت لكل مهمة - تأكيد المتطلبات الصريح قبل الترميز
- مراجعة العمارة عبر Lad MCP قبل التنفيذ
- مراجعة من الأقران لكل تغيير
- غير متعلقة بنوع الوكيل — Claude Code و Codex و Cursor و Windsurf و Antigravity
عرض مباشر
كيف يبدو في الممارسة
agent-skill-tdd-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: agent-skill-tdd
متى تستخدمه: ميزة غير تافهة حيث أحرقتك نهج 'اكتبها فقط' من قبل
الخطوات
-
بدء المهارة
استخدم agent-skill-tdd. أريد إضافة ميزة 'البحوث المحفوظة'. ابدأ من المرحلة 1 — فعّل Serena وقم بالتحقيق✓ تم النسخ
→ يقرأ Claude الكود، ويلخص الحالة الراهنة
-
توضيح المتطلبات
أكّد أن ما قلته للتو يطابق معايير القبول هذه — لا تكود بعد✓ تم النسخ
→ حوار متبادل حتى التأكيد؛ تم حفظ ملف .requirements/
-
مراجعة التصميم عبر Lad
قم بمراجعة التصميم — توافق العمارة، النقاط الحساسة✓ تم النسخ
→ نقد التصميم، وليس مجرد موافقة
-
حلقة TDD
الآن ابدأ TDD — اكتب اختبار فاشل، الحد الأدنى من الكود للنجاح، أعد الهيكلة. مراجعة من الأقران لكل خطوة✓ تم النسخ
→ دورات أحمر-أخضر-إعادة هيكلة، كل واحدة تمت مراجعتها
النتيجة: ميزة منشورة مع الاختبارات، وسجل المتطلبات، والمنطق التصميمي محفوظ
المزالق
- تخطي التوضيح 'لتوفير الوقت' — هنا حيث يُفقد معظم قيمة البرمجة بالذكاء الاصطناعي — احزم صفوفك
متى تستخدمه: خلل دقيق حيث يكون إعادة الإنتاج نصف المعركة
الخطوات
-
التحقيق + التوثيق
استخدم وضع الأخطاء في agent-skill-tdd. العرض: <الوصف>. اكتب إعادة الإنتاج + السلوك المتوقع إلى .requirements/ أولاً✓ تم النسخ
→ وثيقة مختومة بالتاريخ والوقت مع الحالة الراهنة والحالة المستهدفة
-
اكتب اختبار فاشل
اختبار يعبر عن السلوك المتوقع — حالياً فاشل✓ تم النسخ
→ اختبار أحمر
-
الإصلاح + مراجعة الأقران
الحد الأدنى من الإصلاح للنجاح. مراجعة من الأقران✓ تم النسخ
→ أخضر + ملاحظات المراجعة
النتيجة: إصلاح خلل مع اختبار يمنع الانحدار
متى تستخدمه: التذكرة غامضة وتشك في أنك على وشك بناء الشيء الخاطئ
الخطوات
-
قم بتشغيل المراحل 1–4 فقط
استخدم agent-skill-tdd — التحقيق + التوضيح + التوثيق + مراجعة التصميم. توقف قبل الترميز✓ تم النسخ
→ وثيقة المتطلبات + مراجعة التصميم دون لمس الكود
النتيجة: إما تكتشف أنك أساءت قراءة التذكرة أو تعطي الضوء الأخضر بثقة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
احتفظ بـ .requirements/ في المستودع ليقرأه الوكلاء في المستقبل
قم بعمل commit لـ .requirements/ على git حتى تكون لديك السياق في الجلسة التالية✓ تم النسخ
agent-skill-tdd-skill +
githubاربط وثيقة المتطلبات في وصف الـ PR
عند فتح الـ PR، الصق مسار ملف .requirements/ في الوصف✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- بلا من المهارة؛ Serena و Lad لهما بصماتهما الخاصة
- الرموز لكل استدعاء
- معتدل — كل خطوة رحلة ذهاب وإياب
- التكلفة المالية
- مجاني
- نصيحة
- الـ 6 مراحل كاملة مبالغة في المهام التافهة — شغّل المراحل 1–4 فقط في العمل الصغير
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: بلا
نقل البيانات الخارجي: فقط عبر Serena/Lad إن تم تكوينها
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
Serena غير متاح
ثبّت خادم Serena MCP وسجّله مع وكيلك
لم يتم إنشاء وثيقة المتطلبات
تأكد من وصول الكتابة في نظام الملفات إلى .requirements/
تحقق: ls .requirements/
خطوة مراجعة التصميم تبدو موافقة شكلية
فرض إطار معاديل: 'ما أقوى اعتراض على هذا التصميم؟'
البدائل
agent-skill-tdd مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| سير عمل claude-gpt | تريد مراجعة عبر النماذج بدلاً من انضباط TDD الذاتي | تكلفة API أعلى |
| مهارة التخطيط مع الملفات | تريد الاستمرارية عبر الجلسات ولكن بقوة TDD أقل | لا توجد فرض الاختبار أولاً |