Copilot Memory مقابل التعليمات المخصصة: أين تُخزَّن الذكريات وكيف تحذفها

الخطوات الـ 12 كاملة: من المجلد على القرص إلى قالب تعليمات مُودَع في المستودع

قالب تعليمات مخصصة يغطي الأمور الستة التي يحتاجها Copilot فعلًا

توصية GitHub نفسها هي إبقاء الملف قصيرًا ومحددًا: ما التقنيات، وكيف تُشغَّل الأمور، وأين يعيش الكود، وأي الأعراف إلزامية، وما يجب تجنّبه. وقد كُتبت الكتل أدناه لتُنسخ ثم تُقلَّم — احذف أي سطر يستطيع الوكيل استنتاجه بقراءة المستودع، لأن ملف تعليمات منتفخ يخفف القواعد المهمة. واحفظه باسم .github/copilot-instructions.md في جذر المستودع.

# .github/copilot-instructions.md

## Project and stack
- Next.js 15 app router, TypeScript strict, Node 22.
- Package manager: pnpm. Never run npm or yarn install.

## Commands
- Build: pnpm build
- Lint: pnpm lint
- Test everything: pnpm test
- Test one file: pnpm test -- path/to/file.test.ts

## Layout
- Routes: src/app/**
- UI components: src/components/**
- Data access: src/lib/db.ts and src/lib/repositories/**
- Tests live next to the file they cover: *.test.ts

## Conventions
- Named exports only; no default exports from src/lib.
- Handle errors at the boundary and return early instead of nesting.
- Import order: node builtins, external packages, then @/ aliases.

## Testing and review
- Every behaviour change ships with a test in the same pull request.
- Run the single-file test before requesting review.
- Commit messages follow Conventional Commits.

## Do not
- Do not edit files under src/generated/**.
- Do not add a dependency without calling it out in the pull request.
- Do not log secrets, tokens or full request bodies.

• 1المشروع والتقنيات — سمِّ إطار العمل ووضع اللغة ومدير الحزم في سطر واحد. هذه هي الكتلة التي تمنع الوكيل من التخمين بين npm وpnpm وyarn وتوليد ملف قفل لم تطلبه.
• 2الأوامر — أوامر البناء والفحص والاختبار واختبار ملف واحد بالضبط، منسوخة من إعداد CI لا من الذاكرة. أمر اختبار خاطئ هو أغلى سطر قد تسقطه.
• 3البنية — أين توجد المسارات والمكوّنات والوصول إلى البيانات والاختبارات. أشِر إلى المجلدات بدل وصف المعمارية نثرًا؛ فالمسار قابل للتحقق، والفقرة ليست كذلك.
• 4الأعراف — التسمية ومعالجة الأخطاء وترتيب الاستيراد وقواعد التنسيق التي يفرضها فريقك فعلًا. واجعل كل قاعدة قاطعة: إما أن الكود يلتزم بها أو لا.
• 5الاختبار والمراجعة — ما الذي يجب أن يأتي مصحوبًا باختبار، وما يُتوقع من المراجعة التحقق منه، وعُرفك في الإيداع والفروع. هذه هي الكتلة التي تحوّل ذكرى كنت ستحتاجها إلى ضمان.
• 6ما يجب تجنّبه — الأنماط المرفوضة. الملفات المولّدة، والتبعيات الجديدة دون ذكرها، وإعادة الهيكلة غير المتصلة، والأسرار في السجلات. والقواعد السلبية أرخص طريقة لمنع فئة كاملة من طلبات السحب السيئة.

حصّر النطاق بملف ثانٍ

أبقِ ملف المستودع قصيرًا بنقل القواعد الخاصة بمجلد معيّن إلى ملفاتها تحت .github/instructions/. والعمل كله يقوم على الترويسة: يربط applyTo الملف بالمسارات المطابقة تلقائيًا، ويتيح description للوكيل جلبه للمهمة المناسبة. وتوثّق VS Code الحقول name وdescription وapplyTo كالحقول المدعومة.

---
name: 'React components'
description: 'Use when creating or updating components under src/components.'
applyTo: 'src/components/**/*.tsx'
---

# React components
- One component per file, named after the file.
- Props are typed with an explicit interface; no React.FC.
- Colocate styles with the component; no global class names.

أبقِ تفضيلاتك الشخصية خارج ملف المستودع

كل ما يتعلق بك لا بالمشروع — طول الرد ونبرته وطريقة شرح الفروقات التي تريدها — مكانه التعليمات الشخصية. يقرأ Copilot CLI ومضيف الوكيل الملف ~/.copilot/copilot-instructions.md؛ وعلى github.com افتح Copilot Chat وانقر صورة ملفك واختر Personal instructions، حيث يوفّر GitHub أيضًا قوالب بعناصر نائبة مثل [format]. والتعليمات الشخصية تتقدم على تعليمات المستودع والمنظمة، فالتفضيل المضبوط هناك لا يحتاج إلى تكراره في كل مستودع.

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