Swift Concurrency Skill: حلّل تزامن المشروع أولًا ثم تحدّث عن ترحيل Swift 6

لمن يناسب

إذا كنت تصون مشروع Swift وتريد أن يتحدث مساعد الترميز عن تزامن آمن وأداء وترحيل Swift 6+ من مهارة خبير واحدة، لا أن يخلط واجهات خيوط قديمة من الذاكرة، فهذه المهارة أنسب. تستهدف أي أداة ترميز ذكاء اصطناعي تدعم صيغة Agent Skills المفتوحة. شرح الصيغة في

https://agentskills.io/home

تحتاج مشروع Swift قابلًا للتحليل أصلًا، وأن تقبل إضافة مهارة swift-concurrency بأمر npx واحد. من يريد قراءة ملاحظات WWDC فقط ولا ينوي أن يقرأ المساعد المستودع، فائدته محدودة. الصفحة تضرب أمثلة على منتجات ذات كشف عملاء وتكتب أيضًا «أي أداة تدعم هذه الصيغة»، فلا تفهم الأمثلة قائمة مغلقة.

أول محاولة في 3 دقائق

التثبيت الرسمي هو هذا السطر:

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

يكتب المهارة في بيئة الوكيل الحالية. أكّد أن لديك npx محليًا وأن هذه بيئة مشروع Swift الذي تريد تحليله، ثم نفّذ. لا تضع مثبّتًا آخر إلى جانبه.

بعد التثبيت استخدم المثال الرسمي تحليلًا للقراءة فقط، ولا ترحّل بعد:

Use the swift concurrency skill and analyze the current project for Swift Concurrency improvements

علامة النجاح تتبع How to verify في الصفحة: ينبغي أن يستشهد المساعد بـ triage/playbook في skills/swift-concurrency/SKILL.md ويدخل ملف المرجع الذي يوافق خطأك أو مهمتك. إن أعطى نصائح async عامة فقط دون ذكر هذا playbook، قف واجعله يفتح ملف المهارة. في مرحلة التحليل لا تسمح بتغيير actor أو العزل أو الرفع إلى Swift 6.

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

الحالة الأولى: فحص نقاط تحسين التزامن في المشروع الحالي. استخدم الموجّه الرسمي في القسم السابق. المهمة تحليل لا تعديل شيفرة. النص المتاح لا يكتب أي أدلة سيمسح ولا صيغة التقرير. ما يمكنك تأكيده: أنه يصرّح باستخدام مهارة swift concurrency ويصل إلى دليل الفرز في SKILL.md. إن صار الاقتراح «سأعدّل هذه الملفات لك» فاطلب أولًا مجموعة الملفات ثم قرر.

الحالة الثانية: مراجعة صفحة مرجع أمام خطأ أو مهمة ترحيل محددة. خطوة التحقق تقول: تجاه error or task الخاص بك ادخل reference file الموافق. حين يكون لديك تشخيص تزامن من المترجم أصلًا، أو تريد بوضوح ترحيل Swift 6+، اجعل المساعد يفتح playbook أولًا ثم المرجع الموافق، لا أن يغيّر نمط اللغة مباشرة. تحسين الأداء مذكور كقدرة دون أمر مسبار. فمهمة الأداء تبدأ أيضًا بمقابلة ملف المرجع؛ إن غاب الأمر فلا تخترع سكربت قياس.

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

هذه مهارة توجيه خبير لا مرحّل تلقائي. التزامن الآمن والأداء وترحيل Swift 6+ داخل النطاق، لكن التوقف الأول يجب أن يكون التحليل والاستشهاد. المستودع مكتوب أيضًا كـ Agent Plugin قابل للنقل (spec 1.0.0)؛ العملاء المتوافقون يكتشفون المهارة من plugin.json في الجذر وskills/. ذلك شرح تغليف لا أمر تثبيت ثانٍ. التثبيت ما زال يستخدم فقط npx skills add أعلاه.

مواصفة الإضافة في

https://agent-plugins.org/

لا تتخذ ذلك سببًا لتثبيت متجر غير مكتوب. كشف ملفات المرجع الكامل لا يظهر في النص المتاح؛ لا يمكنك تسمية reference معيّنة من هذه المادة.

التوقف الأول هو التحليل. أي تعديل لشيفرة تزامن Swift أو تغيير نمط اللغة أو إضافة @MainActor بالجملة يجب أن يذكر المساعد أولًا الملفات التي سيغيّرها وصفحة المرجع، وتؤكّد أنت ثم يكمل.