08 ديسمبر 2025·3 دقيقة
Claude Code للاندماج في قاعدة الشيفرة: محفزات ترسم تطبيقك
Claude Code للاندماج في قاعدة الشيفرة: استخدم محفزات سؤال/جواب لرسم الوحدات، التدفّقات الرئيسية، والمخاطر، ثم حوّل الملاحظات إلى مستند اندماج قصير.
Claude Code للاندماج في قاعدة الشيفرة: استخدم محفزات سؤال/جواب لرسم الوحدات، التدفّقات الرئيسية، والمخاطر، ثم حوّل الملاحظات إلى مستند اندماج قصير.
Glossary
Key flow (name) 1. 2. 3.
Unknowns
Risk register
هاتِ خريطة ذهنية قابلة للاستخدام، لا فهمًا تامًا لكل شيء.
نتيجة قوية بعد يوم إلى يومين هي:
زَوِّد المساعد بقطع ملموسة حتى يشير إلى شيفرة حقيقية بدلًا من التخمين:
اختر شريحة ضيِّقة بحدود واضحة.
إعداد افتراضي جيّد هو:
سجّل ما هو خارج النطاق صراحةً (خدمات أخرى، وحدات قديمة، ميزات نادرًا ما تستخدم) حتى لا يتيه المساعد.
ابدأ من المحفزات المعروفة، ثم امشِ إلى الأمام:
اطلب مسارات ملفات وأسماء دوال بالترتيب وختم كل استعلام بسؤال: "كيف سأختبر هذا بسرعة؟"
انظر إلى الأماكن التي يتخذ فيها النظام قرارات أو يغيّر الحالة:
استخدم نظام تسمية بسيط وألحق خطوة تحقق واحدة.
مثال:
أجبر المساعد على فصل الأدلة عن الاستنتاج.
اطلب منه وسم كل ادعاء بإحدى الخانات:
عندما يكون شيء ما غير معروف، حوّله إلى سؤال لزميل بدل ملأ الفراغ بتخمين.
احتفظ بملف ملاحظات خفيف مع خمسة أقسام:
اجعل التحقق سريعًا وواقعيًا:
هذا يؤكد أنك خرّطت المسار الذي يستخدمه التطبيق فعليًا.
استخدم ميزات المنصة لتقليل المساحة المتأثرة وإبقاء التغييرات قابلة للمراجعة.
إعدادات عملية:
يناسب هذا خاصة مهام الاندماج مثل "إضافة حارس"، "تشديد التحقق"، أو "تحسين مسار الخطأ".
Repo tour "Here is the top-level folder list: <paste>. Explain what each folder likely contains and which ones matter for core product behavior."
Entry points "Find the app entry points and boot process. What files start the app, set up routing, configure DI/env, and start background jobs? Name the exact files and what they do."
Module index "Create a module index: module name, purpose, key files, and important external dependencies. Keep it to the modules that affect user-facing behavior."
Data model hints "Based on migrations/models, list the key tables/entities, critical fields, and relationships. Call out fields that look security-sensitive or used for billing/permissions."
Flow trace "Trace this flow end-to-end: <flow>. Where does the request/event start, where does it end, and what does it call in between? List the main functions/files in order."
Next inspection
"What should I inspect next and why? Give me 3 options: fastest clarity, riskiest area, and best long-term payoff."
\n\nمثال ملموس: إذا كنت ترسم تدفق "المستخدم يسجل ويُنشئ مشروعه الأول"، اطلب معالج نقطة النهاية في الـ API، التحقق، كتابة DB، وأي وظيفة غير متزامنة ترسل بريدًا أو تخصّ موارد. ثم أعد تشغيل تتبّع التدفق لـ "المستخدم يحذف المشروع" لاكتشاف ثغرات التنظيف.\n\nللحفاظ على الأجوبة قابلة للتنفيذ، اطلب آثارًا محددة، لا عروضًا عامة فقط:\n\n- مسارات الملفات وأسماء الدوال\n- الافتراضات والمجهولات موضّحة بوضوح\n- الاعتماديات مصوغة كـ "إذا غيّرت X، ماذا يتعطّل؟"\n- مهمة قراءة صغيرة يمكنك إنجازها خلال 10 دقائق\n\n## كيف تحفظ الإجابات لتبقى مفيدة\n\nأكبر نجاح في الاندماج هو تحويل أسئلة وأجوبة مبعثرة إلى ملاحظات يستطيع مطوّر آخر إعادة استخدامها. إذا كانت الملاحظات مفهومة لك وحدك، ستُعيد نفس الحفر لاحقًا.\n\nهيكل بسيط أفضل من صفحات طويلة. بعد كل جلسة استكشاف، احفظ الأجوبة في خمسة عناصر صغيرة (ملف واحد أو مستند يكفي): جدول الوحدات، مسرد، التدفّقات الرئيسية، المجهولات، وسجل المخاطر.\n\nإليك قالبًا مُضغوطًا يمكنك لصقه في ملاحظاتك وملؤه أثناء التقدّم:\n\ntext
Module table
ثم اسأل: "أين يمكن أن ينهار الأمر بصمت، وكيف سنلاحظ ذلك؟"
اجعلها قصيرة كي تقوم بتحديثها أثناء التعلم.
أضف سطرًا لكل تدفّق: "كيف سأختبر هذا؟" ليصبح قائمة فحص قابلة للتنفيذ.