بنية الوكلاءالمهارات العامة

Artifact Lifecycle

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

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

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

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

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

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

الهيكلية

كيف يوجه Artifact Lifecycle وكيل ADK-Rust.

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

طلب المستخدم

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

→

مهارة Artifact Lifecycle

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

→

وكيل ADK-Rust

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

→

mcp-artifact-store

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

→

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

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

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

دليل القرار

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

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

"تخزين"، "حفظ"، "رفع"؟

write_artifact + create_artifact_version

"العثور على"، "قائمة"، "ما القطع الفنية"؟

list_artifacts / list_folders

"قراءة"، "تحميل"، "الحصول على"؟

read_artifact

"إصدار"، "تاريخ"؟

get_artifact_metadata

"اشتقاق"، "تحويل"، "من"؟

derive_artifact + link_artifacts

"حذف"، "إزالة الحساسية"؟

redact_artifact

"تصدير"، "تغليف"؟

export_artifact_package

سير عمل مثبتة

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

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

012 استدعاء

تخزين

الكتابة + إنشاء إصدار مع الأصل

021 استدعاء

التحقق

فحص سلامة SHA-256

032 استدعاء

اشتقاق

التحويل + الربط بالمصدر

041 استدعاء

تصدير

التغليف للتوزيع

حدود الأداة

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

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

list_folders

list_artifacts

get_artifact_metadata

read_artifact

write_artifact

create_artifact_version

redact_artifact

derive_artifact

link_artifacts

export_artifact_package

قواعد العمل

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

أنشئ نسخاً جديدة دائماً (لا تكتب فوق النسخ القديمة)
تتبع المصدر (المصدر، المنشئ، خط الأنابيب)
اربط القطع المشتقة بمصادرها
احذف المحتوى الحساس قبل المشاركة الخارجية

حدود التشغيل

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

لا تكتب فوق نسخ القطع الموجودة
لا تخزن بدون بيانات وصفية للمصدر
لا تصدر دون التحقق من المحتوى الحساس

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

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

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

ثبت المهارة

git clone https://github.com/zavora-ai/skill-artifact-lifecycle.git \
  ~/.skills/skills/artifact-lifecycle

شكل تحميل ADK-Rust

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

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

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-artifact-store.

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

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

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

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md التحقق من السلامة ↗scripts/verify_integrity.py بيان القطعة ↗assets/artifact-manifest.md

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