/ الدليل / الملعب / ai-first-toolkit
● مجتمع techwolf-ai ⚡ فوري

ai-first-toolkit

بواسطة techwolf-ai · techwolf-ai/ai-first-toolkit

مجموعة مهارات تقوم بفحص وإعادة هندسة وتشغيل المشاريع وفقاً لمبادئ التصميم التي تركز على الذكاء الاصطناعي.

ai-first-toolkit عبارة عن حزمة مهارات متعددة لـ Claude Code و Codex تنظر إلى مشروعك من خلال عدسة تركز على الذكاء الاصطناعي: هل من السهل على الوكيل التنقل وتحرير والتفكير في قاعدة الأكوار؟ تتضمن مهارات لفحوصات جاهزية الذكاء الاصطناعي وإعادة البناء نحو هيكل واضح وتشغيل المشاريع الجديدة بالسقالة المناسبة من اليوم الأول.

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

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

عرض مباشر

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

ai-first-toolkit-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ai-first-toolkit-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ai-first-toolkit-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/techwolf-ai/ai-first-toolkit",
        "~/.claude/skills/ai-first-toolkit"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "ai-first-toolkit-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/techwolf-ai/ai-first-toolkit",
          "~/.claude/skills/ai-first-toolkit"
        ]
      }
    }
  }
}

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

claude mcp add ai-first-toolkit-skill -- git clone https://github.com/techwolf-ai/ai-first-toolkit ~/.claude/skills/ai-first-toolkit

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

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

استخدامات عملية: ai-first-toolkit

كيفية فحص قاعدة أكوار لجاهزية الوكيل الذكاء الاصطناعي

👤 قادة التكنولوجيا الذين يحضرون قاعدة أكوار للعمل الثقيل بمساعدة الذكاء الاصطناعي ⏱ ~45 min intermediate

متى تستخدمه: قبل أن يلتزم الفريق بإجراء الكثير من عمل الميزات من خلال Claude أو Codex.

المتطلبات الأساسية
  • تم استنساخ المهارة — git clone https://github.com/techwolf-ai/ai-first-toolkit ~/.claude/skills/ai-first-toolkit
الخطوات
  1. تشغيل الفحص
    فحص هذا المستودع لجاهزية الوكيل الذكاء الاصطناعي. قيّم كل بُعد وأدرج أفضل 5 نقاط احتكاك.✓ تم النسخ
    → درجات الأبعاد + الملفات المحددة للإصلاح
  2. تحديد أولويات الإصلاحات
    أي من هذه الإصلاحات سيوفر أكبر رفع فعالية الوكيل لكل ساعة عمل؟✓ تم النسخ
    → قائمة مصنفة برتبة مع الجهد/التأثير
  3. تطبيق أفضل إصلاح
    طبّق الإصلاح #1 من الطرف إلى الطرف — حرّر الملفات وحدّث المستندات وأضف الاختبارات.✓ تم النسخ
    → Diff + التأكيد

النتيجة: خطة تحسين محددة وإصلاح واحد على الأقل مطبق يجعل المستودع أكثر ودية للوكلاء الذكاء الاصطناعي.

المزالق
  • يتحول الفحص إلى كتلة عامة 'تحسين المستندات' — اطلب نتائج على مستوى الملف:السطر وليس نصائح مجردة
اجمعها مع: filesystem · github

تشغيل مشروع جديد صديق للذكاء الاصطناعي

👤 المؤسسون أو المهندسون الفرديون الذين يبدأون مستودعاً جديداً ⏱ ~30 min beginner

متى تستخدمه: اليوم صفر من مشروع جديد، قبل أن تختار خيارات افتراضية سيئة ستطاردك.

الخطوات
  1. حدد المشروع
    شغّل مشروع API TypeScript جديد باستخدام خيارات ai-first-toolkit الافتراضية. الغرض: API الفواتير الداخلية.✓ تم النسخ
    → هيكل المجلد المقترح وملف tsconfig والبرامج النصية وهيكل README
  2. قالب الملفات
    أنشئ الملفات. أدرج AGENTS.md و CLAUDE.md مع ملاحظات قاعدة الأكوار الملائمة.✓ تم النسخ
    → تحقق ملفات المستودع
  3. أول التزام
    هيّئ git وقم بأول التزام برسالة نظيفة.✓ تم النسخ
    → مستودع أولي نظيف

