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%