إعادة إنتاج الأخطاء: من الـ issue إلى حزمة إعادة إنتاج
💡 الخلاصة في جملة واحدة: أنشئ خط إعادة إنتاج أخطاء الذكاء الاصطناعي الخاص بك باستخدام Grok Bot — اقرأ التقارير، واربط تتبع الـ issues وstaging، وأعد الإنتاج يدويًا خطوة بخطوة بحساب اختباري جديد تمامًا، وأنتج حزمة إعادة إنتاج تتضمن خطوات دقيقة ولقطات شاشة ومعلومات البيئة، مع بقاء بيانات الاعتماد خارج المحادثة طوال الوقت.
هذا هو الدرس الأول في المسار B (للمبرمجين)، ويأتي من نفس صفحة الأدوار الرسمية مع التحقيق في الأداء ويستخدم نفس المنهجية الرسمية ذات الخطوات الست. يتوافق هذا الدرس مع صفحة use-cases الرسمية من بين 8 أدوار، وهو Bug reproduction (أخصائي إعادة إنتاج الأخطاء). الموقع الذي تحدده الوثائق الرسمية له هو: تحويل تقارير الأخطاء إلى حزم إعادة إنتاج موثوقة (reproduction packs) — ليس «تفسير الخطأ لك»، بل تسليم موثوق يمكن للمطورين استخدامه مباشرة لتحديد المشكلة. نوعا الاتصال اللذان تسميهما الوثائق الرسمية صراحةً هما نظام تتبع الـ issues وبيئة staging.
الدرس كله يستغرق حوالي 12 دقيقة. هناك شرط خاص إضافي من الوثائق الرسمية لهذا الدور: تمر بيانات اعتماد الاختبار عبر تسليم آمن (secure handoff) ولا تدخل المحادثة — الخطوة 3 من هذا الدرس مخصصة لكيفية تنفيذ ذلك عمليًا.
ماذا ستستطيع أن تفعل بعد التعلم
- إنشاء Bot «أخصائي إعادة إنتاج الأخطاء»: ربط نظام تتبع الـ issues وبيئة staging، وتحويل تقارير الأخطاء إلى حزم إعادة إنتاج موثوقة
- جعل الـ Bot يعيد الإنتاج خطوة بخطوة في staging بحساب اختباري جديد تمامًا: خطوات دقيقة، والسلوك المتوقع والفعلي، ولقطات الشاشة، ومعلومات المتصفح والنظام، مع إرفاق أصغر حالة اختبار إن أمكن استخلاصها
- تمر بيانات اعتماد الاختبار عبر تسليم آمن (تعبئة تلقائية عبر Vault / إدخال يدوي عبر Take over)، وتبقى خارج المحادثة طوال الوقت دون المساس ببيانات العملاء في بيئة الإنتاج
- حفظ سير عمل إعادة الإنتاج كـ skill يُعاد تشغيله بالاسم؛ وعند ورود تقرير خطأ جديد يمكن تهيئة routine مُشغَّل بالأحداث (اختياري)
لماذا Grok Bot وليس الذكاء الاصطناعي على الويب؟
| القدرة | الذكاء الاصطناعي على الويب | Grok Bot |
|---|---|---|
| يقرأ الـ issues وstaging الخاصين بك | ❌ لقطات شاشة ووصف شفهي، والبيئة تعتمد كليًا على نقلك | ✅ اتصال مباشر بنظام تتبع الـ issues عبر الموصلات؛ وتسجيل دخول إلى staging بنفسه عبر متصفح الحاسوب السحابي |
| إعادة إنتاج يدويًا وليس نسخًا من التقرير | ❌ لا يمكنه سوى تخمين السبب من الوصف | ✅ تنفيذ خطوة بخطوة في staging مع لقطات شاشة كأدلة، والخطوات ناتجة عن تشغيل فعلي |
| بيانات الاعتماد لا تُسرَّب | ❌ يجب لصق كلمة المرور في مربع المحادثة | ✅ التعبئة التلقائية عبر Vault لا تُظهر القيمة؛ والخطوات الحساسة عبر Take over تُدخلها أنت يدويًا |
| يتذكر معايير إعادة الإنتاج | ❌ إعادة شرح كل شيء في كل محادثة | ✅ يُحفظ سير عمل إعادة الإنتاج كـ skill، يُعاد تشغيله بالاسم، والمعايير متسقة |
| بدء تلقائي عند ورود خطأ جديد | ❌ لصق كل تقرير يدويًا في كل مرة | ✅ تشغيل routine بالأحداث (GitHub/Linear/Sentry/PagerDuty) |
مأزقك الحالي
- تقارير الأخطاء مكتوبة بشكل غامض: «نقرت ولم يحدث شيء»، فتضطر للسؤال ذهابًا وإيابًا عن البيئة والحساب وخطوات العملية
- إعادة الإنتاج تعتمد على الجهد اليدوي: فتح بيئة اختبار، وإنشاء بيانات اختبار، والنقر خطوة بخطوة، فيضيع بعد ظهر كامل
- جودة حزم إعادة الإنتاج متفاوتة: خطوة مفقودة، أو لقطة شاشة لم تُحفظ، أو معلومات البيئة نُسيت، فيضطر المطور للسؤال مرة أخرى
متى تستخدم هذه الحيلة
عندما تحتاج إلى:
- تحويل تقرير خطأ غامض ومتشابك إلى حزمة إعادة إنتاج يمكن للمطورين استخدامها مباشرة: خطوات دقيقة، ومتوقع وفعلي، ولقطات شاشة، ومعلومات البيئة
- تشغيل خط الإنتاج «قراءة التقرير → دخول staging → إعادة الإنتاج خطوة بخطوة → كتابة الحزمة»، بحيث تكتفي أنت بمراجعة الحزمة
- عدم المساس ببيانات العملاء في بيئة الإنتاج أثناء إعادة الإنتاج، وعدم دخول بيانات اعتماد الاختبار إلى المحادثة
ولا تريد:
- فتح البيئات وتنفيذ الخطوات وأخذ لقطات الشاشة بنفسك واحدًا تلو الآخر
- لصق كلمة مرور حساب الاختبار للذكاء الاصطناعي
- أن يرد المطور بجملة «لا يمكن إعادة إنتاجه» فتبدأ العملية كلها من جديد
🎒 التحضير قبل البدء
- قراءة 3.2 Skills والتعليم بالإرشاد — الخطوة 5 من هذا الدرس ستحفظ سير عمل إعادة الإنتاج كـ skill، وهذا أيضًا متطلب تمهيدي عام لمعظم صفحات السيناريوهات
- امتلاك Bot يمكن تكليفه بالمهام: إن لم يكن لديك واحد، فاذهب أولًا إلى 1.5 إنشاء أول Bot لك
- بيئة staging يمكنها إعادة إنتاج الأخطاء، بالإضافة إلى حساب اختباري جديد تمامًا (وليس حساب إنتاج)
- صلاحية الوصول إلى نظام تتبع الـ issues (مثل Linear وGitHub — موصل أو نسخة الويب كلاهما يعمل)
- حوالي 12 دقيقة، إضافة إلى جولة ملاحظات بشرية بعد خروج أول حزمة إعادة إنتاج
اتبع خطواتي
الخطوة 1: اكتب مسؤوليات وحدود أخصائي إعادة إنتاج الأخطاء في وصف الـ Bot
لماذا: الخطوة الأولى من المنهجية الرسمية ذات الخطوات الست هي كتابة المسؤوليات والأنظمة المصدر وصيغة المخرجات والحدود الدائمة في وصف الـ Bot — كما يجب تثبيت الخطَّين الأحمرين لهذا الدور (استخدام staging فقط، وعدم المساس ببيانات الإنتاج) هنا بشكل قاطع.
كيف تفعل ذلك: أنشئ Bot جديدًا أو افتح واحدًا موجودًا (في الشريط الجانبي + ← Create a Bot)، واكتب الوصف على النحو التالي:
أنت أخصائي إعادة إنتاج الأخطاء (Bug) لديّ، ومسؤوليتك تحويل تقارير الأخطاء إلى حزم إعادة إنتاج موثوقة.
مصادر البيانات: نظام تتبع الـ issue، وبيئة الـ staging.
صيغة المخرجات: حزمة إعادة إنتاج — خطوات دقيقة، والسلوك المتوقع مقابل السلوك الفعلي، ولقطات شاشة، ومعلومات المتصفح والنظام؛
إذا أمكنك استخلاص حالة اختبار مصغّرة فأرفقها، وما لا يمكن التحقق منه اذكره على حدة.
قيود دائمة: أعد الإنتاج في الـ staging باستخدام حسابات اختبار جديدة فقط؛ لا تستخدم أي بيانات لعملاء الإنتاج؛
الـ issue للقراءة فقط، وحزمة إعادة الإنتاج تُلصق في المحادثة بانتظار مراجعتي.ينبغي أن ترى: الوصف محفوظ في صفحة تفاصيل هذا الـ Bot. كتابة القيود هنا تعني أن كل حزمة إعادة إنتاج لاحقة ستلتزم بالخط الأحمر نفسه.
الخطوة 2: توصيل نظام تتبع الـ issue وبيئة الـ staging
لماذا: الحقائق داخل حزمة إعادة الإنتاج يجب أن تأتي فقط من الأنظمة التي تتصل بها — والاتصالان اللذان تسميهما الوثائق الرسمية لهذا الدور هما: نظام تتبع الـ issue، وبيئة الـ staging.
كيف تفعل ذلك: عالج النظامين كلًّا على حدة، وتفاصيل طريقة التوصيل ذات 5 خطوات موجودة في 2.5 توصيل التطبيقات:
- نظام تتبع الـ issue: ابحث أولًا في Connect apps (المثال في الوثائق الرسمية على تطبيقات يثبّتها الـ Bot نيابةً عنك هو Linear — يمكنك أيضًا أن تقول مباشرة "Add the Linear app")؛ وإذا لم تجد النظام في البحث فدع الـ Bot يسجّل الدخول إلى نسخة الويب عبر متصفح الحاسوب السحابي
- بيئة الـ staging: بيئة الاختبار الخاصة بكم غالبًا لا تملك موصّلًا — دع الـ Bot يفتحها عبر متصفح حاسوبه السحابي، مع تخزين بيانات تسجيل الدخول في Vault، فيملؤها الـ Bot نيابةً عنك دون أن يرى القيم
- الأنظمة التي توفر MCP server يمكن أيضًا أن يضيفها الـ Bot عبر URL
- إذا انقطعت عملية التفويض فانقر Reconnect (على التطبيق) أو Reopen (على بطاقة الاتصال في المحادثة) للعودة إلى صفحة تسجيل الدخول
ينبغي أن ترى: الـ Bot قادر على فتح كلا الجانبين. لاحظ أن Added ≠ تم تسجيل الدخول — عندما يظهر Needs auth أو Disconnected انقر Authenticate لإعادة التفويض؛ وبعد تسجيل الدخول إلى الـ staging مرة واحدة في متصفح الـ Bot تبقى الجلسة قائمة (المتصفح مشترك، فإذا سجّل دخولَه Bot واحد أمكن للبقية استخدامه).
الخطوة 3: بيانات الاختبار تُسلَّم عبر تسليم آمن ولا تدخل المحادثة
لماذا: نص المتطلب الخاص الذي تفرضه الوثائق الرسمية على هذا الدور هو "Provide test credentials through a secure handoff, not chat" — فإذا دخلت بيانات الاعتماد سجلَّ المحادثة صارت تتنقل مع المحادثة أينما ذهبت.
كيف تفعل ذلك: اختر المسار حسب طريقة تسجيل الدخول:
- حساب وكلمة مرور عاديان: خزّن حساب الاختبار في Vault — يستخدم الـ Bot بيانات الدخول المخزنة في الـ Vault للملء نيابةً عنك، فلا تمر القيم عبر المحادثة ولا يراها الـ Bot
- خطوات لا يقدر النموذج عليها مثل SSO ورموز التحقق: سيسلّمك الـ Bot الحاسوب — على البطاقة الموسومة بـ Action needed وهي بطاقة Computer، انقر Take over، وأكمل خطوة تسجيل الدخول بيدك، ثم انقر I'm done ليعاود العمل
- مفاتيح من نوع API key: عندما يطلبها الـ Bot املأها في بطاقة secure secret card، فالحقول مقنّعة والقيم لا تُكتب في المحادثة
النص الرسمي: "Never paste passwords or one-time codes into ordinary chat". وانتبه أيضًا: بصمة الإصبع وFace ID وWindows Hello ومفاتيح passkey المحفوظة على حاسوبك المحمول أو هاتفك غير متاحة على الحاسوب السحابي للـ Bot — عندما يمر الـ staging عبر SSO الخاص بالشركة استخدم Take over مباشرة.
ينبغي أن ترى: اكتمل تسجيل الدخول إلى الـ staging وواصل الـ Bot عمله؛ وافحص سجل المحادثة كاملًا فلن تجد كلمة مرور أو رمز تحقق فيه من البداية إلى النهاية.
💡 هذه هي القيمة الفريدة لـ Grok Bot
أدوات الذكاء الاصطناعي على الويب إما لا تملك بيانات اعتماد تستخدمها، وإما أن تلزمك لصق كلمة المرور في مربع الحوار. أما التسليم الآمن لـ Grok Bot فيجعل بيانات الاعتماد تنتقل من الـ Vault أو من يدك مباشرة إلى الصفحة، دون أن يرى الـ Bot القيمة في أي لحظة — فيمكنك أرشفة حزمة إعادة الإنتاج وإعادة توجيهها إلى المطورين بكل اطمئنان دون قلق من تسرب بيانات الاعتماد مع الحزمة.
الخطوة 4: شغّل أول إعادة إنتاج Bug بالذكاء الاصطناعي باستخدام الـ starter prompt الرسمي
لماذا: الـ starter prompt الرسمي يتوقف عمدًا عند نقطة مراجعة تقتصر على إعادة الإنتاج للقراءة فقط — تحقّق أولًا من جودة حزمة إعادة الإنتاج، ثم تحدّث عن الأتمتة.
كيف تفعل ذلك: أرسل تقرير الخطأ (رابط الـ issue أو نصه الكامل) مع رسالة إلى الـ Bot، ثم أرسل هذه النسخة الصينية من الـ Bug reproduction starter prompt الرسمي:
اقرأ تقرير الخطأ هذا، وأعد إنتاجه في الـ staging باستخدام حساب اختبار جديد.
أعد ما يلي: الخطوات الدقيقة، والسلوك المتوقع والسلوك الفعلي، ولقطات الشاشة، ومعلومات المتصفح والنظام،
وأرفق إن أمكن حالة اختبار مصغّرة واحدة. لا تستخدم بيانات لعملاء الإنتاج.ينبغي أن ترى: ينفّذ الـ Bot الخطوات واحدة تلو الأخرى في معاينة الحاسوب على الجانب الأيمن — افتح المعاينة لترى نقراته وكتاباته وتنقله. وفي النهاية يعيد إليك حزمة إعادة إنتاج، تُرفق فيها لقطات الشاشة والملفات كبطاقات في الرد يمكن فتحها للمعاينة. وتتضمن حزمة إعادة إنتاج مقبولة:
- خطوات دقيقة (مرقّمة خطوة بخطوة، يستطيع غيرك اتباعها وتشغيلها بنجاح)
- السلوك المتوقع والسلوك الفعلي (مكتوبان منفصلين)
- لقطات شاشة (تُظهر الحالة ذات الصلة)
- معلومات المتصفح والنظام
- حالة اختبار مصغّرة (الوثيقة الرسمية تقول if possible — أرفقها إن أمكنك استخلاصها)
- المحتوى الذي لا يمكن التحقق منه (متطلب الوثيقة الرسمية بقائمة الأدلة: يُذكر صراحةً ولا يُختلق)
الخطوة 5: عدّل حزمة إعادة الإنتاج حتى تصبح قابلة للمراجعة، واحفظها كـ skill باسم "bug 复现"
لماذا: المنهجية الرسمية ذات الخطوات الست تتطلب تعديل النتائج حتى تصبح "قابلة للمراجعة دون أن تراقبها"، ثم حفظ سير العمل كـ skill، واختباره بمدخل ثانٍ.
كيف تفعل ذلك: راجع مخرجات الـ Bot بندًا بندًا — هل الخطوات دقيقة؟ هل المتوقع منفصل عن الفعلي؟ هل لقطات الشاشة تُظهر الحالة ذات الصلة؟ هل ذُكر ما لا يمكن التحقق منه؟ إن لم تكن مطابقة أعدها للتصحيح، وبعد أن تصبح قابلة للمراجعة ثبّت سير العمل:
احفظ سير العمل الكامل لإعادة إنتاج الخطأ الذي أجريته للتو كـ skill باسم "bug 复现".
يشمل ذلك: الأنظمة المصدر (تتبع الـ issue + الـ staging)، وخطوات إعادة الإنتاج، وصيغة المخرجات (بنود حزمة إعادة الإنتاج الستة)،
بالإضافة إلى القاعدتين: "عدم استخدام بيانات عملاء الإنتاج، ومرور بيانات الاعتماد عبر التسليم الآمن فقط".تقول الوثيقة الرسمية إن الـ skill المفيد يجب أن يوضّح ستة أمور: متى يُستخدم، وما المدخلات والصلاحيات التي يحتاجها، وترتيب العمل، وكيفية التحقق من النتائج، وماذا يُعيد، وما الذي يحتاج إلى موافقة. بعد حفظه اطلبه بالاسم في أي محادثة — قول "تشغيل bug 复现 skill" مباشرةً يكفي لاستدعائه (@ مخصص للـ Bots والمجموعات والـ routines والتطبيقات، ولا يستدعي المهارات).
ينبغي أن ترى: يؤكد الـ Bot حفظ الـ skill. وتطلب الوثيقة الرسمية اختباره بمدخل ثانٍ: شغّله بتقرير خطأ آخر وتحقق من أن حزمة إعادة الإنتاج ما زالت مستقرة. مكتبة الـ skills الخاصة مشتركة بين جميع الـ Bots، وتفاصيل الحفظ في 3.2 الـ Skills والتعلّم بالمثال.
الخطوة 6: حدّد معالجة الإخفاق أولًا، ثم أنشئ routine مُطلقة بأحداث الـ issue
لماذا: الخطوة الخامسة من المنهجية الرسمية ذات الخطوات الست: لا تنشئ الـ routine إلا بعد تحديد سيناريوهات إعادة المحاولة والإخفاق. والـ routine في هذا السيناريو لا تحتاج إلى جدولة زمنية — تدعم الوثيقة الرسمية الإطلاق بالأحداث: رسائل Slack، وGitHub، وLinear، وأحداث Sentry وPagerDuty، والبريد الإلكتروني، وwebhook.
كيف تفعل ذلك: أرسل ما يلي:
عندما يظهر تقرير bug جديد في نظام تتبع المشكلات (حدث GitHub/Linear)،
شغّل مهارة "bug 复现"، والصق حزمة إعادة الإنتاج في هذه المحادثة.
إذا كان staging غير متاح أو تعذّر تسجيل الدخول، أبلغ عن الفشل ولا تستبدله ببيئة الإنتاج.بعد الإرسال، راجع مع الـ Bot البنود الستة في قائمة التأكيد الرسمية: أي Bot يتبع له الأمر، الوقت والمنطقة الزمنية، مصدر الإدخال، النتيجة المتوقعة، حدود الموافقة، وماذا نفعل عند نقص البيانات — إذا لم يتطابق شيء، صحّحه.
ينبغي أن ترى: ظهور الـ routine في قائمة routines الخاصة بهذا الـ Bot. لا يعمل الـ routine الجديد فورًا، بل ينتظر المشغّل التالي — وإذا أردت التحقق فورًا فاستخدم Test. يعمل الـ routine في السحابة ويستمر حتى مع إغلاق الحاسوب؛ وكل عملية run تستهلك من الاستخدام.
خط الموافقة يُحفظ في هذه الخطوة أيضًا: لصق حزمة إعادة الإنتاج في الـ issue وتغيير حالة الـ issue أفعال خارجية — تُترك بعد الموافقة. بطاقة الموافقة التي يشغّلها الـ routine تنتهي صلاحيتها إذا لم يعالجها أحد خلال 30 دقيقة، لذا اجعل الـ routine يلصق في المحادثة فقط ولا تضبط أفعالًا تتطلب موافقة. لتفاصيل قواعد الموافقة انظر 3.1 الموافقة وAuto Review.
📋 الـ Prompt السحري
📝 حزمة إعادة إنتاج الـ bug (نسخة بهيكل الـ starter prompt الرسمي)
النتيجة المتوقعة: يرد الـ Bot بحزمة إعادة إنتاج كاملة — الخطوات نفّذها بنفسه فعليًا، والنتائج المتوقعة والفعلية منفصلة، والأدلة مكتملة، بحيث يستطيع المطور استخدامها مباشرة.
## الدور
أنت أخصائي إعادة إنتاج الأخطاء (Bug) لديّ، ومسؤوليتك تحويل تقارير الأخطاء إلى حزم إعادة إنتاج موثوقة.
## المهمة
اقرأ تقرير الـ bug هذا، وأعد إنتاجه في staging بحساب اختباري جديد تمامًا، وأنتج حزمة إعادة إنتاج.
## معلومات الإدخال
### الحقول المطلوبة
- تقرير الـ bug: 【رابط الـ issue أو نص التقرير كاملًا】
- مدخل staging: 【عنوان بيئة staging وطريقة تسجيل الدخول】
### حقول اختيارية
- نطاق الاشتباه الرئيسي: 【الوظائف التي تُفحص أولًا أو التغييرات الأخيرة؟】
- الفروقات البيئية المعروفة: 【الفروقات المعروفة بين staging والإنتاج؟】
## مواصفات الإخراج
حزمة إعادة الإنتاج: خطوات دقيقة (مرقّمة خطوة بخطوة)، السلوك المتوقع، السلوك الفعلي، لقطات الشاشة، معلومات المتصفح والنظام،
وأصغر حالة اختبار ممكنة (إن أمكن استخلاصها)؛ إضافة إلى قائمة «المحتوى الذي يتعذر التحقق منه».
## القيود
- ✅ يجب أن تكون الخطوات قد نفّذتها بنفسك، مرقّمة خطوة بخطوة
- ✅ اكتب السلوك المتوقع والفعلي بشكل منفصل، وميّز الحقائق عن الاستنتاجات
- ❌ عدم استخدام أي بيانات لعملاء الإنتاج
- ❌ عدم تغيير حالة الـ issue وعدم لصق تعليقات في الـ issue (لصقها في الـ issue يتم بموافقتي)📝 تقرير تعذر إعادة الإنتاج (حتى الفشل في الإعادة يجب أن يُنتج شيئًا)
النتيجة المتوقعة: عند تعذر إعادة الإنتاج، تحصل على تقرير «تعذر إعادة الإنتاج» منظم البنية — ما الذي جُرّب، وأين تعثّر، وأين يختلف عن التقرير — بدلًا من عبارة «تعذر إعادة الإنتاج» فقط.
## الدور
أنت مختص إعادة إنتاج الـ bugs لدي، وقد فشلت للتو في إعادة إنتاج تقرير الـ bug هذا.
## المهمة
أنتج تقرير تعذر إعادة إنتاج، يساعد على تحديد ما إذا كان الأمر فرقًا بيئيًا، أم خطوة ناقصة، أم خطأ في التقرير.
## معلومات الإدخال
### الحقول المطلوبة
- تقرير الـ bug: 【رابط الـ issue الأصلي】
- الخطوات التي جُرّبت: 【أعد سرد كل خطوة نفّذتها فعليًا ونتيجتها الفعلية】
### حقول اختيارية
- بيئة المُبلِّغ: 【المتصفح/النظام/نوع الحساب المذكورة في التقرير؟】
## مواصفات الإخراج
تقرير تعذر إعادة الإنتاج: الخطوات الكاملة المنفَّذة فعليًا، معلومات بيئة staging، نقاط الاختلاف عن وصف التقرير،
وأكثر التفسيرات احتمالًا (مع تمييز أيها حقائق وأيها استنتاجات).
## القيود
- ✅ ميّز الحقائق عن الاستنتاجات
- ✅ اذكر بوضوح الأجزاء التي يتعذر التحقق منها
- ❌ عدم اختلاق نتائج لتحقيق «إعادة إنتاج ناجحة»
- ❌ عدم استخدام بيانات عملاء الإنتاج🔧 ملاحظات جودة حزمة إعادة الإنتاج (اكتب المعايير في الـ skill)
النتيجة المتوقعة: تشير إلى ما ينقص حزمة إعادة الإنتاج هذه، فيكتب الـ Bot المتطلبات في مهارة «إعادة إنتاج الـ bug»، فتكون الحزمة التالية أكثر متانة بوضوح.
## الدور
أنت مختص إعادة إنتاج الـ bugs لدي، وقد سلّمت للتو حزمة إعادة إنتاج.
## المهمة
بناءً على ملاحظاتي، حدّث معايير إعادة الإنتاج في مهارة «إعادة إنتاج الـ bug».
## معلومات الإدخال
### الحقول المطلوبة
- مشكلات هذه الحزمة: 【لقطات شاشة ناقصة / خطوات متجاوزة / معلومات بيئية غير مكتملة / عدم فصل المتوقع عن الفعلي……】
- المعايير الصحيحة: 【ما تريد أن تحققه كل حزمة إعادة إنتاج مستقبلًا】
### حقول اختيارية
- متطلبات إضافية لأنواع معينة: 【مثلًا bugs الدفع يجب أن تتضمن الطابع الزمني والمنطقة الزمنية؟】
## مواصفات الإخراج
أعد أولًا سرد المعايير الجديدة التي استخلصتها، وبعد تأكيدي حدّث الـ skill.
## القيود
- ✅ تُكتب المعايير في الـ skill وتسري بدءًا من إعادة الإنتاج التالية
- ✅ تُستكمل المعايير فقط دون تغيير حدود الموافقة
- ❌ عدم حذف عناصر الأدلة توفيرًا للجهدنقاط التحقق ✅
- يستطيع الـ Bot فتح نظام تتبع المشكلات وBot الـ staging معًا: يعرض الموصل Installed (وليس Needs auth / Disconnected)، وصفحة staging تبقى مسجّل الدخول إليها
- حزمة إعادة الإنتاج الأولى مكتملة: خطوات دقيقة، السلوك المتوقع والفعلي، لقطات الشاشة، معلومات المتصفح والنظام، أصغر حالة اختبار (اختياري)، قائمة المحتوى الذي يتعذر التحقق منه
- لا يُعثر في سجل المحادثة على كلمة مرور الحساب الاختباري أو رمز التحقق — تسجيل الدخول يتم عبر التعبئة التلقائية من Vault أو التسليم الآمن Take over
- عملية إعادة الإنتاج محفوظة كـ skill، ويمكن إعادة تشغيلها بالاسم مع تقرير bug آخر
- لم تُلمس بيانات عملاء الإنتاج في أي مرحلة؛ الـ routine يلصق حزمة إعادة الإنتاج فقط، ولصقها في الـ issue يبقى بعد الموافقة
تنبيهات للمزالق
❌ لصق كلمة مرور الحساب الاختباري مباشرة في المحادثة
تطلب الوثائق الرسمية صراحةً أن تمر بيانات اعتماد الاختبار عبر تسليم آمن، والنص الحرفي: «Never paste passwords or one-time codes into ordinary chat». الطريقة الصحيحة: خزّن الحساب الاختباري في Vault ليملأه الـ Bot تلقائيًا؛ وعند مواجهة SSO أو رمز تحقق، على البطاقة الموسومة بـ Action needed وهي بطاقة Computer، انقر Take over وأدخله بنفسك، ثم انقر I'm done.
❌ ترك الـ Bot «بالمناسبة» يعيد الإنتاج في بيئة الإنتاج
النص الحرفي لحدود الـ starter prompt الرسمي: «Do not use production customer data». حزمة إعادة الإنتاج تُؤرشف وتُحال إلى المطورين — وبمجرد دخول بيانات الإنتاج في الحزمة، تنتقل معها إلى كل مكان. إضافة حساب اختباري جديد كليًا في staging هو متطلب رسمي؛ وإذا كان staging غير متاح فدع الـ Bot يبلغ عن الفشل، ولا تستبدله بالإنتاج.
❌ الـ Bot يقول «أعدت الإنتاج» بينما الخطوات منسوخة من تقرير الـ bug
قيمة حزمة إعادة الإنتاج في أن الخطوات نفّذها الـ Bot بنفسه فعليًا. طريقة الفحص: كل خطوة مصحوبة بلقطة شاشة أو نتيجة فعلية، والسلوك المتوقع والفعلي مكتوبان بشكل منفصل، مع إرفاق قائمة «المحتوى الذي يتعذر التحقق منه». حزمة إعادة الإنتاج التي نُفّذت كل خطواتها فعليًا يمكن للمطور استخدامها مباشرة لتحديد المشكلة؛ أما «حزمة إعادة الإنتاج» المنسوخة من التقرير فهي مجرد تقرير bug بصيغة مختلفة.
❌ الـ passkey / البصمة على الحاسوب المحمول لا تعمل على حاسوب الـ Bot
صفحة استكشاف الأخطاء الرسمية توضح: أن Fingerprint وFace ID وWindows Hello وpasskey المحفوظة على حاسوبك المحمول أو هاتفك غير متاحة على الحاسوب السحابي للـ Bot. عند مرور staging عبر SSO الخاص بالشركة، على بطاقة Computer انقر مباشرةً Take over، وسجّل الدخول بالطريقة التي تسمح بها الشركة (كلمة مرور مع رمز تحقق، أو إشعار على الهاتف)، ثم انقر I'm done لإعادة التسليم.
تقنيات متقدمة (اختياري)
- تشغيل تلقائي عند الـ bug الجديد: مصادر المشغّلات بالأحداث المدعومة رسميًا تشمل GitHub وLinear وSentry وPagerDuty — اضبط لمهارة «إعادة إنتاج الـ bug» روتينًا يعتمد على الأحداث، فبمجرد دخول تقرير bug جديد تُنتج حزمة إعادة الإنتاج تلقائيًا بانتظار مراجعتك. انظر 3.3 Routines.
- أرشفة حزمة إعادة الإنتاج كـ Pages: اجعل الـ Bot ينظّم حزمة إعادة الإنتاج في صفحة Pages (التعريف الرسمي: الصفحات القابلة للقراءة مثل التقارير)، ويخزّنها في Library الخاص بالـ Bot — لمراجعة معلومات بيئة bug معين وقتها، أسرع من تقليب سجل المحادثات. انظر 2.2 الملفات والنتائج القابلة للمراجعة.
- تعذر إعادة الإنتاج ناتج أيضًا: تقرير تعذر إعادة الإنتاج المنظم البنية يساعد المُبلِّغ مباشرة على استكمال المعلومات — الفروقات البيئية، والخطوات الناقصة، وأخطاء التقرير تُدرج بشكل منفصل، ثم يُلصق ردًا في الـ issue عبر الموافقة.
- الربط بتحقيق الأداء: إذا أشارت حزمة إعادة الإنتاج إلى مشكلة أداء من نوع «أصبح أبطأ»، فأوِلها إلى الدرس التالي B2 تحقيق الأداء — بالاتصال بأدوات المراقبة لعرض الـ traces، وتحديد نقاط الاختناق بالأدلة.
خلاصة الدرس
- ✅ بوت «أخصائي إعادة إنتاج الأخطاء» + نوعان من مصادر البيانات (تتبع المشكلات، وبيئة staging)، لتحويل تقارير الأخطاء إلى حزم إعادة إنتاج أخطاء بالذكاء الاصطناعي موثوقة
- ✅ البدء بـ prompt البداية الرسمي: حساب اختبار جديد تمامًا يعيد الإنتاج خطوة بخطوة في staging — خطوات دقيقة، والنتيجة المتوقعة مقابل الفعلية، ولقطات شاشة، ومعلومات البيئة، دون المساس ببيانات عملاء بيئة الإنتاج
- ✅ تسليم بيانات الاختبار بشكل آمن: التعبئة التلقائية عبر Vault أو الإدخال اليدوي عبر Take over، ولا تدخل المحادثة إطلاقًا
- ✅ تعديل إلى skill قابل للمراجعة، وتحديد معالجة الفشل قبل إنشاء routine للحوادث؛ ولصق المحتوى مرة أخرى في المشكلة يبقى دائمًا خلف الموافقة
| العنصر الرئيسي | قيمة هذا الدرس |
|---|---|
| دور البوت | Bug reproduction (أخصائي إعادة إنتاج الأخطاء) — تحويل التقارير إلى حزم إعادة إنتاج موثوقة |
| التطبيقات المتصلة | نظام تتبع المشكلات (connector أو تسجيل دخول عبر المتصفح)، وبيئة staging (متصفح الحاسوب السحابي + Vault) |
| prompt البداية | prompt البداية الرسمي لـ Bug reproduction (النسخة الصينية) |
| تسليم بيانات الاعتماد | تسليم آمن: تعبئة تلقائية عبر Vault / Take over (بطاقة Computer ثم Action needed ← I'm done)، دون الدخول في المحادثة |
| skill | 「bug 复现」 (العناصر الستة الرسمية، تُستدعى بالاسم، مشتركة بين جميع البوتات) |
| routine | تشغيل عند حدوث خطأ جديد (اختياري)، يلصق حزمة إعادة الإنتاج فقط، ويُبلغ عن فشل عند عدم توفر staging |
| خط الموافقة | عدم المساس ببيانات الإنتاج؛ لصق المحتوى مرة أخرى في المشكلة / تغيير الحالة يبقى خلف الموافقة؛ لا يُضبط في الـ routine أي إجراء يتطلب موافقة |
استعراض الدرس التالي
الدرس التالي B2 التحقيق في الأداء: عندما تشير حزمة إعادة الإنتاج إلى مشكلة أداء، تُستخدم نفس الخطوات الست مع استبدال مصادر المعلومات بأدوات المراقبة والتحليل وإدارة الحوادث. ستتعلم:
- تحويل «checkout أصبح بطيئًا» إلى تحقيق موجّه مدعوم بالأدلة: عرض لوحات البيانات وtraces، وتحديد النقاط الساخنة ذات أعلى درجة ثقة
- فصل الحقائق عن الفرضيات عند الكتابة، وتقرير قصير مزود بلقطات شاشة وروابط مباشرة
- عدم تعديل التنبيهات أو المساس بإعدادات الإنتاج — التحقيق للقراءة فقط، والتغييرات تبقى خلف الموافقة