Aider: SEARCH/REPLACE blocks

Aider أداة CLI بتجمع LLM مع repo محلي. بتطبّق مخرج الموديل على الملفات بـ format محدد — SEARCH/REPLACE blocks — قابل للقراية من البشر وسهل لأي script يطبّقه. حتى لو مش بتستخدم Aider، الـ format primitive مفيد في prompt engineering: بيجبر الموديل يلتزم بـ النص الموجود بالظبط قبل ما يقترح التغيير.

الـ format صارم:

filename.ext
<<<<<<< SEARCH
(exact existing lines)
=======
(new lines)
>>>>>>> REPLACE

الموديل لازم يعيد إنتاج السطور الموجودة byte-by-byte. لو غلط في حرف واحد، خطوة الـ apply بتفشل. الفشل ده ميزة مش bug — SEARCH block غلط بيقولك إن الموديل قرا الملف غلط، وأحسن تعرف ده قبل التطبيق مش بعديه.

دي مهمة صغيرة بالأسلوب ده:

Apply this change to src/server.py using a SEARCH/REPLACE block:

Goal: convert the synchronous fetch_user call into an async one and add a 5-second timeout.

Current:

def get_profile(user_id: str):
    user = fetch_user(user_id)
    return {"id": user.id, "name": user.name}

Output ONLY a SEARCH/REPLACE block in the format: src/server.py <<<<<<< SEARCH (exact existing lines) ======= (new lines) >>>>>>> REPLACE

Claude Sonnet 4.5 رجّع:

src/server.py
<<<<<<< SEARCH
def get_profile(user_id: str):
    user = fetch_user(user_id)
    return {"id": user.id, "name": user.name}
=======
async def get_profile(user_id: str):
    user = await asyncio.wait_for(fetch_user(user_id), timeout=5.0)
    return {"id": user.id, "name": user.name}
>>>>>>> REPLACE

Captured from Claude Sonnet 4.5 (claude-sonnet-4-5) on 2026-04-27. Re-runs may differ slightly.

الـ block جاهز للصق في Aider، وكمان قابل للقراية من البشر. الـ reviewer يقدر يمسح SEARCH section، يمسح REPLACE section، ويأكد التغيير من غير تشغيل الأداة.

3 حاجات SEARCH/REPLACE بيجبرها unified diff ما بيجبرهاش:

الخاصية	ليه مهمة
سطور موجودة بالظبط	الموديل لازم يقرا الملف بدقة قبل اقتراح التغييرات
تطابق single-anchor	الـ apply بيفشل على تطابق غامض، فبيظهّر مشاكل خفية
مفيش اعتمادية على line numbers	الـ block شغّال حتى لو السطور حواليه اتحرّكت

الخاصية التالتة هي اللي بتخلّي SEARCH/REPLACE قوي جداً في sessions طويلة. Unified diff بـ line numbers بيبقى مش valid أول ما تغيير تاني يحرّك السطور دي. SEARCH block بيفضل valid طول ما المحتوى اللي بيدوّر عليه ما اتغيّرش.

دورة الـ apply في Aider:

Constraint للسلامة: لما التغيير كبير، اطلب block واحد لكل وحدة منطقية، مش block ضخم:

If the change spans multiple logical edits (e.g., function signature + body + caller updates), output one SEARCH/REPLACE block per edit.

Blocks صغيرة كتير بتفشل بشكل مستقل. لو واحد فشل في الـ apply، بتحتفظ بالباقي. Block ضخم واحد بيفشل atomically — كله أو ولا حاجة — وده نادراً اللي عايزه أثناء التطوير المتكرر.

ملاحظة على الـ import الناقص: في المخرج المسجّل، الموديل استخدم asyncio.wait_for من غير ما يضيف import asyncio فوق الملف. ده gap حقيقي — التغيير مش بيتجمّع زي ما هو. الحل SEARCH/REPLACE block متابعة بتضيف الـ import، أو prompt أصرم: "Include any imports the change requires; if an import is missing from the file, add a separate SEARCH/REPLACE block to add it."

دي قيمة الشغل بـ format Aider حتى من برّه. الـ format بيخلّي الفشل مرئي.

التالي: planning prompts لـ agents بأسلوب Claude Code. :::