دليل SwiftUI Agent Skills

إذا كنت ستختار واحدة فقط: اختر ameyalambat128/swiftui-skills للحصول على إرشادات من Apple وتقليل هلوسة API، واختر dpearson2699/swift-ios-skills لتغطية هندسية واسعة لنظام iOS وتوجيه دقيق حسب إطار العمل. أفضل توليفة: استخدم الأولى كطبقة مصدر الحقيقة، وثبّت من الثانية فقط 5–10 من Skills المتخصصة التي يحتاج إليها مشروعك.

المشكلة الأكثر شيوعاً في كود SwiftUI الذي ينشئه الذكاء الاصطناعي ليست بنية لغوية غير صالحة، بل كود يبدو صحيحاً فحسب: ملكية الحالة غير واضحة، أو أنماط تنقل قديمة، أو حدود تزامن ملتبسة، أو API غير موجودة. تحول Agent Skills النموذج العام إلى متعاون يعمل وفق قيود هندسية واضحة لمنصات Apple.

ما Agent Skill بالضبط؟

تكون Skill عادة دليلاً يحتوي على ملف SKILL.md. وهي تخبر وكلاء البرمجة مثل Codex وClaude Code وCursor بموعد تفعيل قدرة معينة، والمراجع التي يجب قراءتها أولاً، والقواعد الواجب اتباعها، وطريقة تنسيق النتيجة. ليست إضافة لـ Xcode ولا حزمة Swift، بل يمكن اعتبارها دليلاً هندسياً للفريق مع حزمة معرفة مركزة للذكاء الاصطناعي.

بدلاً من وضع كل قاعدة في مطالبة واحدة ضخمة، لا يلزم تحميل Skills إلا عند الحاجة. تظهر إرشادات الرسوم المتحركة عند العمل على رسوم SwiftUI المتحركة، وتظهر قواعد الشراء والتحقق في StoreKit لمهام التجارة، وتُحمّل إرشادات الأداء عند تصحيح التمرير. يكون هذا السياق الخاص بالمهمة أدق عادة وأكثر كفاءة في استخدام الرموز.

نظرة سريعة على النهجين

النهج الأول: تحويل وثائق Xcode إلى مصدر حقيقة للذكاء الاصطناعي

أهم خيار تصميمي فيها هو القاعدة الواضحة التي تشترط استناد كل معلومة واقعية وكل API إلى ملفات /docs المحلية. يختار الوكيل الوثائق قبل البرمجة ويستشهد بالملفات المستخدمة أثناء المراجعة. وإذا لم يجد نوعاً أو API، فعليه الإقرار بعدم اليقين بدلاً من اختراع اسم يبدو معقولاً.

تتجاوز المواد المستخرجة تخطيط SwiftUI. فهي تشمل App Intents وAlarmKit وStoreKit وWebKit ووراثة SwiftData وSwift Concurrency وLiquid Glass وأدوات visionOS، إضافة إلى عناصر الأداء منخفضة المستوى مثل InlineArray وSpan.

قيود ينبغي وضعها في الحسبان

• تتطلب macOS وXcode 26 أو أحدث. ينبغي ألا تقدم Skill إرشادات SwiftUI قبل ملء دليل الوثائق.
• إنها نقطة دخول واسعة. لا تزال المشاريع المعقدة تحتاج إلى طلب محدد، مثل «راجع ملكية الحالة والتنقل وفق وثائق Apple».
• يحدد إصدار Xcode المحلي إصدار المراجع، لذلك ينبغي للفرق توحيد سلاسل أدواتها لتجنب استنتاجات متعارضة حول التوافر.

النهج الثاني: 84 من iOS Skills القابلة للتركيب

يتميز هذا المستودع بالتوجيه الدقيق. لا تحتاج إلى مجموعة معارف تطوير Apple كاملة في كل سياق: يمكن لتطبيق اشتراكات يستخدم SwiftData وStoreKit 2 وApp Intents وWidgetKit تثبيت Skills هذه إلى جانب أنماط SwiftUI وSwift Concurrency والاختبار وإمكانية الوصول.

فيما يلي الكتالوج الكامل الذي يضم 84 Skill وقت تحديث هذا المقال. وسّع كل مجموعة لمقارنة تغطيتها بالتقنيات المستخدمة في مشروعك.

كيف تختار: ابدأ بالمهمة، لا بالعدد

السيناريو A: بدء استخدام AI مع SwiftUI

ثبّت swiftui-skills أولاً للحصول على قيود وثائق Apple، ثم أضف swiftui-patterns وswiftui-navigation وswift-concurrency وswift-testing وios-accessibility من مجموعة Skills البالغ عددها 84. تغطي هذه الخمس أكثر مواضع الإخفاق شيوعاً في المشاريع الجديدة.

السيناريو B: تطوير ميزة في منتج قائم

اختر وفق التقنية الحالية، لا وفق ما قد يفيد يوماً ما. أضف storekit للاشتراكات، وapp-intents وwidgetkit لواجهات النظام، وswiftdata أو core-data للتطبيقات كثيفة البيانات، وapple-on-device-ai لمنتجات AI التي تعمل على الجهاز.

