دليل الدخل بالوكلاءموارد عامة مجانية
中文 EN العربية

انقل مساعد البرمجة من فهم السياق إلى التحقق من التغيير

امنح مساعد البرمجة دالة قابلة للتكرار والسلوك المتوقع والمدخل الفاشل وأمر الاختبار. اطلب فحص الشيفرة والاختبارات قبل التعديل.

تاريخ المراجعة · 2026-10-15 · تحديث المحتوى · 2026-10-15

الإجابة المباشرة

امنح مساعد البرمجة دالة قابلة للتكرار والسلوك المتوقع والمدخل الفاشل وأمر الاختبار. اطلب فحص الشيفرة والاختبارات قبل التعديل. مثال: تنظف normalize(row) الاسم وتحول البريد إلى أحرف صغيرة. يبقى البريد الغائب أو null كما هو؛ وتُطبّع القيمة الموجودة. اختبر الغياب وnull والفراغ والصحيح.

اتخاذ القرار

امنح مساعد البرمجة دالة قابلة للتكرار والسلوك المتوقع والمدخل الفاشل وأمر الاختبار. اطلب فحص الشيفرة والاختبارات قبل التعديل.

مثال تطبيقي

مثال: تنظف normalize(row) الاسم وتحول البريد إلى أحرف صغيرة. يبقى البريد الغائب أو null كما هو؛ وتُطبّع القيمة الموجودة. اختبر الغياب وnull والفراغ والصحيح.

فحوص الإخفاق

شغّل الاختبار والتحقق بنفسك وراجع التغييرات الجانبية. قبل تشغيل الأوامر، اجعل الحالة مخططة؛ فالاقتراح ليس تحققاً.

مثال محلي وسير قبول ناتج الوكيل

قارن إدخال المثال بالناتج وقواعد التحقق.

نص الإدخال

مثال محلي حتمي: راجع هذه الدالة الحالية وفق أربع فئات من الإدخال. السلوك يطابق المطلوب بالفعل ولا يحتاج إلى تعديل.

def normalize(row):
    email = row.get("email")
    return {"name": row["name"].strip(),
            "email": email.strip().lower() if isinstance(email, str) else None}

cases = [
    ({"name": " A "}, None),
    ({"name": " A ", "email": None}, None),
    ({"name": " A ", "email": "   "}, ""),
    ({"name": " A ", "email": " A@EXAMPLE.TEST "}, "a@example.test"),
]
assert [normalize(row)["email"] for row, _ in cases] == [expected for _, expected in cases]

توجيه لواجهة وكيل تستخدمها بالفعل

راجع دالة normalize المعطاة ولا تعدّل الملفات. أعد حقول JSON: decision وbehavior وtest_cases وverification_status. افحص غياب email وnull والمسافات فقط والبريد المختلط الأحرف؛ اذكر «لا حاجة إلى تعديل» إذا كان التنفيذ يطابق السلوك. صنّف الاختبارات غير المنفذة على أنها مخططة ولا تدّع تشغيلها.

الناتج المتوقع

{
  "behavior": "missing/null -> None; blank -> empty string; present -> trimmed lowercase",
  "test_cases": "missing; null; whitespace-only; mixed-case email",
  "verification_status": "planned, not run",
  "decision": "no change needed; supplied implementation matches the stated behavior"
}

قواعد التحقق المحلية

الموارد المختارة

وثائق OpenAI: التحقق من المصادر الرسمية

سبب الاختيار: استخدم MCP لوثائق OpenAI للأدلة وواجهات API، ومسار دليل Codex للأسئلة الخاصة به.

متى لا يناسب: لا يحتاج سلوك Python العام إلى وثائق منتجات OpenAI.

openai/skills · skills/.curated/openai-docs/SKILL.md · 2026-10-14

التصحيح المنهجي: اجمع الأدلة قبل إصلاح السبب

سبب الاختيار: أعد إنتاج المشكلة وتتبع تدفق البيانات وافحص الحدود قبل اختيار الإصلاح.

متى لا يناسب: عندما يكون السلوك واضحاً ولا يوجد عطل مجهول، نفّذ واختبر مباشرة.

obra/superpowers · skills/systematic-debugging/SKILL.md · 2026-10-14

التطوير بالاختبار أولاً: دورة Red-Green-Refactor

سبب الاختيار: اكتب اختبار سلوك فاشلاً أولاً ثم نفذ الحد الأدنى وأعد الهيكلة.

متى لا يناسب: لا يحدد سياسة البريد الفارغ؛ قرر السلوك قبل كتابة الاختبار.

obra/superpowers · skills/test-driven-development/SKILL.md · 2026-10-14

التحقق قبل الإكمال: شغّل الفحوص قبل التقرير

سبب الاختيار: حدد وشغّل الفحص الكامل الذي يدعم ادعاء إصلاح العمل أو اكتماله.

متى لا يناسب: إرشادات التحقق لا تحل محل اختبارات حالات البريد الأربع.

obra/superpowers · skills/verification-before-completion/SKILL.md · 2026-10-14

اختبار تنسيق الوكيل باستخدام نموذج وهمي حتمي

سبب الاختيار: تحقق من توجيه الأدوات والتحويلات ومعالجة المخرجات التي يملكها التطبيق دون استدعاء خدمة نموذج حقيقية.

متى لا يناسب: اختبارات النموذج الوهمي لا تقيس جودة استجابة نموذج حقيقي.

openai/openai-agents-python · docs/testing.md · 2026-10-14

المصادر وتواريخ المراجعة