إعادة هيكلة دالة قديمة بوضع الوكيل
يخلي وكيل Cursor (Agent) يعيد هيكلة دالة أو ملف معقد بخطوات واضحة، مع الحفاظ على نفس السلوك الخارجي وشرح كل تعديل قبل ما تعتمده.
prompt.txt
أعد هيكلة الكود التالي بوضع الوكيل (Agent)، بالخطوات هذي بالترتيب: 1. اشرح أولاً وش المشاكل الموجودة بالكود الحالي (تسمية غير واضحة، دالة تسوي أكثر من مهمة، تكرار، تعامل ضعيف مع الأخطاء، إلخ) 2. اقترح خطة إعادة الهيكلة قبل ما تعدّل أي شي — قائمة نقاط مختصرة 3. نفّذ التعديل بالحفاظ التام على نفس السلوك الخارجي (نفس المدخلات تعطي نفس المخرجات) — بدون إضافة ميزات جديدة 4. لو التعديل يمس أكثر من ملف، اذكر كل ملف تغيّر وليش 5. اعرض ملخص أخير بالفرق (diff) قبل ما أعتمد التغيير الكود أو اسم الملف/الدالة: [الصق الكود هنا، أو اكتب `@اسم-الملف` لو تبيه يقرأه من فهرسة المشروع] السياق الإضافي: [مثلاً: هذي دالة تعالج طلبات API، أو مكوّن React يتكرر بأكثر من صفحة، إلخ] قيود مهمة: لا تغيّر توقيع الدالة العام (اسم/مدخلات/مخرجات) إلا لو ذكرت لك إني موافق على كسر التوافق.
أغلب الوقت اللي تضيعه بإعادة هيكلة كود قديم مو بكتابة النسخة الجديدة — بفهم وش يسوي الكود الحالي فعليًا قبل ما تلمسه. هذا البرومبت يفرض على وكيل Cursor يشرح المشكلة ويخطط قبل ما يعدّل، عشان ما توصل لتعديل يبدو نظيفًا لكنه يكسر سلوكًا كنت تعتمد عليه.
متى تستخدمه
- دالة كبرت مع الوقت وصارت تسوي أكثر من مهمة وحدة
- كود ورثته من مطور ثاني وما فيه توثيق واضح
- قبل ما تضيف ميزة جديدة على ملف قديم، وتبي تنظفه أول
- لما تشوف نفس المنطق مكرر بأكثر من مكان بالمشروع
طريقة الاستخدام
- افتح وضع الوكيل بـ
Cmd/Ctrl + Iداخل Cursor - الصق البرومبت، واستبدل الجزء بين الأقواس بالكود الفعلي أو
@mention للملف - اقرأ خطة إعادة الهيكلة اللي يقترحها قبل ما توافق على التنفيذ
- راجع الـdiff النهائي بعناية — الوكيل يعدّل، أنت المسؤول عن الاعتماد
نصيحة تفرق
لو المشروع عنده ملف .cursorrules، تأكد فيه قاعدة توضح أسلوب التسمية والبنية اللي تفضلها — كذا إعادة الهيكلة تطلع متوافقة مع باقي المشروع من أول مرة، بدل ما تحتاج تصحيح يدوي بعدها.