/ الدليل / الملعب / Axiom (xOS Dev Skills)
← كل الخوادم ↗ GitHub
● مجتمع CharlesWiltgen ⚡ فوري

Axiom (xOS Dev Skills)

بواسطة CharlesWiltgen · CharlesWiltgen/Axiom

تطوير منصات Apple دون محاربة Swift 6 — مهارات رأيية لـ SwiftUI والتزامن المُهيكَل و@Observable وأدوات البناء الحديثة.

Axiom هي حزمة مهارات Claude Code لشحن تطبيقات إنتاج على iOS / iPadOS / watchOS / tvOS. تُطبِّق الاصطلاحات الحديثة: SwiftUI أولاً، @Observable (iOS 17+) بدلاً من ObservableObject، async/await بدلاً من completion handlers، الأنواع ذات القيمة وقواعد تزامن Swift 6. تشمل فحوصات إمكانية الوصول وجاهزية App Store ونظافة مشروع Xcode.

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

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "axiom-xos-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "axiom-xos-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/CharlesWiltgen/Axiom",
        "~/.claude/skills/axiom"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "axiom-xos-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/CharlesWiltgen/Axiom",
          "~/.claude/skills/axiom"
        ]
      }
    }
  }
}

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

claude mcp add axiom-xos-skill -- git clone https://github.com/CharlesWiltgen/Axiom ~/.claude/skills/axiom

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

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

استخدامات عملية: Axiom (xOS Dev Skills)

ترحيل ViewModel إلى @Observable

👤 مطورو iOS الذين يتبنَّون iOS 17+ ⏱ ~45 min advanced

متى تستخدمه: التطبيق iOS 17+ لكن ViewModels لا تزال ObservableObject + @Published.

المتطلبات الأساسية
  • المهارة مُثبَّتة — git clone https://github.com/CharlesWiltgen/Axiom ~/.claude/skills/axiom
  • هدف نشر iOS 17 كحد أدنى — إعدادات المشروع
الخطوات
  1. الجرد
    Axiom: list every ObservableObject + @Published in the project. Note which are leaf vs shared.✓ تم النسخ
    → قائمة مع الشكل + تلميحات التبعية
  2. ترحيل واحد
    Refactor ProfileViewModel to @Observable. Keep the public API stable. Update its View consumers' bindings.✓ تم النسخ
    → VM مُرحَّل؛ @Bindable مستخدَم في Views؛ لا @Published متبقية
  3. التحقق
    Run xcodebuild for the scheme. Report any warnings.✓ تم النسخ
    → بناء نظيف؛ لا تحذيرات Swift 6

النتيجة: قاعدة كود حديثة بـ @Observable مع views أنظف.

المزالق
  • الاختبارات الموجودة تعتمد على تسقيط @Published ($name) — الاختبارات تحتاج إعادة كتابة؛ لا تتعيَّن جميع أنماط الوصول بشكل مباشر
اجمعها مع: filesystem · ios-simulator-mcp

إصلاح تحذيرات تزامن Swift 6

👤 مطورو iOS الذين يُعدُّون لتزامن Swift 6 الصارم ⏱ ~60 min advanced

متى تستخدمه: البناء مليء بتحذيرات Sendable / actor.

الخطوات
  1. التصنيف
    Axiom concurrency-clean: classify warnings into: (1) actor isolation, (2) Sendable conformance, (3) data race risk.✓ تم النسخ
    → قائمة مُصنَّفة
  2. إصلاح عزل actor
    Tackle category 1 first. Propose minimal fixes; prefer @MainActor on UI types over global isolation.✓ تم النسخ
    → تغييرات جراحية؛ لا رشَّ @MainActor عشوائي

النتيجة: بناء Swift 6 نظيف مع حدود تزامن متعمَّدة.

المزالق
  • الإفراط في @MainActor كاختصار لـ 'كتم التحذيرات' — المهارة تُعلِّم هذا؛ استخدم تصميم actor صحيح بدلاً من ذلك

تشغيل مراجعة إمكانية الوصول

👤 فرق iOS قبل الإصدار ⏱ ~60 min intermediate

متى تستخدمه: تقديم App Store قريب؛ تريد تغطية VoiceOver/Dynamic Type.

الخطوات
  1. مسح Views
    Axiom a11y: scan SwiftUI views. Flag missing accessibilityLabel, hardcoded font sizes, low-contrast color usage.✓ تم النسخ
    → قائمة مشكلات لكل view
  2. تصحيح المشكلات الرئيسية
    Apply fixes for top 10 issues. Use system fonts for Dynamic Type.✓ تم النسخ
    → تصحيحات مُطبَّقة؛ البناء لا يزال نظيفاً

النتيجة: التطبيق يجتاز جولة VoiceOver أساسية.

المزالق
  • التسميات المُولَّدة تلقائياً لا تطابق النموذج الذهني للمستخدم — أضِف تسميات مقصودة وذات معنى
اجمعها مع: ios-simulator-mcp

التركيبات

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

axiom-xos-skill + ios-simulator-mcp

تطبيق توصيات المهارة + اختبار دخان على المحاكي

Axiom: migrate ProfileVM. Then iOS-Simulator: launch, screenshot the profile screen.✓ تم النسخ
axiom-xos-skill + filesystem

تطبيق تصحيحات عبر المشروع

Axiom concurrency-clean: produce patches for src/. Filesystem: apply them.✓ تم النسخ
axiom-xos-skill + xcodebuildmcp

التحقق من البناء بعد إعادة الهيكلة

After migration, XcodeBuild: build for sim. Report warnings.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
vm_migrate_observable viewmodel_path ترحيل لكل VM 0
concurrency_clean scope تحضير Swift 6 0
a11y_scan scope قبل الإصدار 0
appstore_checklist (none) قبل التقديم 0
xcode_hygiene project تنظيف دوري 0

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

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

حصة API
لا ينطبق
الرموز لكل استدعاء
عمليات المسح 10k–40k token
التكلفة المالية
مجاني
نصيحة
قيِّد المراجعات على ميزة/مجلد واحد؛ لا تُوزِّع على تطبيق ضخم

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-read filesystem-write
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء

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

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

الترحيل كسر استخدام @Bindable

بعض views تحتاج غلافات @Bindable؛ المهارة يجب أن تضيفها — تحقق أنها لم تفتها

إصلاحات التزامن تُغيِّر الدلالات بصمت

شغِّل الاختبارات دائماً بعد الترحيل؛ تغييرات التزامن دقيقة

اقتراحات إمكانية الوصول تبدو نمطية

المهارة تتبع Apple HIG؛ أضِق بتسميات التطبيق الخاصة بك

البدائل

Axiom (xOS Dev Skills) مقابل البدائل

البديلمتى تستخدمهاالمقايضة
AvdLee Swift Concurrency Skillتحتاج التزامن فقط لا الحزمة الكاملةأضيق
Apple's own Swift Migratorتريد ترحيلاً مُعتمَداً من Appleأقل تفاعلية؛ أقل وعياً بالمشروع
twostraws SwiftUI Agent Skillتركيز SwiftUI فقطآراء مختلفة

المزيد

الموارد

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

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

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