العودة إلى الدراسات

بحث في هندسة البرمجيات والذكاء الاصطناعي

كيف تبني مسار برمجة بالذكاء الاصطناعي يمكن الوثوق به؟

يمكن للوكيل أن يكتب بسرعة، لكن السرعة وحدها لا تعطيك نتيجة يمكن اعتمادها. الثقة تبدأ من حدود واضحة ودليل لا يكتبه المنفذ لنفسه.

ما الذي يغطيه البحث؟

في نهاية الدليل ستستطيع اختيار مستوى تشغيل مناسب لمهمة واحدة، وكتابة عقدها، وتحديد بوابات التحقق التي تسبق الاعتماد.

فريق STSراجعه مراجعة تحريرية وتقنية٢٤ دقيقة قراءة

مهندس برمجيات سعودي يراجع فرق الشيفرة ونتائج الاختبارات مع زميل قبل اعتماد التغيير.
المسار الجيد لا يترك المهمة مفتوحة. يحدد أين يبدأ التنفيذ، وما الذي يحق له تغييره، ومتى يتوقف للمراجعة.

من المهمة إلى قرار الاعتماد

  1. المهمة

    تحدد ما يلزمإلى السياق

  2. السياق

    يقيد العملإلى التنفيذ

  3. التنفيذ

    ينتج أثرًا للفحصإلى التحقق

  4. التحقق

    يرفع الدليلإلى القرار

  5. القرار

    يعيد درسًا مثبتًاإلى السياق

المشكلة ليست في سرعة الكتابة

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

المشكلة

عندما تنجح المحاولة الأولى وتفشل الثانية

تحليل

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

هذا النوع من الفشل لا يُحل عادةً بمطالبة أطول. المطلوب أن يعرف الوكيل أين يجد تعليمات المشروع، وما الملفات التي يحق له لمسها، وما حالات القبول، ومن يفحص النتيجة. تجارب OpenAI المنشورة عن هندسة بيئة الوكلاء تركز على جعل المستودع قابلًا للملاحة، وتقسيم العمل، وتجهيز أدوات واختبارات تعطي الوكيل تغذية راجعة واضحة. هذه ممارسة مفيدة، لكنها ليست وعدًا بأن كل مهمة ستنجح.

ماذا نعني بمسار يمكن الوثوق به؟

لا نعني أن الوكيل لا يخطئ. نعني أن المهمة محددة، والصلاحيات معلومة، والتغيير معزول، والدليل ظاهر، والتراجع ممكن. إذا أخطأ النظام، نعرف أين أخطأ ولا نحتاج إلى تخمين ما حدث في محادثة طويلة.

المراجع [1][2]

قرار عملي

القاعدة الأولى

قرار

شخّص المهمة قبل اختيار الأداة

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

قبل التنفيذ

المهمة هي وحدة القرار

تحليل

ليس من المفيد أن تقول: فريقنا يعمل بوكلاء مستقلين. قد تسمح للوكيل بتحديث اختبار داخلي، وتمنعه في المنتج نفسه من تغيير صلاحيات المستخدمين. مستوى التشغيل يتبع المهمة وأثر الخطأ، لا اسم الأداة ولا حجم المؤسسة.

إطار NIST لإدارة مخاطر الذكاء الاصطناعي يربط إدارة الخطر بالسياق والأثر والمتابعة المستمرة. الأداة التالية تترجم هذه الفكرة إلى قرار هندسي بسيط. اختر الوصف الأقرب للواقع، ثم راجع الضوابط المقترحة مع صاحب المنتج والمسؤول التقني.

المراجع [5]

أداة تفاعلية

ما مستوى التشغيل المناسب لهذه المهمة؟

قرار

ابدأ بالحالة الأكثر تحفظًا. غيّر الإجابات بحسب المهمة الحالية، لا بحسب ما تتمنى أن تصل إليه لاحقًا.

وضوح المطلوب