السيناريو C: مراجعة الكود والعمل على الموثوقية

أعط الأولوية لـ swiftui-performance وdebugging-instruments وmetrickit وswift-security وios-accessibility وapp-store-review. تعمل هذه المجموعة كحارس للإطلاق أكثر من كونها مولداً للكود.

التثبيت: الوكلاء العامون وCodex

تثبيت Skill لوثائق Apple المحلية

# التثبيت مباشرة واستخراج الوثائق من Xcode
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# أو استخدام skills CLI
npx skills add ameyalambat128/swiftui-skills

قبل تمرير برنامج نصي بعيد إلى shell، راجع برنامج التثبيت في المستودع. بعد التثبيت، شغّل setup.sh من دليل Skill المثبتة وأعد تشغيل جلسة الوكيل حتى يكتشف Skill الجديدة.

الاختيار التفاعلي من مجموعة Skills البالغ عددها 84

# فتح أداة الاختيار التفاعلية واختيار Skills والوكلاء المستهدفين
npx skills add dpearson2699/swift-ios-skills

# تثبيت القدرات المحددة فقط
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# الفحص والتحديث
npx skills check
npx skills update

تثبيت Skill واحدة في Codex

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

استبدل الدليل الأخير بأي اسم Skill من الكتالوج. تنتمي القواعد الخاصة بالمشروع إلى نطاق المشروع، بينما تنتمي إرشادات SwiftUI والهندسة القابلة لإعادة الاستخدام إلى النطاق الشخصي المشترك.

مسار عمل مشترك أكثر موثوقية

1. حدّد الهدف وإصدار النشر المستهدف. أخبر الوكيل إن كانت المهمة ميزة أو إعادة هيكلة أو مراجعة، وحدد الحد الأدنى لإصدار iOS حتى لا تُستخدم APIs الجديدة دون شروط.
2. دع طبقة مصدر الحقيقة تختار الوثائق أولاً. اطلب من swiftui-skills سرد وثائق Apple وقيود التوافر المستخدمة في المهمة.
3. حمّل Skills الخاصة بالمهمة فقط. استخدم swiftui-navigation للتنقل وstorekit للمشتريات بدلاً من إضافة الكتالوج كله إلى مهمة واحدة.
4. اطلب تحققاً كاملاً. اطلب من الوكيل بناء الهدف وتشغيل الاختبارات وفحص Dynamic Type وVoiceOver والوضع الداكن عند تغيير UI.
5. سجّل القرارات في قواعد المشروع. ينبغي وضع قرارات البنية المتكررة في Skill خاصة بالمشروع أو في AGENTS.md بدلاً من إعادة التفاوض عليها في كل مهمة.

يمكن أن تبدأ مطالبة قابلة لإعادة الاستخدام كما يلي:

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

الإصدارات والتراخيص: فحصان أخيران

تتغير APIs منصات Apple بسرعة. جرت مراجعة هذا المقال مقابل commit لـ swiftui-skills بتاريخ July 6, 2026 وcommit لـ swift-ios-skills بتاريخ July 4, 2026. قد يتغير محتوى المستودعين والإصدارات المدعومة وعدد Skills. تحقق دائماً من أطر beta بالرجوع إلى Xcode SDK الحالي.

تختلف التراخيص أيضاً: يستخدم swiftui-skills ترخيص MIT، بينما يستخدم swift-ios-skills ترخيص PolyForm Perimeter 1.0.0. يسمح بتطوير التطبيقات ومسارات العمل التجارية مغلقة المصدر، لكنه يقيد إعادة تغليف المحتوى في منتج منافس. اقرأ ملف LICENSE في المصدر قبل التوزيع داخل الفريق أو التعديل أو الدمج التجاري.

الأسئلة الشائعة

هل تحل SwiftUI Agent Skills محل وثائق Apple الرسمية؟

لا. تساعد Skill الوكيل على تحميل القواعد وتطبيقها في الوقت المناسب. مع ذلك، ينبغي التحقق من التوافر النهائي لـ API وسلوك المنصة ومتطلبات المراجعة بالرجوع إلى Xcode SDK الحالي ومواد Apple الرسمية.

هل يمكنني تثبيت مكتبتي Skills معاً؟

نعم. تكمل إحداهما الأخرى: توفر واحدة مصدراً للحقيقة من وثائق Apple المحلية، بينما توفر الأخرى مسارات عمل مركزة لأطر العمل والهندسة. اختر Skills لكل مشروع بدلاً من تثبيت كل شيء افتراضياً.

هل تثبيت كل Skills البالغ عددها 84 أفضل؟

ليس بالضرورة. قد تستفيد الفرق التي تدير مشاريع عديدة لمنصات Apple، لكن المنتج الواحد يكون أوضح عادة مع 5 إلى 10 من Skills كثيرة الاستخدام، ويسهل عليه تتبع مصدر الإرشادات.

هل Skills هذه مخصصة لـ Codex فقط؟

لا. يدعم المستودعان عدة وكلاء، من بينهم Codex وClaude Code وCursor. تعتمد مسارات التثبيت وآليات الاكتشاف على الإصدار الحالي من كل وكيل.