AI CodeOps

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

آخر تحديث

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

استبدل الفرق @your-org/... بفرق أو مستخدمين حقيقيين لديهم صلاحية الكتابة في المستودع. واحذف المسارات غير الموجودة لديك، وهذه الملاحظة.

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

# CODEOWNERS starter: owners for the paths an AI agent should not change alone.
# Order matters: for each file, the LAST matching line decides its owners.
# Keep the catch-all first and the most specific paths last.

# Everything: the team that owns the repository.
*                               @your-org/maintainers

# Pipelines and automation. A changed workflow can leak secrets or skip checks.
/.github/workflows/             @your-org/platform
/.gitlab-ci.yml                 @your-org/platform
/.forgejo/workflows/            @your-org/platform

# Infrastructure as code and deployment.
/infra/                         @your-org/platform
/deploy/                        @your-org/platform
*.tf                            @your-org/platform
/Dockerfile                     @your-org/platform

# Authentication, sessions and permissions.
/src/auth/                      @your-org/security
/src/**/permissions*            @your-org/security

# Database schema and migrations. An applied migration should never be edited.
/migrations/                    @your-org/data
/src/**/schema/                 @your-org/data

# Dependencies and lockfiles. New packages are supply-chain decisions.
package.json                    @your-org/platform
bun.lock                        @your-org/platform
package-lock.json               @your-org/platform
pnpm-lock.yaml                  @your-org/platform
requirements*.txt               @your-org/platform
pyproject.toml                  @your-org/platform
go.mod                          @your-org/platform
Cargo.toml                      @your-org/platform

# Agent configuration: prompts, rules and tool settings that steer coding agents.
/AGENTS.md                      @your-org/maintainers
/CLAUDE.md                      @your-org/maintainers
/.cursor/                       @your-org/maintainers

# This file. Without an owner, anyone could remove the rules above.
/.github/CODEOWNERS             @your-org/maintainers

كيف تعتمده

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

صيغ ينبغي تجنبها

يتبع ملف CODEOWNERS على GitHub معظم قواعد ملف .gitignore، مع استثناءات توقع الناس في الخطأ:

  • لا يعمل ! لنفي نمط.
  • لا تعمل نطاقات الأحرف [ ].
  • لا يعمل تهريب نمط يبدأ بالرمز # باستخدام \.
  • المسارات حساسة لحالة الأحرف.

يحتاج مالكو الكود في GitLab إلى مستوى Premium أو Ultimate. ويضيف GitLab أقساما، مثل [Database][2] @your-org/data، حيث الرقم هو عدد الموافقات التي يحتاجها القسم. وداخل كل قسم يغلب آخر سطر مطابق. راجع وثائق مالكي الكود في GitHub ووثائق مالكي الكود في GitLab للقواعد كاملة.

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

أين يوضع ملف CODEOWNERS؟

على GitHub، في .github/ أو في جذر المستودع أو في docs/، ويستخدم GitHub أول ملف يجده بهذا الترتيب. وعلى GitLab، في الجذر أو في docs/ أو في .gitlab/، ويفحصها بهذا الترتيب.

هل يمنع ملف CODEOWNERS الدمج بنفسه؟

لا. إنه يطلب المراجعات فقط. ولاشتراط موافقة أحد المالكين، فعّل "Require review from Code Owners" في قاعدة حماية فروع أو مجموعة قواعد على GitHub، أو "Require approval from code owners" على فرع محمي في GitLab.

لماذا يهم ترتيب الأسطر؟

لكل ملف، يغلب آخر نمط مطابق على GitHub، ويغلب آخر تطابق داخل كل قسم على GitLab. فضع السطر الذي يشمل كل شيء أولا، والمسارات الأكثر تحديدا أخيرا.

استشهد بهذه الصفحة

AI CodeOps (2026). ملف CODEOWNERS أولي للمستودعات التي يعمل فيها وكلاء البرمجة بالذكاء الاصطناعي. https://aicodeops.dev/templates/codeowners-starter

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