هل يستطيع شخص آخر معرفة أن المهمة نجحت من دون الرجوع إلى صاحبها؟

حساسية البيانات

ما نوع البيانات التي يحتاج الوكيل إلى قراءتها أو إرسالها؟

أثر الخطأ

ماذا يحدث إذا خرجت نتيجة خاطئة ولم يلاحظها الفريق فورًا؟

سهولة التراجع

هل جُرّب الرجوع إلى الحالة السابقة؟

وضع التشغيل المقترح

مساعد فقط

يحلل ويقترح، ولا يغيّر النظام أو ينفذ قرارًا مؤثرًا. هذا ليس تراجعًا؛ بل اختيار مناسب لخطر المهمة.

هذا الاقتراح مبني على إجاباتك في هذه الأبعاد، وعددها ٤، وليس ضمانًا للأمان أو الامتثال.

الضوابط التي تبقى مطلوبة

  • لا وصول إلى أسرار الإنتاج
  • لا تعديل أو نشر مباشر
  • مراجعة بشرية لكل اقتراح
  • توضيح ما هو مؤكد وما هو افتراض

المراجع [5]

اكتب عقد التشغيل

ستة حقول قصيرة تمنع المهمة من التحول إلى طلب مفتوح.

الأداة الأساسية

المطالبة تطلب؛ العقد يضبط

تطبيق

عقد التشغيل ليس وثيقة قانونية، ولا يحتاج إلى عشر صفحات. هو وصف قصير يربط النتيجة بالحدود والدليل. اكتبه قبل أن يبدأ الوكيل، واحفظه مع المهمة حتى يستطيع المراجع فهم ما كان مطلوبًا فعلًا.

الحقول الستة

  1. النتيجة: ما الذي سيتغير للمستخدم أو للفريق؟
  2. النطاق: ما الملفات أو الخدمات الداخلة، وما المستبعد صراحةً؟
  3. المدخلات: ما البيانات والسياق المسموح باستخدامهما؟
  4. الصلاحيات: ماذا يقرأ الوكيل ويكتب ويشغّل وينشر؟
  5. القبول: ما الأدلة التي تثبت السلوك المطلوب وحالات الفشل؟
  6. التوقف والتراجع: متى يتوقف، وكيف نعود إلى الحالة السابقة؟

مثال لمهمة عربية صغيرة

النتيجة: تحسين البحث عن أسماء الخدمات عند اختلاف أشكال الهمزة
النطاق:
  مسموح: lib/search.ts وملف اختبارات البحث
  مستبعد: الصلاحيات وقاعدة البيانات وواجهة النشر
المدخلات: قائمة مصطنعة من أسماء الخدمات
الصلاحيات: قراءة المستودع وكتابة الملفين المحددين وتشغيل الاختبارات
القبول:
  - تنجح أمثلة أ، إ، آ وفق سياسة التطبيع المكتوبة
  - لا تتغير الكلمة الأصلية المخزنة
  - تبقى صلاحيات النتائج كما هي
التوقف: أي تعديل خارج الملفين أو فشل في اختبار الصلاحيات
التراجع: حذف الفرع المعزول والعودة إلى الإصدار السابق
هذا المثال نقطة بداية. عدّل الحقول بحسب أثر المهمة وبياناتها.

بالمناسبة، عبارة مثل «حسّن البحث العربي» ليست عقدًا. قد تعني التطبيع، أو الاشتقاق، أو اللهجات، أو ترتيب النتائج. إذا لم تحدد المقصود، سيملأ الوكيل الفراغ بافتراضاته.

المراجع [2]

أعطِ الوكيل السياق الذي يحتاجه فقط

السياق الجيد مرتب وقريب من القرار. ليس مجلدًا يمتلئ بكل ما تعرفه المؤسسة.

السياق

أربع طبقات بدل ملف ضخم

تحليل

كل معلومة إضافية تنافس غيرها على انتباه الوكيل. لهذا نرتب السياق من الأثبت إلى الأقرب للمهمة: قواعد المؤسسة، وعقود المشروع، وعقد المهمة، ثم حالة التنفيذ الحالية. إذا تعارضت طبقتان، يجب أن يعرف الفريق أيهما أعلى سلطة.

اجعل ملف التعليمات في الجذر خريطة قصيرة: أين توجد بنية المشروع، وأوامر التحقق، وسياسة البيانات، وقرارات التصميم. التفاصيل تعيش قرب الملفات التي تخصها. هذا يجعل التحديث أسهل، ويقلل احتمال استمرار تعليمات قديمة داخل دليل طويل.

المراجع [1][2]

صورة مفاهيمية

طبقات السياق الأربع

تحليل
أربع طبقات مادية مرتبة تمثل سياق المؤسسة والمشروع والمهمة واللحظة الحالية.
كلما اقتربنا من التنفيذ صار السياق أكثر تحديدًا وأقصر عمرًا. لا تنتقل القرارات المؤقتة إلى الذاكرة الدائمة إلا بعد مراجعتها.، توليد أصلي للمقال

خريطة المسؤولية

من يملك كل طبقة؟

تطبيق
من يملك كل طبقة؟لا يكفي أن توجد الملفات. يجب أن نعرف من يحدثها، ومن يراجع تعارضها، وما الذي يصل إلى الوكيل في كل مهمة.قواعد المؤسسةعقود المشروععقد المهمةحالة التنفيذمالك القرارالمراجعالوكيل
لا يكفي أن توجد الملفات. يجب أن نعرف من يحدثها، ومن يراجع تعارضها، وما الذي يصل إلى الوكيل في كل مهمة.
قواعد المؤسسة
البيانات والأمن والشراء
عقود المشروع
البنية والأوامر والواجهات
عقد المهمة
النتيجة والنطاق والقبول
حالة التنفيذ
الخطوة الحالية والدليل
مالك القرار
يحدث القواعد والعقود
المراجع
يفحص التعارض والنتيجة
الوكيل
يقرأ القدر اللازم للمهمة
  • قواعد المؤسسة تقيد عقود المشروع
  • عقود المشروع توجه عقد المهمة
  • عقد المهمة تحدد حالة التنفيذ
  • مالك القرار يمتلك قواعد المؤسسة
  • مالك القرار يعتمد عقود المشروع
  • المراجع يراجع عقد المهمة
  • حالة التنفيذ يغذي الوكيل
العلاقات في الخريطة نصيًا
  • قواعد المؤسسة تقيد عقود المشروع
  • عقود المشروع توجه عقد المهمة
  • عقد المهمة تحدد حالة التنفيذ
  • مالك القرار يمتلك قواعد المؤسسة
  • مالك القرار يعتمد عقود المشروع
  • المراجع يراجع عقد المهمة
  • حالة التنفيذ يغذي الوكيل

اجعل كل خطوة قابلة للملاحظة

المراجع يحتاج أثرًا واضحًا: ماذا قرأ الوكيل، وماذا غيّر، وما الذي نجح أو فشل؟

رحلة العمل

مسار التنفيذ من البداية إلى الاعتماد

تطبيق
  1. ثبّت العقد

    راجع النتيجة والنطاق والصلاحيات وحالات القبول قبل كتابة الشيفرة.

    المخرج: مهمة قابلة للفحص

  2. راجع الخطة

    اعرف الملفات والعقود التي ستتغير، والأوامر التي ستعمل، وطريق التراجع.

    المخرج: خطة معتمدة

  3. اعزل التنفيذ

    استخدم فرعًا أو مساحة عمل أو بيئة مؤقتة لا تمس النسخة المعتمدة.

    المخرج: أثر منفصل

  4. نفّذ أصغر تغيير

    لا توسع النطاق أثناء التنفيذ. أي احتياج جديد يعود إلى صاحب المهمة.

    المخرج: فرق برمجي محدود

  5. اجمع الدليل

    شغّل فحص الأنواع والاختبارات والبناء والفحص السلوكي أو البصري المناسب.

    المخرج: سجل نجاح وفشل

  6. راجع خارج دور البنّاء

    افحص حالات لم يعتمد عليها التنفيذ، وتأكد أن التغيير لم يتجاوز العقد.

    المخرج: قرار مراجعة

  7. اعتمد أو ارفض

    انشر عبر بوابة معروفة، أو ارفض مع سبب يمكن تحويله إلى تحسين محدد.

    المخرج: قرار قابل للتتبع

  8. احفظ الدرس المفيد

    انقل القرار المستقر فقط إلى تعليمات المشروع، ولا تحفظ تفاصيل المحادثة كلها.

    المخرج: سياق أفضل للمرة التالية

المراجع [1][4]

الأثر

ما الذي نسجله فعلًا؟

تطبيق

لا تحتاج في البداية إلى منصة مراقبة كبيرة. سجل معرّف المهمة، والإصدار، والملفات المتغيرة، والأوامر المنفذة، ونتائج الاختبارات، وقرار المراجع. إذا كانت الأداة قد تطبع أسرارًا أو بيانات شخصية في السجل، عالج ذلك قبل حفظ السجلات أو مشاركتها.

لو فشل البناء بعد ثلاثة أيام، يجب أن يستطيع شخص لم يحضر المحادثة معرفة أي خطوة فشلت، وما آخر أثر صالح، وكيف يعيد التشغيل. هذه هي فائدة المسار المرئي: يقل الاعتماد على ذاكرة شخص واحد.

افصل من يبني عمن يعتمد

الفصل الحقيقي يكون في الصلاحيات والملكية، لا في تسمية وكيلين داخل المحادثة نفسها.

الصلاحيات

مراجع بلا سلطة مستقلة ليس بوابة

تحليل

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

توثيق GitHub يقترح استخدام CODEOWNERS وقواعد الفروع لحماية ملفات إعداد الوكيل والاتصالات الخارجية، مع ضبط الأسرار والمتغيرات. الأسماء تختلف إذا استخدمت منصة أخرى، لكن المبدأ واحد: لا تمنح المنفذ مفتاح البوابة التي ستفحصه.

المراجع [3][4]

من يفعل ماذا؟

توزيع المسؤوليات

قرار
هذا توزيع مبدئي لفريق صغير. في العمل الفردي، افصل الأدوار زمنيًا واستخدم قواعد آلية لا تتغير مع المهمة.
المعيارالبنّاءالمتحققموصى بهمالك القرار
الخطةيقترحها بالتفصيليفحص قابليتها للاختباريعتمدها إذا تغير النطاق أو الخطر
التنفيذيغير الملفات المسموحةلا يعيد كتابة الحل أثناء الحكملا يتدخل إلا عند التصعيد
الدليليرفق الفحوص المعلنةيشغل حالات مستقلة ويفحص الفرقيحدد ما يكفي للاعتماد
النشرلا ينشر مباشرةيرفع حكمًا واضحًايمتلك بوابة القرار الحساس
تغيير قواعد الحمايةيطلب ولا يغيريوضح أثر التغييريعتمد مع مراجعة مناسبة

هذا توزيع مبدئي لفريق صغير. في العمل الفردي، افصل الأدوار زمنيًا واستخدم قواعد آلية لا تتغير مع المهمة.

الخطة

البنّاء
يقترحها بالتفصيل
المتحققموصى به
يفحص قابليتها للاختبار
مالك القرار
يعتمدها إذا تغير النطاق أو الخطر

التنفيذ

البنّاء
يغير الملفات المسموحة
المتحققموصى به
لا يعيد كتابة الحل أثناء الحكم
مالك القرار
لا يتدخل إلا عند التصعيد

الدليل

البنّاء
يرفق الفحوص المعلنة
المتحققموصى به
يشغل حالات مستقلة ويفحص الفرق
مالك القرار
يحدد ما يكفي للاعتماد

النشر

البنّاء
لا ينشر مباشرة
المتحققموصى به
يرفع حكمًا واضحًا
مالك القرار
يمتلك بوابة القرار الحساس

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

البنّاء
يطلب ولا يغير
المتحققموصى به
يوضح أثر التغيير
مالك القرار
يعتمد مع مراجعة مناسبة

حد تقني

اختبار بسيط للفصل

قرار

ما الذي يتغير عندما يكون المنتج عربيًا؟

العربية ليست ترجمة الواجهة. هي بيانات وسلوك واتجاه كتابة ومصطلحات وحالات تقييم محلية.

السياق العربي

اختبر اللغة داخل المهمة نفسها

تحليل

إذا كان المنتج عربيًا، لا يكفي أن تنجح الحالات الإنجليزية ثم نترجم النصوص. العربية تتغير بحسب المجال واللهجة وطريقة الكتابة. وقد يجمع المستخدم العربية والإنجليزية والأرقام في سطر واحد. لذلك يجب أن تأتي أمثلة التقييم من الاستخدام المتوقع، لا من قائمة عامة فقط.

توضح HELM Arabic وورقة ORCA أن تقييم العربية يحتاج إلى مهام وبيانات متنوعة. فائدتهما هنا ليست نقل نتيجة نموذج إلى منتجك، بل تذكيرك بأن «العربية» ليست حالة اختبار واحدة. ابنِ مجموعة صغيرة تمثل جمهورك، ثم راجعها مع مختص لغوي وصاحب المجال.

المراجع [8][9][10]

صورة مفاهيمية

عدسة التحقق العربية

تحليل
مهندسة جودة سعودية تختبر واجهة عربية من اليمين إلى اليسار على شاشة وجهاز لوحي وهاتف.
تمر التجربة عبر اللغة، والاتجاه، والسياق المحلي، والإتاحة. بعدها يصل الدليل إلى مراجع بشري يقرر إن كان السلوك مناسبًا.، توليد أصلي للمقال

قائمة عملية

أربع مجموعات اختبار لا تؤجلها

تطبيق
  1. اللغة والمصطلح

    اختبر الفصحى الحديثة وصيغ المستخدمين الفعلية واللهجة عند الحاجة، والنص المشكول وغير المشكول، والمصطلحات المعتمدة في الجهة.

  2. الاتجاه والنص المختلط

    اختبر العربية مع البريد الإلكتروني ورقم الطلب واسم المنتج الإنجليزي، والنسخ واللصق، وترتيب الأعمدة، وموضع علامات الترقيم.

  3. سلوك المهمة

    اختبر حالات النجاح والرفض والالتباس، ولا تكتفِ بجمال الصياغة. في البحث مثلًا، افحص الصلة والصلاحية معًا.

  4. الإتاحة

    اختبر لوحة المفاتيح، وترتيب التركيز، وأسماء الحقول، وقارئ الشاشة، والجداول، والتكبير. مبادئ W3C تساعد في بناء القائمة، لكنها لا تغني عن الاختبار.

المراجع [10][8][9]

تطبيق محلي

مثال سعودي: مساعد يبحث في سياسات داخلية

تطبيق

لنفترض أن جهة سعودية تريد مساعدًا يساعد الموظفين في العثور على سياسات داخلية. قبل ربط المستودع أو مزود النموذج، يصنف الفريق البيانات: ما هو عام، وما هو داخلي، وما قد يحتوي بيانات شخصية؟ ثم يحدد الغرض، والأشخاص المخولين، وما الذي يغادر بيئة الجهة، ومدة حفظ السجلات، وطريقة حذفها.

