Elastic Agent Skills

Elastic Agent Skills — التي بناها الفريق الذي بنى Elastic — تقدم خبرة المنصة الأصلية مباشرة إلى وكيل البرمجة الذكي الخاص بك. هذه هي مكتبة Agent Skills الرسمية، المتوافقة مع بيئات التطوير الذكية مثل Cursor وGitHub Copilot وWindsurf وGemini CLI والمزيد. تتبع المهارات المعيار المفتوح Agent Skills.

[!NOTE] معاينة تقنية

هذه المهارات في إصدار مبكر وتحت تطوير نشط. توقع تغييرات حيث يتم تدوين المهارات مع تقييمات قوية ومع تطور مشهد النماذج. تحقق من التحديثات بشكل متكرر.

حول

يحتوي هذا المستودع على مهارات منسقة وهي حزم من التعليمات والسياق والأدوات التي تعلم أي وكيل ذكاء اصطناعي كيفية العمل بشكل صحيح مع Elasticsearch وKibana وElastic Observability وElastic Security. ضعها في بيئة تشغيل الوكيل التي تستخدمها بالفعل، وسيتوقف مساعدك عن استخدام الأنماط القديمة ويبدأ في إنجاز الأمور بشكل صحيح.

ما هي المهارات؟

المهارات هي حزم مستقلة تمنح وكلاء الذكاء الاصطناعي المعرفة والأدوات لإكمال مهام محددة بطريقة قابلة للتكرار. تعيش كل مهارة في مجلد خاص بها مع ملف SKILL.md يحتوي على البيانات الوصفية والتعليمات التي يتبعها الوكيل.

لمزيد من الخلفية حول معيار Agent Skills، راجع agentskills.io.

النطاق

تركز المهارات في هذا المستودع على:

• التفاعل مع واجهات برمجة تطبيقات Elasticsearch (البحث، الفهرسة، إدارة المجموعات)
• بناء وإدارة محتوى Kibana مثل التنبيهات والموصلات والمزيد
• أنماط لـ Elastic Observability وElastic Security وAgent Builder

المهارات المتاحة

اعتبارات الأمان

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

• قم بإجراء نمذجة التهديدات الخاصة بك. قم بتقييم البيانات التي يمكن للوكيل الوصول إليها، والإجراءات التي يمكنه اتخاذها، وما يحدث إذا تصرف بشكل غير متوقع. إرشادات CISA المشتركة حول نشر أنظمة الذكاء الاصطناعي بشكل آمن هي نقطة بداية جيدة.
• كن على دراية بالبيانات التي تمر عبر الوكيل. يمكن أن تحتوي البيانات الأمنية على PII وبيانات اعتماد مدمجة في أسطر الأوامر وبيانات أخرى منظمة. عندما يستعلم الوكيل عن التنبيهات أو أحداث العمليات، يدخل هذا المحتوى في سياق النموذج وقد يتم إرساله إلى واجهة برمجة تطبيقات تابعة لجهة خارجية. أشرك فرق الأمن والامتثال لديك مبكرًا.
• هذه الوكلاء يعالجون مدخلات يتحكم فيها المهاجم. تحتوي التنبيهات وحقول الأحداث ومحتويات الملفات بانتظام على سلاسل صممها المهاجمون. حقن المطالبات ليس نظريًا هنا؛ إنها خاصية متأصلة في بيئة التشغيل. يوضح بحث مثل Brainworm أن ملفات سياق الوكيل وحدها يمكن أن تعمل كآلية استمرار للبرمجيات الخبيثة القائمة على المطالبات.
• قم بتضييق نطاق الامتيازات بدقة. امنح مفاتيح API الحد الأدنى من الامتيازات المطلوبة. امتيازات الاستجابة الواسعة خطيرة بشكل خاص. الوصول للقراءة فقط هو افتراضي جيد حتى تتحقق من السلوك.
• قيد وصول أدوات الوكيل والوصول إلى الشبكة. تأتي معظم وكلاء البرمجة الذكية بإعدادات افتراضية واسعة: تنفيذ الصدفة، كتابة نظام الملفات، الوصول إلى الإنترنت. تقليل سطح الأدوات المتاحة يحد من ما يمكن أن يفعله الوكيل المخترق أو المضلل.
• ابدأ في بيئات غير إنتاجية. استخدم مشروع تجريبي Serverless أو مجموعة تطوير أو مساحة Kibana معزولة لتقييم المهارات قبل توصيلها بأي شيء يحمل بيانات أمنية حية.

