---
title: "منشئ AGENTS.md مع قواعد لخمسة وكلاء برمجة · DotsAgent"
description: "املأ نموذجًا واحدًا لإنشاء AGENTS.md، وقاعدة واحدة محددة المسارات لـ Cursor وCopilot وClaude Code وCline وDevin، وملفات ربط لـ Gemini CLI وAider."
url: https://dotsagent.io/ar/instructions
---

التوجيه · أداة

# منشئ AGENTS.md

املأ نموذجًا واحدًا لإنشاء AGENTS.md يتضمن أوامرك وأعرافك وحدودك الصارمة. وستحصل أيضًا على قاعدة واحدة محددة المسارات بصيغ متوافقة مع Cursor وGitHub Copilot وClaude Code وCline وDevin Desktop، إضافةً إلى ملفات ربط للأدوات التي لا تتعرّف على AGENTS.md تلقائيًا.

[أماكن البحث عن ملفات التعليمات في كل أداة →](https://dotsagent.io/ar/instructions/files)

`AGENTS.md`

```
# تطبيق ويب Acme

تطبيق ويب موجّه للعملاء، يتضمن لوحة إدارة وواجهة REST API صغيرة.

## الإعداد التقني

Next.js, React, TypeScript, pnpm

## الأوامر

- التثبيت: `pnpm install`
- التشغيل محليًا: `pnpm dev`
- الاختبارات: `pnpm test`
- فحص lint والتحقق من الأنواع: `pnpm lint && pnpm tsc --noEmit`
- البناء: `pnpm build`

## أسلوب كتابة الشيفرة

- التزم بالتنسيق الذي يفرضه linter، واترك الملفات التي لم تعدّلها كما هي.
- فضّل الدوال الصغيرة ذات المدخلات والمخرجات الواضحة، وأبقِ الآثار الجانبية عند الأطراف.
- استأذن قبل إضافة اعتماد جديد.
- علّق على أسباب الشيفرة غير الواضحة، لا على وظيفة كل سطر.

## الاختبارات

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

## Commits وطلبات السحب

- اكتب عناوين commits بصيغة الأمر، واجعلها أقصر من 72 حرفًا.
- احصر كل pull request في تغيير واحد، واذكر في وصفه كيفية اختباره.
- شغّل lint والاختبارات قبل كل commit.

## ممنوع

- لا تضع أسرارًا أو مفاتيح API أو ملفات .env في commit.
- لا تعدّل يدويًا الملفات المُنشأة ضمن src/generated/؛ أعد إنشاءها بدلًا من ذلك.
- لا تشغّل أوامر مدمّرة لقواعد البيانات على بيئة الإنتاج.
- لا تستخدم force-push إلى main ولا تُعِد كتابة سجلّ مشترك.
```

### القاعدة نفسها لخمس أدوات

قاعدة واحدة بخمس صيغ؛ احفظ كل ملف في المسار الموضّح أعلاه.

`.cursor/rules/scoped.mdc`

```
---
description: اصطلاحات الملفات المطابقة لنمط glob هذا
globs: app/**/*.tsx
alwaysApply: false
---

اتبع الأنماط المستخدمة بالفعل في الملفات المجاورة ضمن هذا المجلد. أضف docstring واختبارًا في ملف الاختبار المطابق لكل دالة مُصدَّرة.
```

`.github/instructions/scoped.instructions.md`

```
---
applyTo: "app/**/*.tsx"
---

اتبع الأنماط المستخدمة بالفعل في الملفات المجاورة ضمن هذا المجلد. أضف docstring واختبارًا في ملف الاختبار المطابق لكل دالة مُصدَّرة.
```

`.claude/rules/scoped.md`

```
---
paths:
  - "app/**/*.tsx"
---

اتبع الأنماط المستخدمة بالفعل في الملفات المجاورة ضمن هذا المجلد. أضف docstring واختبارًا في ملف الاختبار المطابق لكل دالة مُصدَّرة.
```

`.clinerules/scoped.md`

```
---
paths:
  - "app/**/*.tsx"
---

اتبع الأنماط المستخدمة بالفعل في الملفات المجاورة ضمن هذا المجلد. أضف docstring واختبارًا في ملف الاختبار المطابق لكل دالة مُصدَّرة.
```

`.devin/rules/scoped.md`

```
---
trigger: glob
globs: app/**/*.tsx
---

اتبع الأنماط المستخدمة بالفعل في الملفات المجاورة ضمن هذا المجلد. أضف docstring واختبارًا في ملف الاختبار المطابق لكل دالة مُصدَّرة.
```

## ما الذي يجعل ملف التعليمات فعّالًا؟

### ضع الأوامر الدقيقة في بداية الملف

أدرج أوامر التثبيت والاختبار والفحص الفعلية مع خياراتها في بداية الملف. حدّد التقنيات وإصداراتها بدقة، وأضف مثالاً برمجياً قصيراً عندما يكون الشرح النثري مبهماً.

مدونة GitHub، تحليل لأكثر من 2,500 ملف AGENTS.md

### اكتب قواعد منع صريحة

اذكر بوضوح ما يجب على الوكيل ألّا يفعله، مثل المساس بالأسرار أو الشيفرة المضمّنة من طرف ثالث أو بيئة الإنتاج. كان عدم إيداع الأسرار في المستودع أكثر القيود المفيدة شيوعاً في الملفات التي راجعتها GitHub.

مدونة GitHub، تحليل لأكثر من 2,500 ملف AGENTS.md

### اجعل كل تعليمة قابلة للتحقق

يمكن التحقق من تشغيل npm test قبل الإيداع، لكن لا يمكن التحقق من عبارة اختبر تغييراتك. أزل التناقضات، لأن النموذج قد يتبع أياً من السطرين عند تعارضهما.

وثائق الذاكرة في Claude Code

### اختصر التعليمات ووزّعها حسب المسار

توصي Anthropic بألا يتجاوز الملف 200 سطر، وCursor بألا تتجاوز كل قاعدة 500 سطر. انقل الإرشادات الخاصة بمنطقة معينة إلى قاعدة محددة بنطاق مسار، كي لا تُحمّل إلا عند التعامل مع تلك الملفات. تنظّم الاستيرادات الملف، لكنها لا تقلل تكلفة السياق.

وثائق الذاكرة في Claude Code؛ وثائق قواعد Cursor

### تجاوز ما يعرفه الوكيل مسبقاً

في دراسة شملت أربعة وكلاء للبرمجة، لم ترفع ملفات السياق نسبة نجاح المهام بشكل موثوق، وزادت تكلفة الاستدلال بأكثر من 20%. كما أضرت الملفات التي كتبتها LLMs بالأداء قليلاً، ولم تفد النظرات العامة على المستودعات؛ لذا اقتصر على المتطلبات غير البديهية، مثل الأدوات المحددة.

مختبر SRI في ETH Zurich، arXiv 2602.11988

### أضف القواعد عند تكرار الأخطاء

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

وثائق قواعد Cursor؛ مدونة GitHub

## أسئلة عن AGENTS.md

### هل يقرأ Claude Code ملف AGENTS.md؟

نعم، ابتداءً من v2.1.277. افتراضياً، لا يقرأ AGENTS.md أو .claude/AGENTS.md إلا عند عدم وجود CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في دليل العمل أو في دليل أعلى منه. يحمّل الإعداد claude-md-and-agents-md الملفين معاً، كما أن استخدام @AGENTS.md داخل CLAUDE.md يعمل في جميع الإصدارات.

### هل يتطلب AGENTS.md ترويسة بيانات وصفية أو عناوين محددة؟

لا. ملف AGENTS.md هو Markdown عادي، ولا يتطلب حقولاً محددة، ويمكنك استخدام أي عناوين تريدها. يقترح موقع agents.md أقساماً مثل نظرة عامة على المشروع، وأوامر البناء والاختبار، وأسلوب كتابة الشيفرة، والاختبارات، وملاحظات الأمان، وإرشادات pull request.

### كيف أستخدم AGENTS.md في مستودع أحادي؟

ضع ملف AGENTS.md في الجذر، وآخر داخل كل حزمة تحتاج إلى قواعد خاصة بها. يقرأ الوكلاء الملف الأقرب إلى الشيفرة الجاري تعديلها، وتكون له الأولوية عند التعارض. كان في المستودع الرئيسي لـ OpenAI عدد 88 من هذه الملفات عندما وثّق موقع agents.md ذلك.

### كيف أجعل Gemini CLI يقرأ AGENTS.md؟

لا يزال Gemini CLI يستخدم GEMINI.md افتراضياً. أضف AGENTS.md إلى context.fileName في .gemini/settings.json، مثلاً ["AGENTS.md", "GEMINI.md"]. شغّل /memory show للتحقق مما تم تحميله.

### ما وكلاء البرمجة الذين يدعمون AGENTS.md؟

راجعنا وثائق OpenAI Codex وClaude Code وCursor وGitHub Copilot وDevin Desktop وCline وOpenClaw، وتقرأها جميعها مباشرةً، بينما يحتاج Gemini CLI وAider إلى سطر واحد في الإعدادات. يسرد موقع agents.md ما مجموعه 23 أداة متوافقة، منها Zed وWarp وgoose وopencode وJules وJetBrains Junie.

### من يتولى صيانة تنسيق AGENTS.md؟

أسهمت OpenAI بتنسيق AGENTS.md لصالح Agentic AI Foundation، وهو صندوق تديره Linux Foundation أُعلن عنه في 2025-12-09 إلى جانب MCP وgoose. ويذكر موقع agents.md أن أكثر من 60k مشروع مفتوح المصدر يستخدمه.

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

© 2026 DotsAgent · تم التحقق من المعلومات في 1 أكتوبر 2026