سياسة مشاركة البيانات ونظام حماية البيانات الشخصية المنشوران عبر سدايا يوفران مرجعًا رسميًا للفريق القانوني والحوكمة عند تحديد هذه الضوابط. هذا الدليل لا يقرر الامتثال. المطلوب هندسيًا هو ألا يبدأ الوكيل بصلاحية قراءة كل شيء، وألا تتحول سجلاته إلى نسخة جديدة من بيانات لم يكن يجب جمعها.

بعدها يكتب الفريق حالات عربية حقيقية: سؤال واضح، وسؤال يستخدم اسمًا دارجًا، وسؤال يجمع العربية ورقم نموذج، ومحاولة للوصول إلى وثيقة لا يملك المستخدم صلاحيتها. النجاح هنا ليس أن تبدو الإجابة مقنعة؛ بل أن تأتي من مصدر مسموح، وتحافظ على الصلاحيات، وتوضح عندما لا تملك جوابًا.

المراجع [6][7]

طبّق النظام بحجم فريقك

الفكرة واحدة، لكن الأدوات تتدرج من ملفات وGit إلى سياسات ومنصات مركزية.

ثلاثة أحجام

لا تبدأ ببنية أكبر من المشكلة

تطبيق

قد يعمل شخص واحد من جهازه، وقد تدير مؤسسة عشرات المستودعات. كلاهما يحتاج عقد مهمة وتحقيقًا مستقلًا نسبيًا، لكنهما لا يحتاجان الأدوات نفسها. ابدأ بأقل بنية تحفظ الحدود والدليل، ثم وسّعها عندما يظهر احتياج متكرر.

مقارنة تطبيقية

ما الحد الأساسي في كل مستوى؟

قرار
العمود الأوسط هو البداية المناسبة غالبًا لفريق منتج صغير. العمل الفردي صالح للتجربة، والمؤسسة تضيف حوكمة عابرة للمشاريع.
المعيارفرد أو تجربةفريق صغيرموصى بهمؤسسة
السياقREADME وتعليمات مشروع قصيرةتعليمات جذرية وعقود قرب المكوناتسياسات مركزية مع استثناءات موثقة للمشاريع
العزلفرع منفصلمساحة عمل ومعاينة لكل تغييربيئات مؤقتة وهويات خدمة محدودة
التحققاختبارات ثم مراجعة مؤجلة زمنيًاتكامل مستمر ومراجع آخربوابات حسب الخطر مع أدلة مركزية
الأسرارلا أسرار إنتاج في المهمةأسرار بيئة محدودة وقابلة للإلغاءخزنة وهوية قصيرة العمر وسياسة وصول
الاعتمادتأكيد يدوي واضحقواعد فرع ومالك مراجعةفصل صلاحيات وسجل قرار ومراقبة بعد النشر

العمود الأوسط هو البداية المناسبة غالبًا لفريق منتج صغير. العمل الفردي صالح للتجربة، والمؤسسة تضيف حوكمة عابرة للمشاريع.

السياق

فرد أو تجربة
README وتعليمات مشروع قصيرة
فريق صغيرموصى به
تعليمات جذرية وعقود قرب المكونات
مؤسسة
سياسات مركزية مع استثناءات موثقة للمشاريع

العزل

فرد أو تجربة
فرع منفصل
فريق صغيرموصى به
مساحة عمل ومعاينة لكل تغيير
مؤسسة
بيئات مؤقتة وهويات خدمة محدودة

التحقق

فرد أو تجربة
اختبارات ثم مراجعة مؤجلة زمنيًا
فريق صغيرموصى به
تكامل مستمر ومراجع آخر
مؤسسة
بوابات حسب الخطر مع أدلة مركزية

الأسرار

فرد أو تجربة
لا أسرار إنتاج في المهمة
فريق صغيرموصى به
أسرار بيئة محدودة وقابلة للإلغاء
مؤسسة
خزنة وهوية قصيرة العمر وسياسة وصول

الاعتماد

فرد أو تجربة
تأكيد يدوي واضح
فريق صغيرموصى به
قواعد فرع ومالك مراجعة
مؤسسة
فصل صلاحيات وسجل قرار ومراقبة بعد النشر

خطة بداية خلال أسبوعين

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

خطة تنفيذ

من الاختيار إلى قرار الاستمرار

تطبيق
  1. اليوم ١: اختر المهمة

    اختر عملًا متكررًا، محدود الأثر، يمكن التراجع عنه، وله صاحب قرار معروف.

    المخرج: مهمة تجريبية واحدة

  2. اليوم ٢: اكتب العقد

    حدد النتيجة والنطاق والبيانات والصلاحيات والقبول والتوقف.

    المخرج: عقد من صفحة واحدة

  3. اليوم ٣: جهز السياق

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

    المخرج: سياق قابل للملاحة

  4. اليوم ٤: اكتب دليل الفشل

    أضف حالة اختبار أو فحصًا سلوكيًا يفشل قبل التغيير.

    المخرج: خط أساس واضح

  5. اليوم ٥: نفذ مرة بإشراف

    راجع الخطة، ثم اسمح بالتنفيذ في مساحة معزولة وسجل الملاحظات.

    المخرج: أول أثر قابل للمراجعة

  6. الأسبوع ٢: كرر ثلاث مرات

    استخدم المهمة نفسها أو مهامًا شديدة الشبه. لا تغير الأدوات والعملية معًا.

    المخرج: نمط يمكن مقارنته

  7. راجع الفشل والتكلفة

    سجل وقت الإعداد والمراجعة والإصلاح، وأنواع الأخطاء التي نجت من البوابات.

    المخرج: قائمة تحسينات مرتبة

  8. اتخذ القرار

    استمر إذا أصبح الدليل أوضح وقل العمل اليدوي من دون توسيع خطر غير مقبول. وإلا أصلح المسار قبل زيادة الصلاحيات.

    المخرج: استمرار أو تعديل أو إيقاف

القياس

لا تخترع نسبة نجاح

قرار

ابدأ من قالب جاهز ثم عدّله

القالب يجمع عقد المهمة والخطة والمراجعة والتحقق والذاكرة في بنية صغيرة.

أثر قابل للاستخدام

ما الذي يوفره القالب؟

تطبيق

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

ابدأ بالمثال الموجود، ثم استبدل بياناته بمهمة من مشروعك. لا تنقل سياسات المثال كما هي؛ حدّث الصلاحيات، وأسماء المالكين، وأوامر الاختبار، وحدود البيانات قبل أي تشغيل فعلي.

تنزيل مباشر

قالب STS لمسار البرمجة بالذكاء الاصطناعي

تطبيق

قالب عربي مستقل من ٢٨ ملفًا لتنظيم السياق والمواصفة والخطة والمراجعة والتحقق والذاكرة. لا يحتوي أسرارًا ولا يحتاج إلى حزمة خارجية.

sts-ai-coding-system-ar-v3.zipZIPالإصدار 3.0.0٣٨٫٣ كيلوبايت

حمّل القالب الأساسي
تفاصيل الملف ومتطلبات التشغيل

SHA-256: 284b6576df840f52da6db6310466a5e2a962254273278e116ab84b78523caf54

المتطلبات

  • Node.js >=20
  • Git اختياري لإدارة النسخ

يتضمن

  • دليل بدء وتعليمات مشروع بالعربية
  • قوالب للمواصفة والخطة والقرار والمراجعة
  • ذاكرة للقرارات والدروس المثبتة
  • مثال بحث عربي مع اختبارات سلوكية
  • أداة تحقق وحزمة قابلة لإعادة الإنتاج
  • رخصة MIT

المنهج والمصادر

افصلنا بين الممارسة المنشورة، والتطبيق المقترح، والحدود التي تحتاج قرارًا محليًا.

المنهج

كيف بُني هذا الدليل؟

تحليل

