AI CodeOps

قالب وصف طلب السحب للتغييرات التي يكتبها الذكاء الاصطناعي

آخر تحديث

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

احفظ الكتلة أدناه باسم .github/pull_request_template.md (على GitHub) أو ملف Markdown في .gitlab/merge_request_templates/ (على GitLab). واحذف الأقسام التي لا يستخدمها فريقك، وهذه الملاحظة.

## What this changes

<!-- One or two sentences a reviewer can check the diff against. -->

## Why

<!-- The issue, ticket or decision this comes from. -->

Closes #

## How it was made

- [ ] Written by a person
- [ ] Written with an AI assistant (completion or chat)
- [ ] Written by a coding agent

Tool and model:
Task given to the tool (paste it, or link to it):

## What was verified

- [ ] Tests ran on this exact commit: <!-- link to the run -->
- [ ] New tests fail without this change
- [ ] No tests were deleted, skipped or loosened (or the reason is below)
- [ ] Checked by hand: <!-- what, and how -->

## What was NOT verified

<!-- Be specific. "Not run against production-sized data", "No browser test for Safari". Write "Nothing" only if that's true. -->

## Where to look first

<!-- The files or lines where a mistake would be expensive: money, auth, permissions, personal data, migrations. -->

## Out of scope

<!-- Anything the tool changed that the task didn't ask for, and why it stays. Empty is best. -->

## Risk and rollback

- Risk: low / medium / high, because
- Rollback: revert this commit / feature flag / other:
- Needs a migration or config change: yes / no

## Reviewer

- [ ] I read the task and the test results before the code
- [ ] I'm not the person who gave the tool its task

كيف تملؤه

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

قسم How it was made (كيف صنع). ضع علامة في مربع واحد، وسم الأداة والنموذج. فالمراجعون يقرؤون الكود الذي كتبه الوكيل بطريقة مختلفة: الخطر فيه أقل في الصياغة وأكثر في النطاق والافتراضات والاختبارات. والصق المهمة، فهي المواصفة الحقيقية لما بناه الوكيل.

قسم What was verified (ما جرى التحقق منه). كل علامة تحتاج إلى دليل يسندها، ويفضل أن يكون رابطا إلى تشغيل الاختبار لهذا الإيداع. والتشغيل الذي سبق آخر دفع لا يحتسب. وإذا وضعت علامة على "New tests fail without this change"، فأنت تحققت من ذلك بعكس الإصلاح وتشغيل الاختبارات.

قسم What was NOT verified (ما لم يجر التحقق منه). هذا أنفع قسم، وأكثرها تركا فارغا. فالوكلاء يصفون عملهم بأنه مكتمل. والشخص الذي يملأ هذا القسم هو الفحص على ذلك.

قسم Where to look first (أين تنظر أولا). أشر إلى المواضع القليلة التي يكلف فيها الخطأ مالا أو ثقة حقيقيين. فالمراجع الذي لديه وقت محدود ينبغي أن يصرفه هناك.

قسم Out of scope (خارج النطاق). يصلح الوكلاء أشياء يلاحظونها في الطريق. اسردها هنا، أو الأفضل أن تنقلها إلى طلب سحب خاص بها.

قسم Reviewer (المراجع). مربعان للشخص الذي يوافق. والثاني موجود لأن الشخص الذي كتب المهمة هو، في الواقع، كاتب التغيير.

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

أين أضع قالب طلب السحب هذا؟

على GitHub، احفظه باسم .github/pull_request_template.md. وعلى GitLab، احفظه ملف Markdown في .gitlab/merge_request_templates/ واختره حين تفتح طلب الدمج (merge request).

لماذا السؤال عما لم يجر التحقق منه؟

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

هل ينبغي أن يملأه وكيل الذكاء الاصطناعي بنفسه؟

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

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

AI CodeOps (2026). قالب وصف طلب السحب للتغييرات التي يكتبها الذكاء الاصطناعي. https://aicodeops.dev/templates/ai-pr-description

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