/ الدليل / الملعب / claude-code_rails-upgrade-skill
← كل الخوادم ↗ GitHub
● مجتمع ombulabs ⚡ فوري

claude-code_rails-upgrade-skill

بواسطة ombulabs · ombulabs/claude-code_rails-upgrade-skill

مهارة Claude Code تقوم بترقية Rails بشكل منهجي — من التدقيق إلى إصلاح التحذيرات المتقادمة وتحديث حزم البرامج — دون تعطيل أي شيء.

مهارة ترقية Rails (بواسطة OmbuLabs) توجه Claude عبر خطة الترقية القياسية لـ Rails: تدقيق الكود، إصلاح التحذيرات المتقادمة، تطبيق القيم الافتراضية للإطار، التعامل مع عدم توافق حزم البرامج، والتحقق من الإصدار الجديد. بناءً على خبرة OmbuLabs في الإنتاج عند ترقية تطبيقات Rails. مناسبة للانتقال من N إلى N+1، أو اللحاق بالإصدارات الأقدم.

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

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

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

عرض مباشر

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

claude-code-rails-upgrade-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-code-rails-upgrade-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-code-rails-upgrade-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
          "~/.claude/skills/claude-code_rails-upgrade-skill"
        ]
      }
    }
  }
}

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

claude mcp add claude-code-rails-upgrade-skill -- git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/claude-code_rails-upgrade-skill

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

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

استخدامات عملية: claude-code_rails-upgrade-skill

كيفية التخطيط لترقية Rails قبل لمس الكود

👤 مطورو Rails الذين يواجهون قفزة متعددة الإصدارات ⏱ ~60 min intermediate

متى تستخدمه: أنت على Rails 6.1 وتحتاج إلى الوصول إلى 7.2. تريد خطة، وليس دعاءً.

المتطلبات الأساسية
  • تم تثبيت المهارة — git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/rails-upgrade-skill
  • شجرة عمل نظيفة في Git — قم دائماً بالترقية في فرع منفصل؛ احفظ الحالة الحالية
الخطوات
  1. تدقيق الحالة الحالية
    دقق هذا تطبيق Rails: الإصدار الحالي، إصدار Ruby، حزم البرامج، تحذيرات التقادم من تشغيل اختبار.✓ تم النسخ
    → تقرير خط الأساس
  2. بناء المسار
    خطط للترقية إلى Rails 7.2. انتقل من إصدار إلى آخر (6.1 → 7.0 → 7.1 → 7.2)، كل منها بمعايير محطات رئيسية.✓ تم النسخ
    → خطة متعددة المراحل
  3. تحديد العوائق
    أي حزم برامج لا تتمتع بإصدار متوافق مع 7.2؟ مقترحات لكل منها (ترقية/استبدال/نسخة محلية).✓ تم النسخ
    → قائمة العوائق لكل حزمة برامج

النتيجة: خطة ترقية واقعية مع محطات رئيسية موزعة على مراحل.

المزالق
  • القفز إلى نسختين رئيسيتين في نفس الوقت — تطبق المهارة نسخة واحدة صغيرة/رئيسية في كل مرة — لا تتجاوزها

مراجعة وإصلاح تحذيرات التقادم

👤 مطورو Rails في منتصف الترقية ⏱ ~90 min intermediate

متى تستخدمه: أنت بين الإصدارات واختبار التشغيل مليء بتحذيرات التقادم.

الخطوات
  1. جمع
    قم بتشغيل الاختبارات، واجمع جميع تحذيرات التقادم الفريدة.✓ تم النسخ
    → قائمة خالية من التكرارات مع حالات file:line
  2. التجميع + الإصلاح
    جمّع حسب السبب. اقترح إصلاحات قليلة مع الاختلافات لكل مجموعة.✓ تم النسخ
    → الاختلافات في الإصلاح المجمع

النتيجة: تشغيل اختبار نظيف جاهز لارتفاع الإصدار التالي.

تطبيق القيم الافتراضية الجديدة للإطار بأمان

👤 مطورو Rails الذين يتنقلون عبر rails app:update ⏱ ~60 min advanced

متى تستخدمه: لقد قمت بترقية Gemfile وقمت بتشغيل rails app:update؛ الآن لديك مجموعة من المهيئات الجديدة.

الخطوات
  1. مراجعة الفرق
    راجع الفرق من rails app:update. ضع علماً على أي تغيير افتراضي قد يعطل تطبيقنا (strict_loading, zeitwerk mode, إلخ).✓ تم النسخ
    → شرح المخاطر لكل تغيير
  2. التفعيل على مراحل
    لكل قيمة افتراضية محفوفة بالمخاطر، أنتج نشراً على مراحل: فعّل خلف علامة env، تحقق من staging، ثم قلب.✓ تم النسخ
    → خطة موزعة على مراحل لكل قيمة افتراضية

النتيجة: القيم الافتراضية مفعلة دون انحدارات غير متوقعة.

المزالق
  • تفعيل جميع load_defaults في نفس الوقت — استخدم new_framework_defaults_X.Y.rb للترقية تدريجياً

التركيبات

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

claude-code-rails-upgrade-skill + claude-code-owasp-skill

مراجعة أمان الكود المرقى

بعد ترقية Rails 7.2، قم بتشغيل مراجعة OWASP على معالجة المصادقة والمعاملات.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
Audit repo في بداية كل ترقية Claude tokens
Plan upgrade path current, target بعد التدقيق Claude tokens
Gem compat check Gemfile, target Rails قبل الترقية Claude tokens + RubyGems API
Deprecation sweep test log بين الإصدارات Claude tokens
Framework defaults migration diff from rails app:update بعد rails app:update Claude tokens

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

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

حصة API
بلا حد
الرموز لكل استدعاء
20-80k عبر الترقية
التكلفة المالية
مجاني
نصيحة
قم بتشغيل مراجعات التقادم على مجلدات محددة بدلاً من التطبيق بأكمله في نفس الوقت.

الأمان

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

تخزين بيانات الاعتماد: بلا بيانات اعتماد
نقل البيانات الخارجي: يتم إرسال الكود إلى Claude للاستدلال

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

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

rails app:update ينتج ملفات ثنائية غير محفوظة

هذه عادة ما تكون ملفات النظام. تجاهلها في Git وأعد إنشاؤها بنظافة.

الاختبارات تمر محلياً، تفشل في CI بعد الترقية

ربما اختلافات في التحميل التلقائي أو eager_load في وضع الإنتاج. قم بالتشغيل مع RAILS_ENV=production محلياً.

فشل حل مجموعة Gem

ستقترح المهارة إصدارات بديلة من Gem؛ في بعض الأحيان قد تكون نسخة محلية أو استبدال مطلوباً.

تحقق: bundle update --conservative

البدائل

claude-code_rails-upgrade-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
next_rails gemتريد مساعد ترقية حتمياًبلا إصلاحات تقادم موجهة بواسطة LLM

المزيد

الموارد

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

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

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