مسارات عمل التطويرالمهارات العامة

Database Operations

عمليات قاعدة بيانات آمنة لوكلاء الذكاء الاصطناعي — فحص المخطط، الاستعلام للقراءة فقط، تحليل الأداء، ترحيلات محكومة، واستكشاف البيانات عبر Supabase وPlanetScale وNeon أو أي قاعدة بيانات SQL.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

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

الهيكلية

كيف يوجه Database Operations وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Database Operations

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-database

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-database · الأدوات المسموح بها: 22

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

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

هل يذكر "مخطط"، "جداول"، "أعمدة"، "هيكل"؟

سير العمل 1: فحص المخطط

هل يذكر "استعلام"، "اختيار"، "البحث عن بيانات"، "أرني"؟

سير العمل 2: استعلام آمن

هل يذكر "بطيء"، "الأداء"، "تحسين"، "فهرس"؟

سير العمل 3: تحليل الأداء

هل يذكر "ترحيل"، "تعديل"، "إضافة عمود"، "إنشاء جدول"؟

سير العمل 4: الترحيلات

هل يذكر "إدراج"، "تحديث"، "حذف"، "كتابة"؟

سير العمل 5: الكتابات المحكومة

غير واضح؟

ابدأ بـ list_tables لفهم قاعدة البيانات

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

012-4 استدعاء

فحص المخطط

فهم الهيكل قبل التنفيذ

022-3 استدعاء

الاستعلام الآمن

قراءة فقط مع LIMIT وEXPLAIN

033-4 استدعاء

تحليل الأداء

اكتشاف الاستعلامات البطيئة + الفهارس المفقودة

043-4 استدعاء

الترحيلات

إنشاء → تحقق → تطبيق مع التراجع

053 استدعاء

الكتابة الخاضعة للحوكمة

التحقق → شرح النطاق → التنفيذ

حدود الأداة

قد تستخدم المهارة 22 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-database بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

list_tables

describe_table

get_relationships

list_indexes

get_database_stats

search_schema

query

sample_data

filter_table

explain_query

get_column_stats

execute

create_index

run_migration

list_migrations

get_slow_queries

get_connections

get_maintenance_status

get_index_usage

generate_schema

get_er_diagram

validate_sql

قواعد العمل

ما الذي يجب على الوكيل القيام به.

اتبع دليل القرار، استخدم حدود الأداة المعلنة، وتحقق من النتيجة قبل الرد.

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

راجع SKILL.md الكامل قبل تمكين هذه المهارة للعمل الإنتاجي.

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-database، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-database-operations.git \
  ~/.skills/skills/database-operations

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("database-operations").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال خادم mcp-database (Supabase، PlanetScale، Neon، أو API مخصص).

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل متعدد MCP ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md التحقق ↗scripts/validate.py تقرير الاستعلام ↗assets/query-report.md

استمر في الاستكشاف