النتيجة: مستودع جديد صديق للبشر والوكلاء الذكاء الاصطناعي من الالتزام 0.

المزالق
  • الهياكل توريد تبعيات لا تريدها — اطلب من Claude عرض قائمة التبعيات قبل التثبيت — اقبل كل واحدة
اجمعها مع: github · filesystem

إعادة هندسة وحدة فوضوية لقابلية القراءة من الذكاء الاصطناعي

👤 المهندسون الذين يسددون الديون التقنية وحدة واحدة في المرة ⏱ ~60 min advanced

متى تستخدمه: لقد عزلت وحدة تحصل Claude على نتائج خاطئة باستمرار — عادة ما تكون علامة على أن هيكلها ليس قابلاً للقراءة من الوكيل.

الخطوات
  1. تشخيص الوحدة
    انظر إلى src/billing/. ما الذي يجعل هذا الأكود صعباً على الوكيل تحريره بأمان؟✓ تم النسخ
    → أعلام حمراء محددة: المراوغة والحالة المخفية والدوال الطويلة
  2. خطط لإعادة البناء
    اقترح إعادة بناء بـ 3 خطوات تحسن قابلية القراءة من الوكيل دون تغيير واجهة البرمجة العامة.✓ تم النسخ
    → خطة خطوة بخطوة مع رسومات الفروق
  3. تنفيذ الخطوة 1
    طبّق الخطوة 1. حافظ على الاختبارات خضراء.✓ تم النسخ
    → diff بحجم PR

النتيجة: وحدة يمكن لـ Claude أن يفكر فيها بالفعل في التكرار التالي.

المزالق
  • إعادة بناء مفرطة وكسر السلوكيات التي لم تقصدها — أصر على استقرار واجهة البرمجة العامة وقم بتشغيل الاختبارات بعد كل خطوة
اجمعها مع: filesystem · github

التركيبات

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

ai-first-toolkit-skill + filesystem

الفحص يمسح المستودع؛ يلزم نظام الملفات لقراءته فعلياً

سِرْ في المستودع وقيّم جاهزية الذكاء الاصطناعي؛ أبلغ عن النتائج ملف تلو الآخر.✓ تم النسخ
ai-first-toolkit-skill + github

افتح طلب دمج بالإضافات المقترحة AGENTS.md / CLAUDE.md

طبّق أفضل 3 إصلاحات من الفحص وافتح طلب دمج بعنوان 'تحسينات التركيز على الذكاء الاصطناعي'.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
ai-readiness-audit repo root استثمار مسبق في سير العمل الثقيل للذكاء الاصطناعي 0
ai-first-bootstrap project spec (lang, purpose, stack) مشاريع جديدة 0
re-engineer-module module path + goals عندما تقاوم الوحدة تحرير الوكيل 0

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

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

حصة API
لا شيء فوق مزود نموذج اللغة الخاص بك
الرموز لكل استدعاء
5–20k رمز لفحص مستودع متوسط الحجم
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
نطاق الفحوصات إلى شجرة فرعية بدلاً من monorepo بأكملها

الأمان

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

تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء فوق ما تفعله أدوات filesystem/github

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

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

الفحص مجرد جداً

أعد الطلب ببُعد محدد: 'قيّم فقط تخطيط الاختبار' أو 'فقط حدود الوحدة'.

التشغيل يختار لغة خاطئة

اذكر دائماً اللغة + وقت التشغيل + أداة البناء في الطلب الأول.

البدائل

ai-first-toolkit مقابل البدائل

البديلمتى تستخدمهاالمقايضة
init (مدمج)أنت تحتاج فقط إلى CLAUDE.md ولا تهتم بالباقينطاق أضيق
antivibe-skillتريد العدسة المعاكسة — انتقاد من الوكيل الذكاء الاصطناعيتشخيصي وليس وصفياً

المزيد

الموارد

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

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

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