/ الدليل / الملعب / agent-skill-tdd
← كل الخوادم ↗ GitHub
● مجتمع 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

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

agent-skill-tdd-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-skill-tdd-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-skill-tdd-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
          "~/.claude/skills/agent-skill-tdd"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add agent-skill-tdd-skill -- git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: agent-skill-tdd

تنفيذ ميزة جديدة مع انضباط TDD كامل

👤 الفرق التي يقفز فيها مبرمجو الذكاء الاصطناعي إلى التنفيذ ويفوتون المتطلبات ⏱ ~120 min intermediate

متى تستخدمه: ميزة غير تافهة حيث أحرقتك نهج 'اكتبها فقط' من قبل

المتطلبات الأساسية
  • تم استنساخ المهارة — git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd
  • Serena متاح — ثبّت خادم Serena MCP
  • Lad MCP لمراجعة التصميم — ثبّت خادم Lad MCP
الخطوات
  1. بدء المهارة
    استخدم agent-skill-tdd. أريد إضافة ميزة 'البحوث المحفوظة'. ابدأ من المرحلة 1 — فعّل Serena وقم بالتحقيق✓ تم النسخ
    → يقرأ Claude الكود، ويلخص الحالة الراهنة
  2. توضيح المتطلبات
    أكّد أن ما قلته للتو يطابق معايير القبول هذه — لا تكود بعد✓ تم النسخ
    → حوار متبادل حتى التأكيد؛ تم حفظ ملف .requirements/
  3. مراجعة التصميم عبر Lad
    قم بمراجعة التصميم — توافق العمارة، النقاط الحساسة✓ تم النسخ
    → نقد التصميم، وليس مجرد موافقة
  4. حلقة TDD
    الآن ابدأ TDD — اكتب اختبار فاشل، الحد الأدنى من الكود للنجاح، أعد الهيكلة. مراجعة من الأقران لكل خطوة✓ تم النسخ
    → دورات أحمر-أخضر-إعادة هيكلة، كل واحدة تمت مراجعتها

النتيجة: ميزة منشورة مع الاختبارات، وسجل المتطلبات، والمنطق التصميمي محفوظ

المزالق
  • تخطي التوضيح 'لتوفير الوقت' — هنا حيث يُفقد معظم قيمة البرمجة بالذكاء الاصطناعي — احزم صفوفك
اجمعها مع: filesystem · github

إصلاح خلل بعد كتابة السلوك الصحيح

👤 المطورون التعبانون من 'الإصلاحات' بالذكاء الاصطناعي التي تكسر المسارات الأخرى ⏱ ~60 min intermediate

متى تستخدمه: خلل دقيق حيث يكون إعادة الإنتاج نصف المعركة

الخطوات
  1. التحقيق + التوثيق
    استخدم وضع الأخطاء في agent-skill-tdd. العرض: <الوصف>. اكتب إعادة الإنتاج + السلوك المتوقع إلى .requirements/ أولاً✓ تم النسخ
    → وثيقة مختومة بالتاريخ والوقت مع الحالة الراهنة والحالة المستهدفة
  2. اكتب اختبار فاشل
    اختبار يعبر عن السلوك المتوقع — حالياً فاشل✓ تم النسخ
    → اختبار أحمر
  3. الإصلاح + مراجعة الأقران
    الحد الأدنى من الإصلاح للنجاح. مراجعة من الأقران✓ تم النسخ
    → أخضر + ملاحظات المراجعة

النتيجة: إصلاح خلل مع اختبار يمنع الانحدار

توقف قبل التنفيذ — تحقق من أنك تفهم الموصفة

👤 الفرق التي يسبب فيها سوء فهم الموصفة إعادة العمل ⏱ ~30 min beginner

متى تستخدمه: التذكرة غامضة وتشك في أنك على وشك بناء الشيء الخاطئ

الخطوات
  1. قم بتشغيل المراحل 1–4 فقط
    استخدم agent-skill-tdd — التحقيق + التوضيح + التوثيق + مراجعة التصميم. توقف قبل الترميز✓ تم النسخ
    → وثيقة المتطلبات + مراجعة التصميم دون لمس الكود

النتيجة: إما تكتشف أنك أساءت قراءة التذكرة أو تعطي الضوء الأخضر بثقة

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

agent-skill-tdd-skill + filesystem

احتفظ بـ .requirements/ في المستودع ليقرأه الوكلاء في المستقبل

قم بعمل commit لـ .requirements/ على git حتى تكون لديك السياق في الجلسة التالية✓ تم النسخ
agent-skill-tdd-skill + github

اربط وثيقة المتطلبات في وصف الـ PR

عند فتح الـ PR، الصق مسار ملف .requirements/ في الوصف✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
activate_serena repo path المرحلة 1 0 — local
investigate task description المرحلة 2 0
clarify task, user answers المرحلة 3 0
document_requirements confirmed requirements المرحلة 4 0
design_review requirements + repo المرحلة 5 0
tdd_cycle requirements المرحلة 6 0

التكلفة والحدود

تكلفة التشغيل

حصة API
بلا من المهارة؛ Serena و Lad لهما بصماتهما الخاصة
الرموز لكل استدعاء
معتدل — كل خطوة رحلة ذهاب وإياب
التكلفة المالية
مجاني
نصيحة
الـ 6 مراحل كاملة مبالغة في المهام التافهة — شغّل المراحل 1–4 فقط في العمل الصغير

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: بلا
نقل البيانات الخارجي: فقط عبر Serena/Lad إن تم تكوينها

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Serena غير متاح

ثبّت خادم Serena MCP وسجّله مع وكيلك

لم يتم إنشاء وثيقة المتطلبات

تأكد من وصول الكتابة في نظام الملفات إلى .requirements/

تحقق: ls .requirements/
خطوة مراجعة التصميم تبدو موافقة شكلية

فرض إطار معاديل: 'ما أقوى اعتراض على هذا التصميم؟'

البدائل

agent-skill-tdd مقابل البدائل

البديلمتى تستخدمهاالمقايضة
سير عمل claude-gptتريد مراجعة عبر النماذج بدلاً من انضباط TDD الذاتيتكلفة API أعلى
مهارة التخطيط مع الملفاتتريد الاستمرارية عبر الجلسات ولكن بقوة TDD أقللا توجد فرض الاختبار أولاً

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills