● مجتمع
sivaprasadreddy
⚡ فوري
sivalabs-agent-skills
بواسطة sivaprasadreddy · sivaprasadreddy/sivalabs-agent-skills
مهارات Spring Boot للوكلاء الذين يكتبون أكواداً باستخدام الذكاء الاصطناعي — أساليب Boot 3.x الموصى بها، Testcontainers، أنماط Jakarta EE.
تضمن sivalabs-agent-skills أفضل الممارسات في Spring Boot من Siva Katamreddy: ميزات Boot 3.x الحديثة، constructor injection، مساحة اسم Jakarta، Testcontainers لاختبارات التكامل، Flyway، التحقق من البيانات، OpenAPI، والأخطاء الشائعة. بعد الاستنساخ مرة واحدة، يكتب Claude أكوادًا في Boot تبدو فعلاً كما يكتبها مطورو Boot في سنة 2025، وليس 2017.
لماذا تستخدمه
الميزات الأساسية
- يستهدف Spring Boot 3.x و Java 17/21
- حقن البنيات (constructor injection) بالأسلوب الموصى به — بدون @Autowired على مستوى الحقول
- أنماط اختبار التكامل بأولوية Testcontainers
- ترحيلات Flyway والبنية الهرمية للمشروع
- اتفاقيات OpenAPI والتحقق من صحة البيانات ومعالجة الأخطاء
عرض مباشر
كيف يبدو في الممارسة
sivalabs-agent-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: sivalabs-agent-skills
متى تستخدمه: مشروع Boot جديد وليس لديك رغبة في إعادة الاختيار بين كل اتفاقية.
الخطوات
-
وصف الخدمة
أنشئ خدمة REST في Spring Boot 3.2 باسم 'orders-service' مع JPA و PostgreSQL و Flyway و Testcontainers.✓ تم النسخ
→ تخطيط مشروع صحيح + pom/build.gradle + ترحيلات أساسية
-
إضافة ميزة
أضف نقطة نهاية /orders مع POST/GET والتحقق من الصحة.✓ تم النسخ
→ متحكم + خدمة + مستودع + تحقق
-
اختبارات التكامل
أضف اختبارات تكامل باستخدام Testcontainers PostgreSQL.✓ تم النسخ
→ تقوم الاختبارات بتشغيل حاوية والوصول إلى نقاط النهاية وتمرير الاختبار
النتيجة: خدمة Boot قيد التشغيل مع الاختبارات.
المزالق
- Claude يستخدم بشكل افتراضي حقن الحقول (field injection) — تطلب Skill حقن البنيات (constructor injection)؛ إذا لم تحصل عليها، أعد الطلب بشكل صريح
متى تستخدمه: كنت تؤجل ترحيل javax → jakarta.
الخطوات
-
تدقيق
دقق في هذا المشروع — اسرد كل شيء يحتاج إلى التغيير من أجل Boot 3.✓ تم النسخ
→ قائمة كاملة بالتغييرات: الواردات، إصدارات المكونات الإضافية، خصائص الإعدادات
-
تنفيذ التحول
طبق تحول مساحة اسم jakarta وقم بترقية التبعيات.✓ تم النسخ
→ نجاح التجميع بعد التعديلات
-
إصلاح الاختبارات المعطلة
أصلح الاختبارات المعطلة — عادة بسبب صرامة Mockito أو تغييرات الإعداد التلقائي.✓ تم النسخ
→ اختبارات ناجحة
النتيجة: خدمة مهاجرة يمكنك فعلاً دمجها.
المزالق
- تفويت مراجع javax في الإعدادات أو المكتبات الخارجية — استخدم تقرير المهاجر + بحث شامل باستخدام grep
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
العمل عبر مشروع Boot متعدد الوحدات
انتقل عبر مشروع Boot وأضف Testcontainers إلى كل وحدة حفظ بيانات.✓ تم النسخ
فتح PRs بخطوات ترحيل موجزة
افتح PR بعنوان 'chore: migrate orders-service to Boot 3.2'.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا يوجد
- الرموز لكل استدعاء
- 5-25k رمز لكل مهمة
- التكلفة المالية
- مجاني
- نصيحة
- رحل وحدة واحدة في المرة؛ لا تصب monorepo كاملة على Claude
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا شيء على مستوى Skill
نقل البيانات الخارجي: لا يوجد
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
فشل Testcontainers في CI
تأكد من أن CI يحتوي على Docker ويدعم المشغل الحاويات ذات الصلاحيات.
تحقق: docker ps
فشل ترحيل Flyway على قاعدة البيانات الموجودة
اطلب من Claude ترحيلاً أساسياً وحدد المخطط الموجود.
البدائل
sivalabs-agent-skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| symfony-ux-skill | تعمل في PHP/Symfony بدلاً من ذلك | مكدس مختلف |
| jetpack-compose-skill | أنت على Android بدلاً من server Java | بيئة تشغيل مختلفة |