agent-rules-skill

لماذا تستخدمه

الميزات الأساسية

يتبع معيار agents.md
يكتشف أوامر البناء والاختبار والتصحيح تلقائياً
يستخرج معايير الترميز من الكود الموجود
ملف واحد يعمل مع Claude Code و Cursor و Codex وغيرها
يحافظ على الملف قصيراً — agents.md للتوجيه وليس للروايات الطويلة

عرض مباشر

كيف يبدو في الممارسة

agent-rules-skill.replay ▶ جاهز

0/0

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

حالات الاستخدام

استخدامات عملية: agent-rules-skill

إنشاء ملف AGENTS.md لمستودع لا يملك واحداً

👤 الفرق التي تقدم وكلاء الترميز بالذكاء الاصطناعي لقاعدة كود موجودة ⏱ ~15 min beginner

متى تستخدمه: بدأ فريقك للتو في استخدام Claude Code أو Cursor ولم يكتب أحد وثيقة التوجيه.

الخطوات

تشغيله على مستودعك

استخدم agent-rules-skill. حلل هذا المستودع وحرر ملف AGENTS.md باتباع المعيار.✓ تم النسخ

→ مسودة تتضمن أوامر البناء والاختبار وتكوين التصحيح وملاحظات النمط والمزالق
تحسين

أضف قسماً عن أماكن عدم التعديل (الملفات المنتجة، vendor/).✓ تم النسخ

→ تم إضافة قسم مع مسارات محددة
الالتزام

التزم كـ docs/AGENTS.md.✓ تم النسخ

→ تم الالتزام بالملف في جذر المستودع أو في docs/

النتيجة: ملف AGENTS.md حي يجعل جلسات الوكيل المستقبلية تبدأ مع السياق.

المزالق

ينتفخ AGENTS.md ليصبح وثيقة شاملة — احتفظ به مركزاً على ما يحتاجه الوكيل. ربط مع README للبشر.

اجمعها مع: filesystem · git

إنشاء ملفات AGENTS.md لكل حزمة في monorepo

👤 محافظو Monorepo ⏱ ~30 min intermediate

متى تستخدمه: الحزم المختلفة لديها معايير مختلفة؛ ملف AGENTS.md واحد في الجذر غير كافي.

الخطوات

مسح الحزم

استخدم agent-rules-skill. لكل حزمة في packages/، أنشئ ملف AGENTS.md مخصص يلتقط خصوصياتها.✓ تم النسخ

→ ملف AGENTS.md واحد لكل حزمة
ملخص الجذر

أنشئ ملف AGENTS.md في الجذر يرتبط بملفات كل حزمة ويسرد القواعد المشتركة.✓ تم النسخ

→ ملف جذر يحتوي على مؤشرات

النتيجة: يختار الوكلاء السياق الصحيح بناءً على الحزمة التي يعملون عليها.

اجمعها مع: filesystem

الحفاظ على AGENTS.md متزامناً مع مستودع متطور

👤 المستودعات حيث يصبح AGENTS.md قديماً بسرعة ⏱ ~10 min beginner

متى تستخدمه: أضفت أوامر بناء جديدة أو غيرت المعايير و AGENTS.md يكذب عليها.

الخطوات

مقارنة

استخدم agent-rules-skill. قارن AGENTS.md الحالي مع ما يملكه المستودع فعلاً الآن. ما الذي أصبح قديماً؟✓ تم النسخ

→ قائمة بعناصر الانحراف
التحديث

حدّث فقط الأجزاء القديمة؛ اترك الأقسام المكتوبة بواسطة البشر كما هي.✓ تم النسخ

→ حد أدنى من الفروقات مع الحفاظ على تعليقات البشر

النتيجة: يبقى AGENTS.md جديراً بالثقة.

اجمعها مع: git

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

agent-rules-skill + filesystem

تطبيق الملفات المنتجة مباشرة

اكتب المسودة في AGENTS.md في جذر المستودع.✓ تم النسخ

agent-rules-skill + git

الالتزام كتغيير مركز

التزم بـ AGENTS.md الجديد برسالة توضح ما يغطيه.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها
scan_repo	repo path	الخطوة الأولى في أي مستودع
draft_agents_md	scan output	تحرير ملف جديد
diff_check	existing AGENTS.md + current repo	فحص القدم

التكلفة والحدود

تكلفة التشغيل

حصة API: لا يوجد
الرموز لكل استدعاء: متواضع — مسح المستودع + إخراج قصير
التكلفة المالية: مجاني
نصيحة: شغّل على مجلدات مركزة في monorepos كبيرة؛ مسح المستودع بالكامل يتطلب رموز كثيرة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا يوجد

نقل البيانات الخارجي: محتويات المستودع تمر عبر Claude API أثناء المسح

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Generated commands don't match CI

تحقق مقابل تكوين CI الفعلي؛ تستدل المهارة من الملفات الشائعة لكن ليس دائماً

File is too long

اطلب الإيجاز؛ agents.md مقصود أن يكون قصيراً

البدائل