Skills: مهارات عمليات الملفات

آخر تحديث: 2026-08-31

الملفات هي حامل الكود — المهارة التي لا تستطيع تشغيل الملفات كمصمم بلا يدين.

1. صندوق أدوات عمليات الملفات

(1) عمليات القراءة

(2) عمليات الكتابة

(3) عمليات التنفيذ

2. أنماط عمليات الملفات

(1) نمط التحليل للقراءة فقط

لا ملفات مُعدلة، مخرجات تحليل فقط:

---
name: code-metrics
description: "تحليل مقاييس الكود"
tools:
  - Read
  - Grep
  - Glob
---

## تدفق التنفيذ
1. Glob لتحديد نطاق ملفات المشروع
2. Grep لحساب أنماط الكود (أصناف، دوال، TODOs)
3. Read لتحليل الملفات الرئيسية بعمق
4. إخراج تقرير المقاييس، بدون تعديل ملفات

(2) نمط التعديل الآمن

نسخ احتياطي قبل التعديل، تحقق بعد:

## قواعد التعديل الآمن
1. اقرأ محتويات الملف الحالية
2. حلّل ما يحتاج تعديلًا
3. Edit بدقة، غيّر الأسطر المستهدفة فقط
4. Bash لتشغيل الاختبارات للتحقق
5. إذا فشلت الاختبارات، اشرح المشكلة واقترح التراجع

(3) نمط العمليات الدفعية

## تدفق إعادة التسمية الدفعية
1. Glob للحصول على قائمة الملفات المستهدفة
2. اذكر جميع التغييرات المخططة
3. Edit واحدًا تلو الآخر لتنفيذ التغييرات
4. Bash لتشغيل مجموعة الاختبارات الكاملة للتحقق

3. استراتيجيات البحث

(1) مبدأ البحث أولاً

نهج خاطئ: اقرأ جميع الملفات → تحقق واحدًا تلو الآخر
نهج صحيح: بحث للتحديد → قراءة دقيقة

(2) أنماط البحث الشائعة

(3) تنسيق البحث + القراءة

graph TD
    A[Glob: تحديد قائمة الملفات] --> B[Grep: البحث عن الأنماط الرئيسية]
    B --> C{وجدت الهدف؟}
    C -->|نعم| D[Read: قراءة معمقة]
    C -->|لا| E[توسيع نطاق البحث]
    D --> F{تحتاج تعديل؟}
    F -->|نعم| G[Edit: تعديل دقيق]
    F -->|لا| H[إخراج نتيجة التحليل]

graph TD
    A[Glob: تحديد قائمة الملفات] --> B[Grep: البحث عن الأنماط الرئيسية]
    B --> C{وجدت الهدف؟}
    C -->|نعم| D[Read: قراءة معمقة]
    C -->|لا| E[توسيع نطاق البحث]
    D --> F{تحتاج تعديل؟}
    F -->|نعم| G[Edit: تعديل دقيق]
    F -->|لا| H[إخراج نتيجة التحليل]

4. ممارسة عمليات الملفات

▶ مثال: مهارة ترحيل مشروع

تحتاج Alice لترحيل مشروع من JavaScript إلى TypeScript:

---
name: js-to-ts-migration
description: "ترحيل ملفات JS إلى TS"
tools:
  - Read
  - Write
  - Glob
  - Grep
  - Bash
---

## تدفق الترحيل
1. Glob للعثور على جميع ملفات .js
2. لكل ملف:
   a. اقرأ المحتويات
   b. حلّل التبعيات والصادرات
   c. Write لإنشاء ملف .ts مقابل
   d. أضف تعليقات توضيحية للأنواع
3. Bash لتشغيل tsc --noEmit للتحقق
4. أخرج تقرير الترحيل

قال Bob: "أكبر خوف في عمليات الملفات هو الحذف أو التعديل العرضي — بحث للتحديد، تعديل دقيق، تحقق بعدها — لا يمكن تخطي أي من هذه الخطوات الثلاث."

❓ الأسئلة الشائعة

📖 ملخص

• ثلاثة أنماط عمليات: تحليل للقراءة فقط، تعديل آمن، عمليات دفعية
• البحث أولاً: Glob/Grep للتحديد، ثم Read للعمق، أخيرًا Edit/Write للتعديل
• مبدأ الأمان: اقرأ قبل التعديل، عدّل بدقة، تحقق بعد التعديل
• استراتيجية الملفات الكبيرة: اقرأ بنطاقات أرقام الأسطر، لا تحمّل الملفات بالكامل

📝 تمارين

1. أساسي (⭐): أنشئ مهارة تحليل للقراءة فقط تحسب تكرارات TODO/FIXME وتوزيعها في مشروع.
2. متوسط (⭐⭐): أنشئ مهارة تعديل آمن تضيف تلقائيًا تلميحات الأنواع لدوال Python، ثم تشغل الاختبارات للتحقق.
3. متقدم (⭐⭐⭐): أنشئ مهارة ترحيل دفعية تحوّل CommonJS require إلى ES Module import، مع معالجة الحالات الحدية مثل التبعيات الدائرية.

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن