افهرس قاعدة شفرتك مرة واحدة، ودع Cursor Agent يحلّها

تمنح فهرسة قاعدة الشفرة (codebase indexing) في Cursor وضع Agent فهمًا دلاليًا لبنية مشروعك بأكمله، دون تبديل يدوي للسياق. افهرس مرة واحدة، ثم صف المهام عالية المستوى بلغة طبيعية، وسيستكشف الوكيل الملفات تلقائيًا ويجري تعديلات على ملفات متعددة ويشغّل الاختبارات ويكرّر حتى الإنجاز، ما يقلّص وقت التطوير للميزات المعقّدة بنسبة 50-70%.

ليست الميزة المميّزة في Cursor الإكمال التلقائي، بل فهرسة قاعدة الشفرة. فبخلاف إضافات بيئة التطوير (IDE) التي لا ترى سوى ملفك الحالي، يبني Cursor فهرسًا دلاليًا لمستودعك بأكمله، ما يمنح الذكاء الاصطناعي سياقًا عميقًا عن بنية مشروعك وأنماطه واعتمادياته. وهذا يحوّل وضع Agent من التخمين إلى الاستدلال.

أعدّ الفهرسة فور استنساخ المستودع: افتح Cursor، واضغط Cmd+Shift+P، وابحث عن "Cursor: Index Codebase"، وانتظر حتى يكتمل بناء الفهرس. يحدث هذا مرة واحدة ويبقى محفوظًا. الآن، عندما تصف مهمة لوضع Agent (Cmd+L، ثم بدّل إلى Agent)، يقرأ الذكاء الاصطناعي الفهرس قبل إجراء التغييرات، فيفهم كيف تنتقل التعديلات في ملف واحد عبر قاعدة الشفرة.

ومن سير عمل مهني ملموس: بدلًا من استكشاف الملفات يدويًا لإعادة هيكلة وحدة قديمة، اكتب أمرًا محدّد النطاق مثل "أضف وسيطًا لتحديد معدّل الطلبات إلى POST /api/users، وحدّث تعريفات الأنواع في مجلد types، واكتب اختبارات Vitest." سيقوم وضع Agent المزوّد بسياق قاعدة الشفرة باستكشاف الملفات ذات الصلة، وإجراء التغييرات عبر ملفات متعددة، وتشغيل الاختبارات، والتقاط الأخطاء، والتكرار، فينجز ما يستغرق عادةً ساعتين إلى ثلاث في 15 إلى 30 دقيقة. استخدم الإشارات @codebase و@folder لتوجيه السياق نحو مناطق محدّدة عندما تكون المهمة معقّدة. وتفيد الفرق بأن سرعة التطوير تزداد مرتين إلى ثلاث مرات عندما تفهرس مبكرًا وتستخدم وضع Agent للمهام متعددة الملفات بدلًا من التعديلات على ملف واحد.