GitHub Copilot custom instructions: مكانه وكيفية قراءته من الأدوات

يقرأ GitHub Copilot ملفًا واحدًا على مستوى المستودع، وهو .github/copilot-instructions.md، بالإضافة إلى ملفات .instructions.md الخاصة بمسارات محددة. كما يراعي AGENTS.md، أو ملفًا واحدًا في الجذر هو CLAUDE.md أو GEMINI.md.

مكان الملف

• .github/copilot-instructions.md، ويُطبّق على المستودع بأكمله.
• .github/instructions/**/NAME.instructions.md، ويُطبّق على الملفات التي يطابقها applyTo.
• ملف AGENTS.md في أي مكان داخل المستودع؛ وتكون الأولوية لأقرب ملف.
• ملف واحد في الجذر، CLAUDE.md أو GEMINI.md، كخيار بديل.

التنسيق

Markdown؛ تُتجاهل المسافات البيضاء بين التعليمات. ملفات .instructions.md وحدها تقبل frontmatter: يحتوي applyTo على أنماط glob مفصولة بفواصل، ويأخذ excludeAgent القيمة "code-review" أو "cloud-agent". ألغت مراجعة الكود حدّ 4,000 حرف في 2026-06-12، وتوصي GitHub بألا يتجاوز طول الملف نحو 1,000 سطر.

مفاتيح Frontmatter: applyToexcludeAgent

# Copilot instructions

This is a Rails app with a React front end in app/javascript/.

## Build and test

- Install: `bundle install && yarn install`
- Test: `bin/rails test`
- Lint: `bin/rubocop`

## Conventions

- Put business logic in app/services/, not in controllers.
- Every migration must be reversible.
- Never commit credentials or edit config/master.key.

الأولوية والدمج

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

نصائح

• على github.com، تعمل ملفات .instructions.md الخاصة بمسارات محددة مع وكيل Copilot السحابي ومراجعة كود Copilot فقط.
• أضف excludeAgent: "code-review" لاستثناء ملف من المراجعات، مع إبقائه متاحًا لوكيل Copilot السحابي.
• يمكن لوكيل Copilot السحابي إعداد مسودة copilot-instructions.md لك؛ اجعله في حدود صفحتين، ولا تربطه بمهمة واحدة.

ملفات التعليمات الأخرى