راجعنا مصادر أولية ورسمية في خمسة محاور: تجهيز بيئة الوكيل، وتعليمات المستودع، وحماية الصلاحيات، وتطوير البرمجيات الآمن، وإدارة مخاطر الذكاء الاصطناعي. وللسياق العربي راجعنا مصادر تقييم العربية، ومبادئ الإتاحة، والمراجع الرسمية السعودية المتعلقة بمشاركة البيانات وحمايتها.

بعد ذلك حولنا المبادئ المشتركة إلى أدوات قابلة للاستخدام: تشخيص للمهمة، وعقد من ستة حقول، وطبقات للسياق، وفصل للصلاحيات، وخطة أسبوعين. هذه الأدوات مقترحات هندسية من STS وليست نصوصًا منقولة، ولا تدعي أنها الصيغة الوحيدة.

حدود مهمة

  • خبرات الشركات المنشورة تصف بيئاتها، وقد لا تنتقل كما هي إلى فريقك.
  • أطر NIST توجه إدارة الخطر ولا تمنح المشروع شهادة امتثال.
  • مراجع سدايا يجب أن يفسرها المختصون المسؤولون عن الحوكمة والقانون في الجهة.
  • معايير العربية العامة لا تغني عن بيانات واختبارات تمثل مستخدمي المنتج الفعليين.
  • لم ننشر أرقام إنتاجية أو دقة لأن هذا الدليل لا يملك تجربة محلية مضبوطة تدعمها.

المراجع [1][2][3][4][5][6][7][8][9][10]

روابط التحقق

المصادر المباشرة

مصدر
  1. Harness engineering: leveraging Codex in an agent-first world

    OpenAI · تم الاطلاع في

    خبرة فريق محدد في جعل المستودع والاختبارات والأدوات مناسبة لعمل الوكلاء؛ لا تُعامل كضمان عام.

  2. How OpenAI uses Codex

    OpenAI · تم الاطلاع في

    يدعم ممارسات تحديد المهمة، وتحسين البيئة، وكتابة تعليمات مستمرة داخل المستودع.

  3. Building guardrails for Copilot coding agent

    GitHub Docs · تم الاطلاع في

    مرجع تطبيقي لحماية ملفات الإعداد وضبط الأسرار وقواعد الفروع في بيئة GitHub.

  4. Secure Software Development Practices for Generative AI and Dual-Use Foundation Models

    NIST · SP 800-218A · تم الاطلاع في

    إطار ممارسات لتطوير برمجيات آمنة في سياق الأنظمة التوليدية، وليس شهادة امتثال للمقال أو القالب.

  5. AI Risk Management Framework

    NIST · تم الاطلاع في

    إطار طوعي عام لإدارة مخاطر الذكاء الاصطناعي ويحتاج إلى تكييف بحسب السياق.

  6. سياسة مشاركة البيانات

    مكتب إدارة البيانات الوطنية · سدايا · تم الاطلاع في

    مرجع رسمي للغرض والأطراف وضوابط المشاركة. لا يستخدم هنا لإعلان امتثال.

  7. نظام حماية البيانات الشخصية ولوائحه

    منصة حوكمة البيانات الوطنية · سدايا · تم الاطلاع في

    مرجع رسمي يحتاج إلى مراجعة قانونية وحوكمية عند التطبيق على حالة فعلية.

  8. HELM Arabic

    Stanford Center for Research on Foundation Models · تم الاطلاع في

    مرجع لتنوع مهام تقييم العربية. لا تنقل نتائجه مباشرة إلى منتج أو نموذج بعينه.

  9. ORCA: A Challenging Benchmark for Arabic Language Understanding

    باحثون من عدة جامعات ومؤسسات · تم الاطلاع في

    ورقة بحثية توضح تنوع مهام ولهجات العربية، ولا تغطي كل مجال أو جمهور.

  10. Accessibility Principles

    W3C Web Accessibility Initiative · تم الاطلاع في

    مبادئ للإدراك والتشغيل والفهم والمتانة، وتبقى بحاجة إلى اختبار فعلي للمنتج.