skill
التحقق قبل الإنجاز
يستخدم عند الإعلان عن اكتمال العمل، أو إصلاحه، أو اجتيازه، قبل الالتزام أو إنشاء طلبات السحب (PRs) - يتطلب تشغيل أوامر التحقق وتأكيد المخرجات قبل تقديم أي ادعاءات بالنجاح؛ الدليل قبل التأكيدات دائما.
نبذة
# التحقق قبل الإنجاز
## نظرة عامة
**المبدأ الأساسي:** الدليل قبل الادعاءات، دائما.
**انتهاك نص هذه القاعدة هو انتهاك لروحها.**
## القانون الحديدي
``` لا ادعاءات بالإنجاز بدون دليل تحقق حديث ```
إذا لم تقم بتشغيل أمر التحقق في هذه الرسالة، فلا يمكنك الادعاء بنجاحها.
## وظيفة البوابة
``` قبل الادعاء بأي حالة أو التعبير عن الرضا:
1. تحديد: ما هو الأمر الذي يثبت هذا الادعاء؟ 2. تشغيل: تنفيذ الأمر بالكامل (حديث، كامل) 3. قراءة: الإخراج الكامل، التحقق من رمز الخروج، عد الإخفاقات 4. التحقق: هل يؤكد الإخراج الادعاء؟ - إذا لا: اذكر الحالة الفعلية مع الدليل - إذا نعم: اذكر الادعاء مع الدليل 5. عندها فقط: قم بالادعاء
تخطي أي خطوة = كذب، وليس تحققا ```
## الإخفاقات الشائعة
| الادعاء | يتطلب | غير كاف | |-------|----------|----------------| | الاختبارات ناجحة | إخراج أمر الاختبار: 0 إخفاقات | تشغيل سابق، "يجب أن ينجح" | | المدقق نظيف | إخراج المدقق: 0 أخطاء | فحص جزئي، استقراء | | البناء ينجح | أمر البناء: exit 0 | المدقق ناجح، السجلات تبدو جيدة | | تم إصلاح الخلل | اختبار العرض الأصلي: ناجح | تم تغيير الكود، يفترض أنه تم إصلاحه | | اختبار الانحدار يعمل | دورة أحمر-أخضر تم التحقق منها | الاختبار ينجح مرة واحدة | | العميل أكمل | فرق VCS يظهر التغييرات | العميل يبلغ عن "نجاح" | | تم استيفاء المتطلبات | قائمة تحقق سطرا بسطر | الاختبارات ناجحة |
## علامات حمراء - توقف
- استخدام "يجب أن"، "ربما"، "يبدو أن" - التعبير عن الرضا قبل التحقق ("رائع!"، "مثالي!"، "تم!"، إلخ.) - على وشك الالتزام/الدفع/طلب السحب (PR) بدون تحقق - الثقة في تقارير نجاح العميل (Agent) - الاعتماد على التحقق الجزئي - التفكير "فقط هذه المرة" - التعب والرغبة في إنهاء العمل - **أي صيغة توحي بالنجاح دون إجراء التحقق**
## منع التبرير
| العذر | الواقع | |--------|---------| | "يجب أن يعمل الآن" | قم بتشغيل التحقق | | "أنا واثق" | الثقة ≠ دليل | | "فقط هذه المرة" | لا استثناءات | | "المدقق نجح" | المدقق ≠ المترجم (compiler) | | "العميل قال نجاح" | تحقق بشكل مستقل | | "أنا متعب" | الإرهاق ≠ عذر | | "الفحص الجزئي كاف" | الجزئي لا يثبت شيئا | | "كلمات مختلفة لذا القاعدة لا تنطبق" | الروح فوق النص |
## الأنماط الرئيسية
**الاختبارات:** ``` ✅ [تشغيل أمر الاختبار] [انظر: 34/34 ناجح] "جميع الاختبارات ناجحة" ❌ "يجب أن ينجح الآن" / "يبدو صحيحا" ```
**اختبارات الانحدار (TDD Red-Green):** ``` ✅ كتابة ← تشغيل (نجاح) ← التراجع عن الإصلاح ← تشغيل (يجب أن يفشل) ← استعادة ← تشغيل (نجاح) ❌ "لقد كتبت اختبار انحدار" (بدون تحقق أحمر-أخضر) ```
**البناء:** ``` ✅ [تشغيل البناء] [انظر: exit 0] "البناء ينجح" ❌ "المدقق نجح" (المدقق لا يتحقق من الترجمة) ```
**المتطلبات:** ``` ✅ إعادة قراءة الخطة ← إنشاء قائمة تحقق ← التحقق من كل بند ← الإبلاغ عن الفجوات أو الإنجاز ❌ "الاختبارات ناجحة، المرحلة مكتملة" ```
**تفويض العميل (Agent):** ``` ✅ العميل يبلغ عن نجاح ← التحقق من فرق VCS ← التحقق من التغييرات ← الإبلاغ عن الحالة الفعلية ❌ الثقة في تقرير العميل ```
## متى يتم التطبيق
**دائما قبل:** - أي صيغة من ادعاءات النجاح/الإنجاز - أي تعبير عن الرضا - أي بيان إيجابي حول حالة العمل - الالتزام (Committing)، إنشاء طلب السحب (PR)، إكمال المهمة - الانتقال إلى المهمة التالية - التفويض للعملاء (Agents)
**القاعدة تنطبق على:** - العبارات الدقيقة - إعادة الصياغة والمرادفات - دلالات النجاح - أي اتصال يوحي بالإنجاز/الصحة
التثبيت
شغل هذا الأمر
npx skills add obra/superpowersيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/verification-before-completion` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة التحقق قبل الإنجاز؟
يستخدم عند الإعلان عن اكتمال العمل، أو إصلاحه، أو اجتيازه، قبل الالتزام أو إنشاء طلبات السحب (PRs) - يتطلب تشغيل أوامر التحقق وتأكيد المخرجات قبل تقديم أي ادعاءات بالنجاح؛ الدليل قبل التأكيدات دائما.
كيف أثبت التحقق قبل الإنجاز؟
شغل هذا الأمر في الطرفية:
npx skills add obra/superpowersمع أي أدوات ذكاء اصطناعي تعمل التحقق قبل الإنجاز؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور التحقق قبل الإنجاز؟
طورها obra.
هل التحقق قبل الإنجاز مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى