● مجتمع
arpitg1304
⚡ فوري
robotics-agent-skills
بواسطة arpitg1304 · arpitg1304/robotics-agent-skills
أدوات تجعل مساعدات الترميز المدعومة بالذكاء الاصطناعي تكتب كوداً احترافياً جاهزاً للإنتاج لـ ROS1/ROS2 — مبادئ SOLID وأنماط التصميم والاختبارات الفعلية.
تعلّم Robotics Agent Skills مساعدات Claude Code و Cursor أساليب البرمجة في روبوتيات الإنتاج: عُقد ROS1/ROS2، المواضيع، الخدمات، الإجراءات، ملفات التشغيل، أنماط الاختبار، ومبادئ SOLID المطبقة على الروبوتيات. اشحن كوداً لن يضع المراجعون عليه علامات حمراء لأنه يتمتع بإدارة دورة حياة صحيحة وتسجيل ملاحظات واختبارات.
لماذا تستخدمه
الميزات الأساسية
- تغطية كاملة لـ ROS1 و ROS2، بما في ذلك ملفات التشغيل و package.xml
- مبادئ SOLID المطبقة على كود الروبوتيات
- أنماط التصميم الشائعة (State, Observer, Strategy) في سياق ROS
- هياكل الاختبار: pytest و rostest و gtest
- أنماط دورة حياة العقدة (managed/unmanaged)
- عابرة للوكلاء: تعمل مع أي مساعد متوافق مع SKILL.md
عرض مباشر
كيف يبدو في الممارسة
robotics-agent-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: robotics-agent-skills
متى تستخدمه: عندما تكون على وشك كتابة عقدة جديدة وتريد دورة حياة نظيفة واختبارات منذ البداية.
الخطوات
-
وصف العقدة
أنشئ عقدة ROS2 Humble تشترك في /scan (LaserScan)، وتصفي العوائق، وتنشر /cmd_vel باستخدام آلة الحالات.✓ تم النسخ
→ عقدة مع فصل واضح للفئات وهياكل دورة الحياة وإعلانات المعاملات
-
اطلب الاختبارات
اكتب اختبارات pytest للوحدة لمنطق التصفية واختبار launch_test للتكامل.✓ تم النسخ
→ اختبارات قابلة للتشغيل عبر colcon test
-
التغليف
أنتج package.xml و CMakeLists.txt مع المتطلبات الصحيحة.✓ تم النسخ
→ نجاح colcon build
النتيجة: حزمة ROS2 تجتاز colcon build + test مع تغطية ذات معنى.
المزالق
- يخلط Claude بين واجهات برمجية ROS1 و ROS2 — حدد الإصدار بوضوح في الطلب في كل مرة — 'ROS2 Humble'
- العقدة تفتقر إلى معالجة الإيقاف — اطلب on_shutdown hooks ومعالجة SIGTERM بشكل محدد
متى تستخدمه: عندما تحتاج إلى نقل حزمة ROS1 عاملة وتريد أكثر من استبدال آلي.
الخطوات
-
تدقيق حزمة ROS1
اقرأ هذه الحزمة وأدرج كل واجهة برمجية نحتاج إلى إعادة تعيينها لـ ROS2 (params, timers, services, actions).✓ تم النسخ
→ جدول إعادة التعيين لكل ملف
-
إنشاء المعادلات ROS2
أنتج إصدارات ROS2 لكل ملف، محافظاً على السلوك. ضع علامة على أي شيء بدون تعيين 1:1.✓ تم النسخ
→ ملفات جديدة + عناصر معلمة لمراجعة بشرية
النتيجة: فرع ROS2 من الحزمة يتجميع وينجح في اختبارات الدخان.
المزالق
- callback_groups و executors مفقودة — اطلب من Claude إضافة MultiThreadedExecutor وتعيين callback groups بناءً على نموذج threading القديم
متى تستخدمه: عندما تعمل العقدة في الميدان وتريد شبكة أمان قبل إعادة الهيكلة.
الخطوات
-
تحديد نقاط الفصل
ابحث في هذه العقدة وجد النقاط الفاصلة حيث يمكننا حقن محاكاة دون تغيير السلوك الإنتاجي.✓ تم النسخ
→ خطوط/وظائف معينة للفصل
-
إنشاء اختبارات في نقاط الفصل
اكتب اختبارات pytest باستخدام تلك النقاط الفاصلة. لا تغير العقدة.✓ تم النسخ
→ اختبارات تعمل بشكل معزول وتنجح
النتيجة: مجموعة اختبارات التوصيف التي تكتشف الانحدار.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
مراجعة الأمان لشبكات ROS (rosbridge, Zenoh) باستخدام توجيهات OWASP
أنتجت مهارة الروبوتيات تكاملاً rosbridge — قم بتشغيل مهارة OWASP على طبقة WebSocket.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا توجد حصة API
- الرموز لكل استدعاء
- يختلف
- التكلفة المالية
- مجاني
- نصيحة
- حافظ على الطلبات مركزة على عقدة واحدة في المرة؛ إنشاء الحزم الكاملة يزيد الرموز بسرعة.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا توجد بيانات اعتماد
نقل البيانات الخارجي: لا توجد استدعاءات خارجة من المهارة نفسها
- كود الروبوتيات يمكن أن يحرك الأجهزة الفيزيائية. قم دائماً بتشغيل العقد المولدة بواسطة Claude في المحاكاة أولاً.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
حزمة المولدة تفشل في colcon build مع أخطاء التضمين
غالباً ما ينسى Claude إضافة ament_target_dependencies. اطلب إعادة إنشاء CMakeLists.txt بوضوح.
تحقق: colcon build --packages-select <pkg>
الاختبارات تنجح بشكل معزول، تفشل عند تشغيلها معاً
سياق ROS مشترك. اطلب rclpy.init() و shutdown() لكل اختبار.
تحقق: colcon test
البدائل
robotics-agent-skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| ROS2 official docs | عندما تريد أنماطاً أساسية وليس مشتقة من نموذج لغة | بدون توليد أكواد، أبطأ |