AI CodeOps

قالب سياسة البرمجة بالذكاء الاصطناعي لفرق الهندسة (مجاني)

Matt · · آخر تحديث · مدة القراءة: ⁨7⁩ دقيقة · الأدلة

قالب مجاني لسياسة البرمجة بالذكاء الاصطناعي: الأقسام الثمانية المهمة، وسبب كل قاعدة، وكيف تفرضها وتعممها. نزّله بصيغة .docx أو .md.

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

لماذا تحتاج إلى سياسة

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

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

الأقسام الثمانية للسياسة

1. الأدوات المعتمدة

القسم 4 من القالب جدول بالأدوات المسموح بها على كود الشركة، وما يجوز استخدام كل منها له، وأكثر البيانات حساسية التي يجوز لكل منها أن يراها. ولا يحظر القالب أي أداة. فكل ما ليس في القائمة غير مسموح به على كود الشركة إلى أن يعتمده أحد. وقائمة المحظورات تتقادم بعد أسبوع من كتابتها؛ أما قائمة المعتمد فتخطئ في الاتجاه الآمن.

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

2. البيانات والأسرار

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

3. متطلبات المراجعة

يقول القسم 7 إن شخصا يراجع كل تغيير بمساعدة الذكاء الاصطناعي، وإن صاحب الطلب ليس الموافق الوحيد حين يستطيع شخص آخر المراجعة، وإن الموافقة تخص إصدارا واحدا: فأي تعديل يعني موافقة جديدة. ومع الوكلاء صارت هذه القاعدة الأخيرة أهم مما كانت، لأن «الإصلاح الصغير» اللاحق قد يكون أكبر مما يبدو. ويشرح دليل الموافقات البشرية المواضع التي يجب أن يبقى فيها شخص في الحلقة. وعلى GitHub، تقابل قواعد المراجعة إعدادات حماية الفروع. ففي قاعدة حماية الفروع الخاصة بالفرع main، فعّل ما يلي:

الإعدادقاعدة السياسة
Require a pull request before merging6.1: لا يدفع الوكلاء أبدا إلى main
Require approvals7.1: يراجع شخص كل تغيير
Dismiss stale pull request approvals when new commits are pushed7.5: الموافقة تخص إصدارا واحدا
Require approval of the most recent reviewable push7.2: يوافق شخص آخر
Require review from Code Owners6.3: المسارات المحمية تحتاج إلى مالكها
Require status checks to pass before merging8: بوابات الجودة
Do not allow bypassing the above settingsالاستثناءات تمر عبر القسم 13

والإعداد الأخير أهم مما يبدو. فمن دونه يتخطى الدمج الذي يجريه المسؤول كل القواعد أعلاه، والمسؤولون هم في الغالب من يعدّون الوكلاء.

4. البوابات

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

وإذا كنت تستخدم AI CodeOps، تفحص بوابة الإصدار معظم القسم 8 باستدعاء واحد من CI، وتفشل الخطوة ما لم تكن الإجابة بالسماح:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"pullRequestURL\": \"$PR_URL\",
    \"blockingSeverity\": \"high\",
    \"minCoveragePct\": 80,
    \"disallowedLicenses\": [\"AGPL-3.0\"],
    \"requireDeployedTo\": \"staging\"
  }" \
  | jq -e '.allowed == true'

كل حقل سطر واحد من القسم 8: فالحقل blockingSeverity هو القاعدة 2، و disallowedLicenses هو القاعدة 4، و minCoveragePct هو القاعدة الاختيارية 5، و requireDeployedTo هو القاعدة 6. والاختبارات الفاشلة تمنع افتراضيا، وهذه هي القاعدة 1. والرقم 80 وقائمة التراخيص أمثلة: استخدم قيمك. أما فحص الأسرار، وهو القاعدة 3، فيبقى خطوة منفصلة في خط الإنتاج لديك.

5. التراخيص

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

6. الأمان

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