هذه المهارات مفتوحة المصدر تحديدًا حتى تتمكن من تدقيق ما تفعله. نشجعك على قراءتها قبل تشغيلها.

البدء

يمكنك تثبيت مهارات Elastic باستخدام نظام الإضافات الأصلي في Claude Code، أو CLI skills مع npx، أو عن طريق استنساخ هذا المستودع وتشغيل سكربت التثبيت المرفق. تتطلب طريقة npx توفر Node.js مع npx في بيئتك.

[!TIP] لا تقم بتثبيت كل مهارة. كل مهارة مثبتة تضيف سياق توجيه يقوم وكيلك بتقييمه في كل طلب. قم بتثبيت مهارات المصادقة cloud وelasticsearch — معظم المهارات الأخرى تعتمد عليها — ثم أضف فقط المهارات ذات الصلة بسير عملك. الحفاظ على المجموعة المثبتة مركزة يتجنب تضخم السياق ويساعد الوكيل على التوجيه إلى المهارة الصحيحة بشكل موثوق.

إضافة Claude Code (موصى به لمستخدمي Claude Code)

يحتوي Claude Code على نظام إضافات أصلي يدير المهارات مباشرة. ابدأ بإضافة هذا المستودع كمصدر سوق:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

بمجرد الإضافة، قم بتثبيت الإضافات الفردية بالاسم:```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install cloud@elastic-agent-skills

[!NOTE] بعد التثبيت، قد لا تظهر المهارات فورًا عند تشغيل /reload-plugins. هذه مشكلة معروفة في Claude Code — أعد تشغيل جلسة Claude Code الخاصة بك لالتقاط الإضافات المثبتة حديثًا.

أو استخدم متصفح الإضافات التفاعلي داخل أي جلسة Claude Code:``` /plugins

يفتح هذا قائمة لتصفح الإضافات المتاحة من جميع الأسواق المُهيأة، واختيار ما تريد تثبيته، وإدارة ما هو مثبت بالفعل.

### GitHub Copilot CLI

يحتوي GitHub Copilot CLI على نظام إضافات أصلي. أضف هذا المستودع كمصدر سوق:```sh
copilot plugin marketplace add elastic/agent-skills

بمجرد إضافتها، قم بتثبيت الإضافات الفردية بالاسم:```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills

أو تصفح الإضافات المتاحة بشكل تفاعلي داخل جلسة Copilot:```
/plugin list

npx (موصى به)

أسرع طريقة لتثبيت المهارات هي باستخدام واجهة سطر الأوامر skills. لا حاجة لاستنساخ هذا المستودع — فقط قم بتشغيل:```sh npx skills add elastic/agent-skills

يؤدي هذا إلى تشغيل موجه تفاعلي لتحديد المهارات و[العوامل المستهدفة](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). ينسخ CLI كل مجلد مهارة إلى الموقع الصحيح ليكتشفه العامل.

تثبيت مهارة محددة بالاسم:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql

أو استخدم الاختصار @ لتحديد المهارة مباشرةً بصيغة repo@skill (أي ما يعادل --skill):```sh npx skills add elastic/agent-skills@elasticsearch-esql

التثبيت لوكلاء محددين (انظر [الوكلاء المدعومون](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```sh
npx skills add elastic/agent-skills -a cursor -a claude-code

قائمة المهارات المتاحة دون تثبيت:```sh npx skills add elastic/agent-skills --list

ثبّت جميع المهارات لجميع الوكلاء (بدون تفاعل):```sh
npx skills add elastic/agent-skills --all

