● مجتمع
kylehughes
⚡ فوري
Swift Concurrency Migration Skill
بواسطة kylehughes · kylehughes/the-unofficial-swift-concurrency-migration-skill
شحن التزامن مع Swift 6 بكل ثقة - تم تحميل دليل الترحيل الرسمي من Apple إلى Claude كمهارة، لذلك يستشهد الوكلاء بالوثائق الفعلية.
تعمل هذه المهارة على تجميع دليل ترحيل Swift Concurrency من Apple (المقالات + نماذج التعليمات البرمجية) في حزمة SKILL.md/resources حتى يتمكن Claude Code وClaude Desktop والعملاء المتوافقون من الاستشهاد بالدليل بدقة عند تحويل كود رد الاتصال/DispatchQueue القديم إلى غير متزامن/انتظار وممثلين وتزامن صارم. مفيد لـ Swift 6 / عمليات الترحيل المتزامنة الصارمة حيث يكون الحصول على حدود العزل الصحيحة هو اللعبة بأكملها.
لماذا تستخدمه
الميزات الأساسية
- أكمل نص دليل Swift Concurrency Migration Guide وأمثلة التعليمات البرمجية
- يقتبس كلود الدليل بدلاً من الهلوسة الاصطلاحية غير المتزامنة/المنتظرة
- يمكن تثبيته عبر Claude Code /plugin أو ZIP لـ Claude.ai
- التزويد التلقائي للفريق عبر .claude/settings.json
- مفيد لاعتماد التزامن الصارم لـ Swift 6 وعمليات التدقيق القابلة للإرسال
عرض مباشر
كيف يبدو في الممارسة
swift-concurrency-migration-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: Swift Concurrency Migration Skill
متى تستخدمه: أنت تمتلك وحدة تمزج بين DispatchQueue ومعالجات الإكمال وعمليات الإغلاق @escaping؛ تريد غير متزامن/تنتظر.
المتطلبات الأساسية
- Xcode مع Swift 5.9+ (وضع Swift 6 إذا كنت تريد التزامن الصارم) — قم بتثبيت Xcode من متجر التطبيقات
- تم تثبيت المهارة — / سوق المكونات الإضافية أضف kylehughes/the-unofficial-swift-concurrency-migration-skill
الخطوات
-
اسأل عن خطة الهجرة
قم بشرح كيفية ترحيل NetworkService.swift إلى async/await، مع الاستشهاد بدليل ترحيل Swift Concurrency.✓ تم النسخ
→ خطط لمراجع المقالات المسماة في الدليل
-
تطبيق خطوة بخطوة
ابدأ بسطح واجهة برمجة التطبيقات العام - قم بتحويل أساليب معالج الإكمال إلى غير متزامن/انتظار.✓ تم النسخ
→ تستخدم التعليمات البرمجية واجهات برمجة التطبيقات غير المتزامنة الاصطلاحية، وليس عمليات الاسترجاعات المجمعة
-
التعامل مع الإلغاء والعزل
أضف إلغاء المهام وحدد عزل الممثل لذاكرة التخزين المؤقت.✓ تم النسخ
→ المهمة المناسبة. التحقق من الإلغاء + عزل الممثل الصريح
النتيجة: تم ترحيل الوحدة بشكل نظيف مع المنطق المرتبط بتوجيهات Apple الخاصة.
المزالق
- التفاف عمليات الاسترجاعات مع CheckedContinuation دون تحديد الملكية — قم بترحيل واجهة برمجة التطبيقات الجذرية أولاً؛ لا تترك الاستمرارات كجسور دائمة
متى تستخدمه: لقد قلبت وضع اللغة والآن المترجم يصرخ.
الخطوات
-
تجميع التحذيرات
قم بتجميع التحذيرات القابلة للإرسال في سجل البناء هذا حسب الفئة (نوع القيمة، الفئة، التقاط الإغلاق).✓ تم النسخ
→ مسح المجموعات بالإصلاحات النموذجية من الدليل
-
تطبيق الإصلاحات الأساسية
لكل مجموعة، قم بتطبيق الإصلاح من دليل ترحيل Swift Concurrency؛ شرح المقايضات.✓ تم النسخ
→ تم الاستشهاد بالإصلاحات @unchecked Sendable فقط عندما يكون ذلك مبررًا
النتيجة: تصميم Swift 6 يجمع الأسباب الموثقة لكل اختيار.
المزالق
- استخدام @unchecked Sendable ككاتم للصوت — يحذر الدليل صراحةً من هذا - احتفظ بواجهات برمجة التطبيقات القديمة المعبأة مع سلامة سلاسل العمليات الموثقة
متى تستخدمه: أنت تقوم بنمذجة الحالة المشتركة ولست متأكدًا من نكهة الممثل التي تناسبك.
الخطوات
-
وصف الدولة
وصف الحالة: <ذاكرة التخزين المؤقت لملفات تعريف المستخدمين؛ قراءة ثقيلة، والكتابة كل 5 دقائق>.✓ تم النسخ
→ تشير المهارة إلى أقسام الممثل / GlobalActor في الدليل
-
احصل على التوصية
يوصي الممثل مقابل GlobalActor مع الاستشهادات.✓ تم النسخ
→ توصية ترتكز على أقسام الدليل، وليس أفضل الممارسات العامة
النتيجة: نموذج العزل الذي يمكنك الدفاع عنه قيد المراجعة.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
التكرار: الترحيل → البناء → إصلاح التحذيرات → التكرار
بعد كل تعديل، قم بتشغيل xcodebuild وقم بتغذية تحذيرات Swift 6 مرة أخرى إلى المهارة.✓ تم النسخ
أسئلة لغة Swift العامة جنبًا إلى جنب مع الإرشادات الخاصة بالتزامن
شرح حزم المعلمات العامة؛ ثم قم بالتطبيق في ترحيل التزامن.✓ تم النسخ
قم بتكوين coroutines على النقيض من Android مع التزامن Swift عند القيام بالعمل عبر الأنظمة الأساسية
يستخدم فريق iOS لدينا المزامنة/الانتظار؛ يستخدم فريق Android coroutines. قم بمحاذاة أنماط التزامن لطبقة API المشتركة.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا أحد
- الرموز لكل استدعاء
- يعتمد على مقدار تحميل الدليل؛ أسئلة النطاق على نطاق ضيق
- التكلفة المالية
- حر
- نصيحة
- اطرح أسئلة دقيقة (قم بتسمية الملف، وقم بتسمية التحذير) حتى تقوم المهارة بتحميل الأقسام ذات الصلة فقط.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا أوراق اعتماد
نقل البيانات الخارجي: لا شيء - يتم تجميع المحتوى محليًا
- هذه عبوة غير رسمية لدليل Apple. لا يزال هذا نص الدليل، ولكن تحقق من مستندات Apple المباشرة إذا كان إصدار Swift الأخير قد أدخل تغييرات.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
تبدو الإجابات عامة، ولا تستشهد بالأقسام
اطلب صراحةً: "استشهد بقسم دليل ترحيل Swift Concurrency". المهارة لها النص – اجعلها تستخدمه.
فشل التثبيت عبر /plugin
قم بتحديث Claude Code إلى إصدار يدعم سوق /plugin. وبدلاً من ذلك، قم بتنزيل الإصدار ZIP.
تحقق: claude --version
البدائل
Swift Concurrency Migration Skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| the-unofficial-swift-programming-language-skill | أنت تريد كتاب لغة Swift، وليس دليل التزامن | أوسع وأقل تركيزًا على الهجرة |
| xcodebuild | تريد أتمتة عمليات البناء/الاختبارات، وليس ترحيل التعليمات البرمجية | الأدوات المتعامدة |