Compétences cc-skill-project-guidelines-example
📦

cc-skill-project-guidelines-example

Sûr

إنشاء تطبيقات ذكاء اصطناعي كاملة الطبقات باستخدام إرشادات المشروع

يواجه المطورون صعوبة في الحفاظ على أنماط متسقة عبر المشاريع الكاملة الطبقات. توفر هذه المهارة مخططات الهندسة الجاهزة للاستخدام وأنماط الكود وسير عمل النشر لتطبيقات Next.js وFastAPI مع تكامل Claude AI.

Prend en charge: Claude Codex Code(CC)
🥉 74 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "cc-skill-project-guidelines-example". كيف يجب أن هيكل استجابات API في خادم FastAPI الخاص بنا؟

Résultat attendu:

استخدم نمط ApiResponse العام مع حقول النجاح والبيانات والخطأ. أنشئ نموذج Pydantic مع طرق الفئة ok() للاستجابات الناجحة وfail() للاستجابات الخاطئة. يضمن هذا التعامل المتسق مع الاستجابات عبر جميع نقاط النهاية.

Utilisation de "cc-skill-project-guidelines-example". ما نهج الاختبار الذي يجب أن أستخدمه لمكونات React؟

Résultat attendu:

اتبع أنماط مكتبة اختبار React: قم بعرض المكونات، واستعلم عن العناصر حسب الدور، واختبار تفاعلات المستخدم مع fireEvent. ضع اختبارات الحالة غير المتزامنة مع أنماط await screen.findBy. حافظ على تغطية 80% كحد أدنى.

Audit de sécurité

Sûr
v1 • 2/25/2026

This skill is a documentation-only resource containing project guidelines and code examples. All 47 static analyzer findings are false positives resulting from Markdown code fences being misinterpreted as shell commands. The file contains no executable code, no actual network calls, and no credential access - only documentation of best practices for a full-stack application.

1
Fichiers analysés
355
Lignes analysées
0
résultats
1
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

إحضار أعضاء فريق جدد

استخدم هذه المهارة لجعل المطورين يتقنون بسرعة هندسة المشروع وأنماط الكود وسير عمل النشر.

توحيد مراجعات الكود

ارجع إلى الأنماط الموثقة والقواعد الحرجة أثناء مراجعات الكود لضمان الاتساق عبر قاعدة الكود.

إعداد مثيلات مشروع جديدة

استنسخ البنية والأنماط الموثقة عند إنشاء مشاريع ذات هندسة كاملة طبقات مماثلة.

Essayez ces prompts

مراجعة هندسة المشروع 
بناءً على إرشادات المشروع، اشرح الهندسة لتطبيق Next.js وFastAPI الخاص بنا. قم بتضمين مخطط الخدمة وكيف يتفاعل Claude AI مع الخادم.
إنشاء نمط استجابة API 
باستخدام نموذج استجابة API الموثق من الإرشادات، أنشئ نموذج Pydantic لنقطة نهاية ملف المستخدم التي تُرجع حقول النجاح والبيانات والخطأ.
إعداد هيكل الاختبار 
بتبع متطلبات الاختبار في الإREFIX، أنشئ اختبارات pytest ونموذج اختبار لنقطة نهاية التحقق من الصحة في خادم FastAPI الخاص بنا.
تحضير قائمة التحقق من النشر 
راجع إرشادات سير العمل وأنشئ قائمة تحقق ما قبل النشر لإصدار Cloud Run التالي. قم بتضمين جميع متغيرات البيئة المطلوبة وخطوات البناء.

Bonnes pratiques

  • اكتب الاختبارات قبل التنفيذ باتباع منهجية TDD مع تغطية 80% كحد أدنى
  • حافظ على التساوي - لا تعدل الكائنات أو المصفوفات مباشرة في كود TypeScript أو Python
  • احتفظ بالملفات صغيرة مع 200-400 سطر كحد نموذجي و800 سطر كحد أقصى لإمكانية الصيانة

Éviter

  • استخدام console.log في كود الإنتاج - استخدم أُطر السجل المناسبة بدلاً من ذلك
  • تشفير الأسرار أو بيانات الاعتماد في ملفات المصدر - استخدم متغيرات البيئة دائماً
  • تخطي التحقق من المدخلات - تحقق دائماً باستخدام Pydantic لـ Python أو Zod لـ TypeScript

Foire aux questions

ما حزمة التقنية التي يستخدمها هذا المشروع؟
الواجهة الأمامية: Next.js 15 مع App Router وTypeScript وTailwindCSS. الخادم: FastAPI مع Python 3.11 وPydantic. قاعدة البيانات: Supabase PostgreSQL. الذكاء الاصطناعي: Claude API مع استدعاء الأدوات. النشر: Google Cloud Run.
كيف أقوم بتشغيل الاختبارات لهذا المشروع؟
الخادم: استخدم 'poetry run pytest tests/' مع أعلام التغطية الاختيارية. الواجهة الأمامية: استخدم 'npm run test' للاختبارات الوحدوية و'npm run test:e2e' لاختبارات Playwright من طرف إلى طرف.
ما هي قواعد البرمجة الحرجة التي يجب أن أتبعها؟
لا توجد رموز تعبيرية في الكود، حافظ على التساوي، اتبع TDD مع تغطية 80% كحد أدنى، احتفظ بالملفات أقل من 800 سطر، لا توجد console.log في الإنتاج، استخدم try/catch للتعامل مع الأخطاء، وتحقق من جميع المدخلات باستخدام Pydantic أو Zod.
كيف أنشر هذا التطبيق؟
قم ببناء الواجهة الأمامية باستخدام 'npm run build' ثم انشر باستخدام 'gcloud run deploy frontend --source'. أنشر الخادم باستخدام 'gcloud run deploy backend --source'. تأكد من اجتياز جميع الاختبارات وعدم وجود أسرار مُشفرة قبل النشر.
ما هي متغيرات البيئة المطلوبة؟
تحتاج الواجهة الأمامية إلى NEXT_PUBLIC_API_URL وNEXT_PUBLIC_SUPABASE_URL وNEXT_PUBLIC_SUPABASE_ANON_KEY. يحتاج الخادم إلى DATABASE_URL وANTHROPIC_API_KEY وSUPABASE_URL وSUPABASE_KEY. لا تقم أبداً بتمرير هذه القيم إلى التحكم في الإصدار.
كيف يتم تكامل Claude AI في الخادم؟
يستخدم الخادم حزمة Python من Anthropic مع مخرجات مهيكلة عبر استدعاء الأدوات. حدد نماذج Pydantic لمخططات المخرجات المتوقعة، ثم استخدم client.messages.create مع tool_choice لفرض الاستجابات المهيكلة التي يمكن تحليلها مباشرة.

Détails du développeur

Auteur

affaan-m

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/cc-skill-project-guidelines-example

Réf

main

Structure de fichiers

📄 SKILL.md