استنساخ محلي

إذا كنت تفضل العمل من نسخة محلية، أو كانت بيئتك لا تحتوي على Node.js / npx، فاستنسخ المستودع واستخدم مثبّت bash المرفق:```sh git clone https://github.com/elastic/agent-skills.git cd agent-skills ./scripts/install-skills.sh add -a

يتطلب السكربت bash 3.2+ وأدوات Unix القياسية (`awk`, `find`, `cp`, `rm`, `mkdir`).

| العلامة              | الوصف                           |
| ----------------- | ------------------------------------- |
| `-a, --agent`     | الوكيل المستهدف (قابل للتكرار)             |
| `-s, --skill`     | تثبيت مهارات محددة بالاسم       |
| `-f, --force`     | استبدال المهارات المثبتة بالفعل    |
| `-y, --yes`       | تخطي مطالبات التأكيد             |

قائمة بجميع المهارات المتاحة:```sh
./scripts/install-skills.sh list

الوكلاء المدعومون

تحديث المهارات

تعتمد عملية التحديث على طريقة تثبيت المهارات.

إضافة Claude Code

قم بتحديث جميع الإضافات المثبتة إلى أحدث إصداراتها:```sh claude plugin update

قم بتحديث إضافة معينة:```sh
claude plugin update elastic-elasticsearch

لإبقاء الإضافات محدّثة تلقائيًا، فعّل التحديث التلقائي باستخدام /plugins داخل Claude Code.

عند تفعيل التحديث التلقائي، يتحقق Claude Code من وجود إصدارات جديدة للإضافات عند بدء التشغيل ويحدّثها في الخلفية.

GitHub Copilot CLI

تحديث جميع الإضافات المثبّتة إلى أحدث إصداراتها:```sh copilot plugin update

قم بتحديث إضافة معينة:```sh
copilot plugin update elasticsearch

npx

تحقق مما إذا كانت أي مهارات مثبتة قد تغيّرت في المصدر العلوي:```sh npx skills check

اسحب أحدث الإصدارات لجميع المهارات المثبتة:```sh
npx skills update

يتتبع واجهة سطر الأوامر مستودع المصدر لكل مهارة ورمز تجزئة للمحتوى في ملف قفل. يقارن check التجزئات المحلية لديك مع GitHub؛ بينما يعيد update تنزيل أي شيء انحرف عن الأصل.

نصيحة: يستخدم التثبيت الافتراضي عبر npx روابط رمزية، لذا يشير كل وكيل إلى نسخة أساسية واحدة. التحديث مرة واحدة يُحدّث جميع الوكلاء في نفس الوقت.

استنساخ محلي

أعد تشغيل المثبّت مع --force لاستبدال المهارات الموجودة:```sh git pull ./scripts/install-skills.sh add -a --force

بدون `--force`، يتخطى السكربت المهارات المثبتة بالفعل.

## تنسيق المهارة

يحتوي كل مجلد مهارة على ملف `SKILL.md` يتضمن بيانات أمامية بصيغة YAML وتعليمات بتنسيق Markdown:```yaml
---
name: elasticsearch-my-skill
description: >
  What the skill does AND when an agent should activate it.
metadata:
  version: 0.1.0
  visibility: public
---

# My Skill

[Instructions that the agent follows when this skill is active]

حقل description هو آلية التشغيل الوحيدة — حيث تقرأ بيئات تشغيل الوكلاء هذا الحقل لتقرر متى يتم تحميل مهارة. للحصول على مواصفات التنسيق الكاملة، راجع agentskills.io/specification.

المشكلات

وجدت مشكلة أو لديك اقتراح؟ افتح مشكلة وسنقوم بمراجعتها.

إخلاء المسؤولية

تُقدَّم هذه المهارات كما هي. اختبر المهارات دائمًا بدقة في بيئتك الخاصة قبل الاعتماد عليها في المهام الحرجة.