Written with AI assistance from the source video. The video is the authority.
Log in to leave a comment
No posts yet
عند ربط Claude Code أو Aider بمستودع ضخم يحتوي على مئات الآلاف من الأسطر، يبدأ الوكيل في قراءة الملفات الخاطئة أولاً. نافذة السياق الخاصة بالنموذج محدودة، وعندما يقوم بجمع ملفات غير ذات صلة، فإنه يستهلك الحد الأقصى للرموز (Tokens) ويقوم بتعديل كود خاطئ.
لا يمكن حل هذه المشكلة ببساطة عن طريق كتابة توجيهات أطول. يجب تقليص النطاق المادي للكود الذي يستكشفه الوكيل، وزرع قواعد التحقق الآلي محلياً.
في المستודعات الضخمة، عادةً ما تكون هناك ثلاثة أماكن يقع فيها الوكيل في حلقة بحث لا نهائية: مجلد الأدوات المساعدة المشتركة الذي تجمع وظائف مساعدة منوعة (src/utils/)، وطبقة الخدمات التي تتداخل فيها منطق الأعمال (src/services/)، ومجلد النماذج العامة (src/models/). عندما تبدأ هذه المجلدات الثلاثة في الإشارة إلى بعضها البعض، يضطر الوكيل إلى قراءة عشرات الملفات فقط لإصلاح سطر واحد من الكود.
من خلال تجميع المجلدات المقسمة حسب الطبقة التقنية في وحدات تعتمد على النطاق (Domain)، يتم تقليص نطاق البحث.
| التمييز | الهيكل القائم على الطبقات | الهيكل القائم على النطاق | تغيير سلوك الوكيل |
|---|---|---|---|
| معيار المجلد | فصل الطبقات التقنية (/controllers, /services) |
فصل النطاق (/domains/order) |
استكشاف الملفات المطلوبة فقط داخل مجلد واحد |
| اتصال الاعتماديات | استيراد الكيانات العامة مباشرة | الاتصال عبر حدود واجهة النطاق | منع ظاهرة التحميل المتسلسل للملفات غير ذات الصلة |
| المنطق المشترك | اختلاط الدوال في src/utils/ واحدة |
الفصل إلى أدوات خاصة بالنطاق وحزم مشتركة | منع تلوث السياق العام غير الضروري |
الترتيب الخاص بنقل المجلدات دون توقف الخدمة قيد التشغيل هو كالتالي:
src/domains/{domain_name}/ وقم بتحديث مراجع المسار في ملف tsconfig.json.CLAUDE.md) داخل المجلد الفرعي المفصول.تتحول إرشادات البرمجة المكتوبة بنصوص طبيعية طويلة بسهولة على الوكيل. يجب وضع أرقام وحظر واضح في أعلى ملف الإعدادات لضمان اتباع الإرشادات بدقة.
`markdown
`
إذا تجاوز ملف الإعدادات 200 سطر، فغالبًا ما يتم تجاهل التعليمات اللاحقة.
CLAUDE.md الموجود بالمجلد الجذر، حافظ على أوامر البناء وقواعد الالتزام العامة في حدود 200 سطر.src/domains/order/ في ملفات القواعد المخصصة داخل هذا المجلد.CLAUDE.local.md وسجلها في .gitignore لمنع التعارضات.يجب اكتشاف أخطاء بناء جملة الكود أو الأخطاء الارتجاعية التي ينشئها الوكيل تلقائيًا وقت الالتزام (Commit). باستخدام أداة Lefthook التي تعمل كملف تنفيذي أحادي لـ Go، يمكنك تشغيل عمليات فحص متوازية بخفة أكبر من الأدوات القائمة على Node.js.
ضع ملف lefthook.yml في الجذر وافصل الفحوصات الثابتة الخفيفة عن خطوات الاختبار الثقيلة.
`yaml
pre-commit:
parallel: true
commands:
linter:
glob: ".{ts,tsx}"
run: npx eslint --fix {staged_files}
stage_fixed: true
formatter:
glob: ".{ts,tsx,json,md}"
run: npx prettier --write {staged_files}
stage_fixed: true
security-scan:
run: gitleaks git --staged --no-banner
pre-push:
parallel: false
commands:
typecheck:
run: npx tsc --noEmit
unit-tests:
run: npm run test:unit -- --passWithNoTests
`
يقوم pre-commit في مرحلة الالتزام بفحص الملفات المؤقتة في غضون 10 ثوانٍ، بينما ينتقل الفحص الكامل للأنواع واختبارات الوحدة إلى مرحلة الدفع pre-push.
قم بتسجيل أداة اعتراض .claude/hooks/block-no-verify.mjs لمنع الوكيل من تجاوز الخطاف باستخدام خيار --no-verify.
`javascript
import fs from 'fs';
const input = fs.readFileSync(0, 'utf8');
const parsed = JSON.parse(input);
if (parsed.tool_input?.command?.includes('--no-verify')) {
console.error("Policy Violation: `--no-verify` flag is strictly prohibited.");
process.exit(1);
}
process.exit(0);
`
إذا فشل الخطاف، يدخل خطأ وحدة التحكم في المطالبة التالية لكي يقوم الوكيل بتصحيح الكود بنفسه.
إذا بدأ الوكيل في قراءة نتائج البناء أو ملفات القفل (Lock files)، فستستنفد الرموز بسرعة. يجب إغلاق نطاق استكشاف الملفات لمنع التكاليف غير المقصودة.
أنشئ ملف .ignore أو .aiderignore في جذر المشروع وسجل الأصول الكبيرة.
`text
node_modules/
dist/
build/
coverage/
*.min.js
*.svg
*.lock
package-lock.json
public/assets/
db/migrations/
`
حتى عند التشغيل من سطر الأوامر، حدد مجلد العمل لحظر الفحص الشامل.
bash aider "Refactor Order validation logic" --path=src/domains/order/ --exclude=src/domains/order/__tests__/
قبل تعديل الكود، قم بتغيير الحالة إلى وضع التخطيط للتحقق من التغييرات أولاً، وكتابة اختبارات وحدة تفشل ثم كتابة الكود الذي ينجح يحافظ على نطاق عمل الوكيل بشكل آمن.