/ الدليل / الملعب / agent-rules-skill
● مجتمع netresearch ⚡ فوري

agent-rules-skill

بواسطة netresearch · netresearch/agent-rules-skill

ينشئ ملفات AGENTS.md باتباع معيار agents.md — يخبر أي وكيل ترميز (Claude Code أو Cursor أو Codex) عن كيفية عمل مستودعك.

مهارة Claude Code صغيرة ومركزة من Netresearch. تفحص المستودع وتحرر ملف AGENTS.md باتباع معيار agents.md — معيار متنام لإخبار وكلاء الذكاء الاصطناعي بمعايير المشروع وأوامر البناء ونهج الاختبار وقواعد المساهمة في مكان واحد.

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

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

عرض مباشر

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

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

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-rules-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-rules-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/netresearch/agent-rules-skill",
          "~/.claude/skills/agent-rules-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add agent-rules-skill -- git clone https://github.com/netresearch/agent-rules-skill ~/.claude/skills/agent-rules-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

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

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

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

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

المتطلبات الأساسية
  • تثبيت المهارة — git clone https://github.com/netresearch/agent-rules-skill ~/.claude/skills/agent-rules-skill
الخطوات
  1. تشغيله على مستودعك
    استخدم agent-rules-skill. حلل هذا المستودع وحرر ملف AGENTS.md باتباع المعيار.✓ تم النسخ
    → مسودة تتضمن أوامر البناء والاختبار وتكوين التصحيح وملاحظات النمط والمزالق
  2. تحسين
    أضف قسماً عن أماكن عدم التعديل (الملفات المنتجة، vendor/).✓ تم النسخ
    → تم إضافة قسم مع مسارات محددة
  3. الالتزام
    التزم كـ docs/AGENTS.md.✓ تم النسخ
    → تم الالتزام بالملف في جذر المستودع أو في docs/

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

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

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

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

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

الخطوات
  1. مسح الحزم
    استخدم agent-rules-skill. لكل حزمة في packages/، أنشئ ملف AGENTS.md مخصص يلتقط خصوصياتها.✓ تم النسخ
    → ملف AGENTS.md واحد لكل حزمة
  2. ملخص الجذر
    أنشئ ملف AGENTS.md في الجذر يرتبط بملفات كل حزمة ويسرد القواعد المشتركة.✓ تم النسخ
    → ملف جذر يحتوي على مؤشرات

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

اجمعها مع: filesystem

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

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

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

الخطوات
  1. مقارنة
    استخدم agent-rules-skill. قارن AGENTS.md الحالي مع ما يملكه المستودع فعلاً الآن. ما الذي أصبح قديماً؟✓ تم النسخ
    → قائمة بعناصر الانحراف
  2. التحديث
    حدّث فقط الأجزاء القديمة؛ اترك الأقسام المكتوبة بواسطة البشر كما هي.✓ تم النسخ
    → حد أدنى من الفروقات مع الحفاظ على تعليقات البشر

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

اجمعها مع: git

التركيبات

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

agent-rules-skill + filesystem

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

اكتب المسودة في AGENTS.md في جذر المستودع.✓ تم النسخ
agent-rules-skill + git

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

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

الأدوات

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

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

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

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

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

الأمان

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

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

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

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

Generated commands don't match CI

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

File is too long

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

البدائل

agent-rules-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
كتابة AGENTS.md يدوياًمستودع صغير مع معايير واضحةيعمل لكنه ينحرف؛ تحتاج إلى انضباط للحفاظ على تحديثه
Cursor-specific .cursorrulesإذا كنت تستخدم Cursor فقطغير محمول؛ AGENTS.md يعمل مع جميع الوكلاء

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills