مواصفات AGENTS.md — دليل كامل
اقتراح مشترك من OpenAI · Google · Cursor · Factory · متوافق مع CLAUDE.md · أمثلة من مستودعات حقيقية · اعتبارًا من 2026-10-07، يقرأ Claude Code 2.1.277+ ملف AGENTS.md في المشاريع التي لا تحتوي على CLAUDE.md
لماذا كانت هناك حاجة إلى AGENTS.md
حتى أوائل 2025، كان لكل أداة برمجة بالذكاء الاصطناعي صيغة ذاكرة مشروع خاصة بها — فقد استخدم Cursor الملف .cursorrules، واستخدم Claude Code الملف CLAUDE.md، واستخدم Codex الملف instructions.md، واستخدم Aider الملف .aider.conf.yml. وكان تبديل الأدوات يعني إعادة كتابة معرفتك بالمشروع. في أغسطس 2025، أصدرت OpenAI وGoogle وCursor وFactory وجهات أخرى AGENTS.md معًا كمعيار متعدد الموردين بحيث يعمل ملف إعداد واحد مع أي وكيل متوافق.
الأقسام الأساسية الخمسة
يحدد AGENTS.md خمسة أقسام موحدة تفصل بينها عناوين H2 في Markdown، وتتوافق مع كل محرر Markdown:
Identity: هوية الوكيل، والدور، ولغة الاستجابة
Capabilities: إعلانات القدرات، وتفضيلات الأدوات، وإصدارات النماذج
Tools: قائمة الأدوات المتاحة، ونطاق الأذونات، وإعداد API خارجي
Memory: سياق المشروع، والاصطلاحات، ومعجم المصطلحات، والقرارات السابقة
Constraints: السلوكيات المحظورة، وقواعد السلامة، والامتثال
التشغيل البيني مع CLAUDE.md و .cursorrules
AGENTS.md ليس بديلًا — بل هو القاسم المشترك الأكبر بين الأدوات. سلوك Claude Code الموثق (تم التحقق منه في 2026-10-07) هو أحدهما لا كليهما افتراضيًا: يقرأ AGENTS.md عندما لا يكون هناك CLAUDE.md، ويقرأ CLAUDE.md فقط عندما يوجد كلاهما. يقرأ Cursor ملف AGENTS.md أصليًا منذ 1.2. يبحث Codex CLI عن AGENTS.md أولًا، مع الرجوع إلى instructions.md.
دعم سلسلة الأدوات اليوم
CursorCursor 1.2+: دعم أصلي، ويأخذ AGENTS.md الأولوية على .cursorrules
Claude CodeClaude Code: يقرأه أصليًا منذ 2.1.277 (صدر في 2026-09-18)؛ ويقول سجل التغييرات: «أُضيف دعم AGENTS.md: في مشروع لا يحتوي على CLAUDE.md، يقرأ Claude Code ملف AGENTS.md بدلًا منه». السلوك الافتراضي هو أحدهما لا كليهما: عند وجود CLAUDE.md في دليل العمل أو في دليل أعلى منه، لا يُحمّل سوى CLAUDE.md؛ اضبط Project instructions في /config لقراءة كليهما. منذ 2.1.281 (2026-09-23) يعمل هذا أيضًا خلف بوابات LLM (تم التحقق منه في 2026-10-07).
Codex CLICodex CLI: يبحث عن AGENTS.md افتراضيًا منذ 2026-02، عبر جميع أدوات OpenAI
AiderAider: دعم تجريبي منذ 0.65، ويُفعّل عبر --agents-md
خمسة أنماط مضادة شائعة
1) تكديس جميع القرارات التاريخية في Memory حتى يتضخم الملف إلى ما يتجاوز 10 KB؛ 2) كتابة Identity كنص تسويقي بدلًا من توجيهات قابلة للتنفيذ؛ 3) أن تسرد Constraints مبادئ مجردة بدلًا من سلوكيات محظورة ملموسة؛ 4) قوائم Tools متقادمة لم ينظفها أحد؛ 5) خلطه بـ .gitignore — يجب أن يكون AGENTS.md تحت التحكم بالإصدارات كي يشاركه الفريق.
تشغيل Claude Code مع AGENTS.md من الشبكات المقيّدة
سؤال شائع: «أنا مطور في البر الرئيسي للصين، وتنتهي مهلة Claude Code باستمرار في مشروع AGENTS.md الخاص بي — ماذا الآن؟» هذه مشكلة في إمكانية الوصول عبر الشبكة لا علاقة لها بالمواصفات نفسها. الخيارات: الاشتراك مباشرةً مع Anthropic (الأفضل على الشبكات الخارجية المستقرة)؛ أو استخدام خدمة اشتراك API تحمل علامة تجارية مثل QCode.cc (وصول محسّن للصين + فوترة موحدة + مفتاح واحد لأربعة نماذج)؛ أو بناء بوابة مؤسسات خاصة بك (مهلة تنفيذ طويلة).
شغّل أول مشروع AGENTS.md لك على QCode.cc
Claude Fable 5 · gpt-6.1-sol · Codex — مفتاح واحد، وأدوات متعددة (النماذج القابلة للاستدعاء على /models)
واصل القراءة
إنشاء حساب QCode
مفتاح واحد لـ Claude وGPT والنماذج الصينية، والفوترة حسب token — الأسعار المباشرة على /models.