ويسرد القسم 6.3 المسارات التي لا يجوز للوكلاء تغييرها دون موافقة مالكيها. وهذا شكل ملف CODEOWNERS المقابل:

# Policy 6.3: paths a coding agent must not change alone.
*                        @your-org/maintainers
/.github/workflows/      @your-org/platform
/infra/                  @your-org/platform
/src/auth/               @your-org/security
/migrations/             @your-org/data
package.json             @your-org/platform
/.github/CODEOWNERS      @your-org/maintainers

الترتيب مهم: تقول وثائق مالكي الكود لدى GitHub إن «آخر نمط مطابق له الأسبقية العليا» (جرى التحقق منها في 24 أكتوبر 2026)، فيأتي النمط الشامل أولا. والسطر الأخير يحمي الملف نفسه، فلا يستطيع طلب سحب إزالة مراجعيه. وفي قالب CODEOWNERS للبدء نسخة أطول مع تعليقات.

وفي AI CodeOps، الحدود نفسها سياسة لمساحة العمل: قواعد تسمح بإجراء، أو تحتجزه حتى موافقة شخص، أو ترفضه. فيصبح القسمان 6.3 و 6.4 كما يلي:

[
  { "id": "policy-6-3-ci", "action": "diff.apply", "resource": ".github/workflows/**", "decision": "ask" },
  { "id": "policy-6-3-infra", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
  { "id": "policy-6-3-migrations", "action": "diff.apply", "resource": "migrations/**", "decision": "ask" },
  { "id": "policy-6-4-no-prod", "action": "release.deploy", "resource": "production", "decision": "deny" }
]

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

7. التدقيق

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

8. الاستثناءات

يقول القسم 13 إن الاستثناء يطلب كتابة، مع السبب والخطر وتاريخ انتهاء (يقترح القالب ألا يتجاوز 90 يوما)، ويسجل ويراجع حين ينتهي. والخيار "Do not allow bypassing the above settings" في حماية الفروع هو ما يجعل هذا القسم حقيقيا: فمن دونه يكون الدمج الذي يجريه المسؤول استثناء غير مسجل.

ما يتركه القالب

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

كيف تعممها

السياسة التي تصل مفاجأة تتجاهل. وهذا الترتيب أنجع:

  1. املأ جدول الأدوات أولا. اذكر ما يستخدمه الناس أصلا، واعتمد ما تستطيع. فالبدء من الواقع يجعل البقية جديرة بالتصديق.
  2. شارك المسودة مع المهندسين الأكثر استخداما للأدوات. فهم يعرفون أي القواعد ستعطل العمل الفعلي، وأيها سيتبعونه عن طيب خاطر.
  3. فعّل الإعدادات في وضع التسجيل فقط أو الوضع الاستشاري حيث تستطيع. انظر إلى ما كان سيمنع. وأصلح القواعد الخاطئة.
  4. انشر السياسة وافرض الإعدادات في اليوم نفسه. المستند يقول لماذا؛ والإعدادات تجعله واقعا.
  5. ضع موعد المراجعة في التقويم. يقول القالب كل ستة أشهر، وكلما اعتمدت نوعا جديدا من الأدوات.

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

نزّل القالب

قالب سياسة البرمجة بالذكاء الاصطناعي مجاني، ومرخص بموجب CC BY 4.0: انسخه وغيّره واستخدمه. ونزّله بصيغة .docx أو .md من الصفحة. واجعل فريق الأمان لديك يقرأ نسختك إلى جانب الفريق القانوني. وهذا قالب للبدء، لا استشارة قانونية.

أهم النقاط

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

الأسئلة الشائعة

ماذا ينبغي أن تتضمن سياسة البرمجة بالذكاء الاصطناعي؟

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

هل ينبغي أن تحظر سياسة البرمجة بالذكاء الاصطناعي أدوات بعينها؟

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

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

لا. إنه قالب للبدء، لا استشارة قانونية. اجعل فريقي الشؤون القانونية والأمان يقرآن نسختك قبل أن تسري.