كتابة أوامر فعّالة لـ Bob

ما هو الأمر (Prompt)؟

مكوّنات الأمر

ملاحظة
• التعليمة: تُوجّه Bob بالمهمة المطلوبة. تُكتب التعليمة كأمر واضح مثل "لخّص هذه الدالة Python" أو "أنشئ SBOM لهذا الـ API." التعليمات القوية تقلل الغموض وتؤدي إلى نتائج أكثر صلة.
ملاحظة
• الدور: يُحدد لـ Bob دورًا أو شخصية محددة لاعتمادها عند توليد الاستجابة. مثلًا، يمكنك قول "أنت مهندس برمجيات أول ذو خبرة في Python." هذا يساعد Bob على تكييف استجابته لتناسب منظور ذلك الدور.
ملاحظة
• السياق: السياق يوفر خلفية أو تفاصيل إضافية تُشكّل استجابة Bob. قد يتضمن السياق وصفًا للموقف أو النبرة أو الجمهور أو المعلومات الرئيسية التي تريد تضمينها. السياق يساعد Bob على البقاء متوافقًا مع المهمة.
ملاحظة
• مثال: الأمثلة تتضمن مثالًا أو أكثر يوضّح النمط أو التنسيق أو النبرة المطلوبة. تقديم الأمثلة مفيد بشكل خاص عندما تريد المخرجات باتباع أسلوب أو هيكل محدد. الأمثلة تساعد Bob على تفسير ما تعنيه الاستجابة الجيدة.
ملاحظة
• الإشارات: الإشارة هي جزء قصير من النص يُمهّد لنوع الاستجابة التي تريدها. توضع الإشارات في نهاية الأمر عادةً لتوجيه توليد مخرجات Bob في الاتجاه الصحيح.

أفضل ممارسات الأوامر

ملاحظة
• كن محددًا: كلما كان أمرك أكثر تحديدًا، كلما استطاع Bob فهم ما تريده بشكل أفضل. بدلًا من السؤال "كيف أكتب دالة Python؟"، اسأل "كيف أكتب دالة Python تأخذ قائمة أرقام وترجع متوسطها؟"
ملاحظة
• وفّر السياق: إذا كان أمرك يتعلق بمشروع أو قاعدة كود محددة، وفّر بعض السياق عنها. هذا يساعد Bob على توليد استجابة ذات صلة بوضعك. استخدم @ context mentions في Bob للإشارة إلى ملفات محددة.
ملاحظة
• قسّم المهام: كما تفعل عند تحسين مهمة في قائمة أعمالك المتراكمة، قسّم المهام المعقدة إلى خطوات أصغر وأكثر قابلية للإدارة. هذا يمكن أن يساعد Bob على توليد ردود أكثر دقة وتركيزًا.
ملاحظة
• أضف أمثلة: إذا كنت تضيف API جديدًا، وجّه Bob لمراجعة الـ APIs المكتوبة بشكل جيد في قاعدة كودك كأمثلة. يمكنك أيضًا تضمين أمثلة في أمرك لإظهار التنسيق أو الأسلوب الذي تريده.

كتابة أمر

Write a Python function that prints the date and time.

from datetime import datetime

def print_datetime():
    now = datetime.now()
    print(now.strftime("%Y-%m-%d %H:%M:%S"))

You are a senior software engineer with expertise in Python 3. Write a Python 3 function that prints the current date and time in UTC format. The function should be well documented and include error handling, modeled after https://realpython.com/ref/best-practices/exception-handling/.

"""
utc_datetime.py — Utility for printing the current UTC date and time.
"""

from datetime import datetime, timezone

def print_utc_datetime() -> None:
    """Print the current date and time in UTC (ISO 8601 format).

    Retrieves the current moment from the system clock, attaches UTC timezone
    info, formats it as an ISO 8601 string, and writes it to stdout.

    Returns:
        None

    Raises:
        OSError: If the system clock cannot be read (e.g., hardware failure or
            OS-level permission restrictions).
        ValueError: If datetime formatting unexpectedly fails (e.g., year out
            of the supported range).

    Example:
        >>> print_utc_datetime()
        Current UTC date and time: 2025-07-15T13:42:00.123456+00:00
    """
    try:
        now_utc: datetime = datetime.now(tz=timezone.utc)
    except OSError as exc:
        # System clock is unavailable or inaccessible.
        raise OSError("Failed to read the system clock.") from exc

    try:
        formatted: str = now_utc.isoformat()
    except ValueError as exc:
        # Extremely unlikely, but guard against out-of-range datetime values.
        raise ValueError(
            f"Failed to format the datetime object: {now_utc!r}"
        ) from exc

    print(f"Current UTC date and time: {formatted}")


if __name__ == "__main__":
    print_utc_datetime()

IBM SkillsBuild