انتقل إلى المحتوى الرئيسي

كيفية إنشاء ملفات جديدة باستخدام Cursor Agent

مقدمة​

إنشاء ملفات جديدة من خلال التفاعل مع AI agent هي ميزة يتم طلبها بشكل متكرر في Cursor. على الرغم من أن واجهة الدردشة نفسها لا تدعم إنشاء الملفات مباشرة، إلا أن هناك طرقًا أخرى متاحة.

الحلول الحالية​

1. استخدام Composer (موصى به)​

الطريقة الموصى بها لإنشاء ملفات جديدة هي استخدام Composer (Ctrl + I). تتيح هذه الميزة:

  • إنشاء وتحرير ملفات متعددة
  • إنشاء هيكل ملفات كامل
  • تطبيق التغييرات على ملفات متعددة في وقت واحد

أمثلة على السيناريوهات:​

  1. إنشاء هيكل موقع HTML كامل:

    • index.html
    • css/styles.css
    • js/script.js

  2. تقسيم عقد OpenAPI إلى ملفات متعددة

  3. إنشاء ملفات المكونات وملفات الأنماط والاختبارات المرتبطة بها

2. طريقة Command+K​

يمكنك استخدام Command+K (أو Ctrl+K) لإنشاء ملف من الصفر، لكن هذا يقتصر على إنشاء ملف واحد.

سيناريوهات الاستخدام الشائعة​

1. تطوير المكونات​

  • إنشاء مكونات React جديدة مع ملفات مستقلة
  • إنشاء ملفات الاختبار المرتبطة
  • إنشاء ملفات الأنماط للمكونات

2. بنية الاختبارات​

  • إنشاء ملفات اختبار الوحدة لمكونات متعددة: 
    component1.ts → component1.test.ts
    component2.ts → component2.test.ts
    component3.ts → component3.test.ts

3. التدويل​

  • إنشاء ملفات ترجمة JSON
  • إنشاء ملفات موارد للغات محددة

4. إعادة هيكلة الكود​

  • استخراج الدوال إلى ملفات الأدوات
  • تقسيم الملفات الكبيرة إلى وحدات
  • إنشاء ملفات نقاط النهاية الجديدة

أفضل الممارسات​

  1. استخدم Composer للعمليات متعددة الملفات
  2. قدم وصفًا واضحًا لهيكل الملفات المطلوب
  3. قم بتضمين سياق حول علاقات الملفات
  4. حدد أي اتفاقيات أو أنماط تسمية يجب اتباعها

نصائح​

  • عند استخدام Composer، كن محددًا بشأن هيكل المجلدات المراد إنشاؤه
  • قم بتضمين تفاصيل حول تبعيات وارتباطات الملفات
  • للهياكل المعقدة، قم بتقسيم عملية الإنشاء إلى خطوات أصغر
  • تحقق من الملفات المنشأة قبل تطبيق التغييرات

المصدر​

@https://forum.cursor.com/t/agent-create-new-files/408