Claude Code: نقاط التحقق والتراجع

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

نقاط التحقق هي شبكة أمان Claude Code — لقطات تلقائية قبل العمليات الحرجة، وتراجع في أي وقت إذا ظهرت مشاكل.

💡 نصيحة: نقاط التحقق ليست مجرد التزامات git — بل لقطات على مستوى الجلسة تسجّل حالة كل عملية للتراجع الدقيق إلى أي خطوة.

📋 المتطلبات السابقة: الفصل 19 - دليل أوامر CLI

1. ما ستتعلمه


2. آلية نقاط التحقق

(1) كيف تعمل

شرط التفعيل إنشاء تلقائي الوصف
بداية الجلسة ✅ تسجيل الحالة الأولية
قبل تعديل الملف ✅ تسجيل حالة ما قبل التعديل
قبل تنفيذ الأمر ✅ تسجيل حالة ما قبل الأمر
طلب يدوي ✅ /checkpoint

▶ مثال 1: عرض قائمة نقاط التحقق

TEXT 📖 للعرض فقط
> /checkpoints

  #1 [14:20:00] بداية الجلسة | 0 ملفات تغيرت
  #2 [14:22:15] تعديل jwt.ts | 2 ملفات تغيرت
  #3 [14:25:30] تعديل auth.ts | 1 ملف تغيّر
  #4 [14:30:15] إضافة اختبارات | 3 ملفات تغيرت
  #5 [14:35:00] الحالة الحالية | 6 ملفات تغيرت

3. نقاط التحقق اليدوية

(1) إنشاء نقطة تحقق

TEXT 📖 للعرض فقط
> /checkpoint
✅ Checkpoint #6 created

> /checkpoint "Pre-migration state"
✅ Checkpoint #6 created with description

(2) أفضل الممارسات — متى تنشئ

التوقيت السبب
قبل تغييرات كبيرة إعادة هيكلة، ترحيل، إلخ
إنجاز معلم انتهاء نقطة ميزة
عمليات غير مؤكدة قبل تعديلات تجريبية
قبل المغادرة حفظ التقدم الحالي

▶ مثال 2: قبل تغييرات كبيرة

TEXT 📖 للعرض فقط
> /checkpoint "Pre-migration state"
✅ Checkpoint #6 created

> Migrate auth from Session to JWT

Claude Code: Modifying 12 files... 3 tests failed ❌

# تقرر أليس التراجع والمحاولة بطريقة مختلفة
> /rollback 6
✅ Rolled back to checkpoint #6 (pre-migration state)

4. عمليات التراجع

(1) طرق التراجع

الأمر الوصف
/rollback التراجع إلى نقطة التحقق السابقة
/rollback <n> التراجع إلى نقطة التحقق المحددة
/undo التراجع عن آخر عملية
git checkout . إرجاع جميع التغييرات غير الملتزم بها

▶ مثال 3: تراجع خطوة بخطوة

TEXT 📖 للعرض فقط
> /checkpoints
  #1 [14:20] البداية
  #2 [14:22] إضافة UserService
  #3 [14:25] إضافة اختبارات
  #4 [14:30] إعادة هيكلة UserService (فشلت)
  #5 [14:35] محاولة إصلاح (لا تزال تفشل)

# تراجع فقط عن إعادة الهيكلة الفاشلة، مع الإبقاء على الإضافات الناجحة
> /rollback 3
✅ Rolled back to checkpoint #3
   أُبقي على: UserService + اختبارات
   أُلغي: إعادة الهيكلة + محاولة الإصلاح

# إعادة الهيكلة بأسلوب مختلف
> Refactor UserService with different approach

5. نقاط التحقق مقابل Git

(1) المقارنة

البُعد نقطة التحقق Git
الدقة مستوى العملية مستوى الالتزام
الاستمرارية الجلسة فقط دائم
التخزين الذاكرة/مؤقت المستودع
المشاركة غير قابل للمشاركة قابل للدفع
التراجع دقيق حتى الخطوة دقيق حتى الالتزام

(2) استراتيجية التعاون

TEXT 📖 للعرض فقط
# أفضل ممارسة: نقاط التحقق + git تأمين مزدوج

# 1. التزام git قبل الجلسة
git add -A && git commit -m "before: claude session"

# 2. استخدام نقاط التحقق للتراجع داخل الجلسة
/checkpoint "Milestone complete"
/rollback 3

# 3. التزام git بعد الجلسة
git add -A && git commit -m "feat: user auth module"

# 4. إذا فشلت الجلسة بالكامل، تراجع git
git reset --hard HEAD~1

6. شبكة أمان متعددة الطبقات

TEXT 📖 للعرض فقط
المستوى 1: /undo          — التراجع عن آخر عملية
المستوى 2: /rollback      — التراجع إلى نقطة تحقق
المستوى 3: git checkout   — إرجاع التغييرات غير الملتزم بها
المستوى 4: git reset      — التراجع إلى أي التزام
المستوى 5: git reflog     — استعادة الالتزامات المفقودة

❓ أسئلة شائعة

س كم مدة بقاء نقاط التحقق؟
ج فقط ضمن الجلسة الحالية. الخروج يفقد نقاط التحقق، لكن التزامات git دائمة.
س هل يُفقد كل التقدم عند التراجع؟
ج لا. التراجع إلى نقطة تحقق محددة يُلغي فقط التغييرات بعد تلك النقطة؛ والتغييرات السابقة تُحفظ.
س هل يمكن التراجع عن ملف واحد؟
ج تراجع نقطة التحقق على مستوى الخطوة. تراجع ملف واحد: git checkout -- <file>.
س بعد التراجع، هل يتذكر Claude Code المحادثة السابقة؟
ج نعم. سجل المحادثات يُحفظ لكن حالة الملفات يُتراجع عنها. Claude Code يعرف ما فعلته وما تراجعت عنه.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أنشئ نقطة تحقق، أجرِ تغييرات، تراجع، وتحقق من استعادة الملف.
  2. متوسط (⭐⭐): نفّذ 3 خطوات تعديل، تراجع إلى الخطوة 2، وتحقق من حفظ الخطوة 1 وإلغاء الخطوة 3.
  3. متقدم (⭐⭐⭐): صمّم شبكة أمان متعددة الطبقات تجمع بين نقاط التحقق و git لاستعادة أي عملية.
Web-Tutorial.com

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

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

100%