Claude Code: نقاط التحقق والتراجع
آخر تحديث: 2026-08-31
نقاط التحقق هي شبكة أمان Claude Code — لقطات تلقائية قبل العمليات الحرجة، وتراجع في أي وقت إذا ظهرت مشاكل.
💡 نصيحة: نقاط التحقق ليست مجرد التزامات git — بل لقطات على مستوى الجلسة تسجّل حالة كل عملية للتراجع الدقيق إلى أي خطوة.
📋 المتطلبات السابقة: الفصل 19 - دليل أوامر CLI
1. ما ستتعلمه
- آلية نقاط التحقق واللقطات التلقائية
- إنشاء نقاط تحقق يدوية
- التراجع إلى أي خطوة
- العلاقة بين نقاط التحقق و git
- استراتيجيات شبكة الأمان
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 يعرف ما فعلته وما تراجعت عنه.
📖 ملخص
- نقاط التحقق تُنشأ تلقائياً قبل العمليات الحرجة؛ ويدوياً عبر
/checkpoint /rollback <n>للتراجع الدقيق إلى خطوة محددة- نقاط التحقق على مستوى الجلسة؛ وgit دائم؛ استخدم كليهما معاً
- شبكة أمان متعددة الطبقات: undo → rollback → git checkout → git reset → reflog
- أنشئ دائماً نقاط تحقق قبل التغييرات الكبيرة
📝 تمارين
- أساسي (⭐): أنشئ نقطة تحقق، أجرِ تغييرات، تراجع، وتحقق من استعادة الملف.
- متوسط (⭐⭐): نفّذ 3 خطوات تعديل، تراجع إلى الخطوة 2، وتحقق من حفظ الخطوة 1 وإلغاء الخطوة 3.
- متقدم (⭐⭐⭐): صمّم شبكة أمان متعددة الطبقات تجمع بين نقاط التحقق و git لاستعادة أي عملية.