● مجتمع
techwolf-ai
⚡ فوري
ai-first-toolkit
بواسطة techwolf-ai · techwolf-ai/ai-first-toolkit
مجموعة مهارات تقوم بفحص وإعادة هندسة وتشغيل المشاريع وفقاً لمبادئ التصميم التي تركز على الذكاء الاصطناعي.
ai-first-toolkit عبارة عن حزمة مهارات متعددة لـ Claude Code و Codex تنظر إلى مشروعك من خلال عدسة تركز على الذكاء الاصطناعي: هل من السهل على الوكيل التنقل وتحرير والتفكير في قاعدة الأكوار؟ تتضمن مهارات لفحوصات جاهزية الذكاء الاصطناعي وإعادة البناء نحو هيكل واضح وتشغيل المشاريع الجديدة بالسقالة المناسبة من اليوم الأول.
لماذا تستخدمه
الميزات الأساسية
- فحص جاهزية الذكاء الاصطناعي — يقيّم المستودع على أساس الهيكل والمستندات والاختبارات وسهولة استخدام الوكيل
- وصفات إعادة الهندسة لتحسين هندسة العوامل البشرية للذكاء الاصطناعي في الأكوار القديمة
- مهارة التشغيل للمشاريع الجديدة بخيارات افتراضية معقولة
- عابر للوكلاء: يعمل في Claude Code و Codex
- أدوات قائمة على TypeScript
عرض مباشر
كيف يبدو في الممارسة
ai-first-toolkit-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: ai-first-toolkit
متى تستخدمه: قبل أن يلتزم الفريق بإجراء الكثير من عمل الميزات من خلال Claude أو Codex.
الخطوات
-
تشغيل الفحص
فحص هذا المستودع لجاهزية الوكيل الذكاء الاصطناعي. قيّم كل بُعد وأدرج أفضل 5 نقاط احتكاك.✓ تم النسخ
→ درجات الأبعاد + الملفات المحددة للإصلاح
-
تحديد أولويات الإصلاحات
أي من هذه الإصلاحات سيوفر أكبر رفع فعالية الوكيل لكل ساعة عمل؟✓ تم النسخ
→ قائمة مصنفة برتبة مع الجهد/التأثير
-
تطبيق أفضل إصلاح
طبّق الإصلاح #1 من الطرف إلى الطرف — حرّر الملفات وحدّث المستندات وأضف الاختبارات.✓ تم النسخ
→ Diff + التأكيد
النتيجة: خطة تحسين محددة وإصلاح واحد على الأقل مطبق يجعل المستودع أكثر ودية للوكلاء الذكاء الاصطناعي.
المزالق
- يتحول الفحص إلى كتلة عامة 'تحسين المستندات' — اطلب نتائج على مستوى الملف:السطر وليس نصائح مجردة
متى تستخدمه: اليوم صفر من مشروع جديد، قبل أن تختار خيارات افتراضية سيئة ستطاردك.
الخطوات
-
حدد المشروع
شغّل مشروع API TypeScript جديد باستخدام خيارات ai-first-toolkit الافتراضية. الغرض: API الفواتير الداخلية.✓ تم النسخ
→ هيكل المجلد المقترح وملف tsconfig والبرامج النصية وهيكل README
-
قالب الملفات
أنشئ الملفات. أدرج AGENTS.md و CLAUDE.md مع ملاحظات قاعدة الأكوار الملائمة.✓ تم النسخ
→ تحقق ملفات المستودع
-
أول التزام
هيّئ git وقم بأول التزام برسالة نظيفة.✓ تم النسخ
→ مستودع أولي نظيف
النتيجة: مستودع جديد صديق للبشر والوكلاء الذكاء الاصطناعي من الالتزام 0.
المزالق
- الهياكل توريد تبعيات لا تريدها — اطلب من Claude عرض قائمة التبعيات قبل التثبيت — اقبل كل واحدة
متى تستخدمه: لقد عزلت وحدة تحصل Claude على نتائج خاطئة باستمرار — عادة ما تكون علامة على أن هيكلها ليس قابلاً للقراءة من الوكيل.
الخطوات
-
تشخيص الوحدة
انظر إلى src/billing/. ما الذي يجعل هذا الأكود صعباً على الوكيل تحريره بأمان؟✓ تم النسخ
→ أعلام حمراء محددة: المراوغة والحالة المخفية والدوال الطويلة
-
خطط لإعادة البناء
اقترح إعادة بناء بـ 3 خطوات تحسن قابلية القراءة من الوكيل دون تغيير واجهة البرمجة العامة.✓ تم النسخ
→ خطة خطوة بخطوة مع رسومات الفروق
-
تنفيذ الخطوة 1
طبّق الخطوة 1. حافظ على الاختبارات خضراء.✓ تم النسخ
→ diff بحجم PR
النتيجة: وحدة يمكن لـ Claude أن يفكر فيها بالفعل في التكرار التالي.
المزالق
- إعادة بناء مفرطة وكسر السلوكيات التي لم تقصدها — أصر على استقرار واجهة البرمجة العامة وقم بتشغيل الاختبارات بعد كل خطوة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
الفحص يمسح المستودع؛ يلزم نظام الملفات لقراءته فعلياً
سِرْ في المستودع وقيّم جاهزية الذكاء الاصطناعي؛ أبلغ عن النتائج ملف تلو الآخر.✓ تم النسخ
ai-first-toolkit-skill +
githubافتح طلب دمج بالإضافات المقترحة AGENTS.md / CLAUDE.md
طبّق أفضل 3 إصلاحات من الفحص وافتح طلب دمج بعنوان 'تحسينات التركيز على الذكاء الاصطناعي'.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء فوق مزود نموذج اللغة الخاص بك
- الرموز لكل استدعاء
- 5–20k رمز لفحص مستودع متوسط الحجم
- التكلفة المالية
- مجاني، مفتوح المصدر
- نصيحة
- نطاق الفحوصات إلى شجرة فرعية بدلاً من monorepo بأكملها
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء فوق ما تفعله أدوات filesystem/github
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
الفحص مجرد جداً
أعد الطلب ببُعد محدد: 'قيّم فقط تخطيط الاختبار' أو 'فقط حدود الوحدة'.
التشغيل يختار لغة خاطئة
اذكر دائماً اللغة + وقت التشغيل + أداة البناء في الطلب الأول.
البدائل
ai-first-toolkit مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| init (مدمج) | أنت تحتاج فقط إلى CLAUDE.md ولا تهتم بالباقي | نطاق أضيق |
| antivibe-skill | تريد العدسة المعاكسة — انتقاد من الوكيل الذكاء الاصطناعي | تشخيصي وليس وصفياً |