شرح TrueFoundry Skills Registry: إدراة إصدارات المعرفة الإجرائية عبر الوكلاء

تغلف المهارات (Skills) التعليمات والمراجع والبرامج النصية (scripts) والأصول في إجراءات قابلة لإعادة الاستخدام. ويجعل السجل (registry) هذه الحزم قابلة للاكتشاف ومدارة الإصدارات—ولكنه لا يجعلها موثوقة تلقائيًا.

المهارة هي حزمة من الإجراءات، وليست إذنًا جديدًا

تصف مهارة الوكيل (agent skill) كيفية تنفيذ مهمة متكررة. ويحتوي ملف SKILL.md الرئيسي الخاص بها على اسم، ووصف موجه نحو الإجراءات، والإجراء نفسه. ويمكن أن تتضمن الحزمة الأكثر ثراءً مواد مرجعية، وبرامج نصية (scripts)، وأصولًا. يفصل هذا الهيكل المعرفة الإجرائية عن موجه النظام الشامل (monolithic system prompt) ويسمح لوقت التشغيل (runtime) بتحميل التفاصيل فقط عندما تكون المهارة ذات صلة.

التمييز بين المعرفة والسلطة أمر بالغ الأهمية. فمن الممكن لمهارة أن تخبر الوكيل بكيفية الاستعلام عن مستودع البيانات، أو توجيه حادثة (incident triage)، أو صياغة ملاحظات الإصدار. ولكنها لا تمنح، بنفسها، إمكانية الوصول إلى قاعدة البيانات، أو تفويض الاستجابة للحادثة، أو جعل ملاحظة الإصدار المنشأة صحيحة. وتظل الأدوات (tools)، وبيانات الاعتماد (credentials)، وسياسة البوابة (gateway policy)، والأنظمة اللاحقة هي مسار السلطة.

يمنح Skills Registry الخاص بـ TrueFoundry الحزمة هوية مشتركة. تعيش المهارات في المستودعات (Repositories)، وتضمحل وتتوارث صلاحيات الوصول للمستودع وسجل الإصدارات، وتُعنون بواسطة أسماء مؤهلة بالكامل (FQNs) مرقمة. يمكن للفرق النشر مرة واحدة وإعادة استخدام الحزمة في TrueFoundry Agents، أو Claude Code، أو Cursor.

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

التكشف التدريجي هو تصميم وقت التشغيل

توضح وثائق TrueForge أن المهارة المرفقة تساهم فقط باسمها ووصفها في سياق النموذج الأولي. ويتم قراءة جسم ملف SKILL.md بالكامل عند الطلب من البيئة المعزولة (sandbox) عندما يقرر الوكيل أن المهارة ذات صلة. وهذا يقلل من السياق الأولي مع الحفاظ على الإجراء متاحًا.

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

يتحكم التحميل التدريجي في حجم السياق؛ ولكنه لا يعزل المحتوى غير الموثوق به. بمجرد التحديد، يؤثر جسم المهارة والملفات الداعمة على الوكيل. يمكن للبرامج النصية (scripts) التنفيذ داخل البيئة المعزولة المهيأة، ويمكن للمراجع أن تشكل استخدام الأدوات. تعامل مع المهارة متعددة الملفات كمنتج برمجي يخضع لسلسلة التوريد.

ثلاثة مسارات للنشر، ومادة واحدة مدارة الإصدارات

توضح وثائق TrueFoundry ثلاثة مسارات للنشر. تنشئ واجهة المستخدم UI مهارة أحادية الملف يكون جسمها هو محتوى SKILL.md الذي تم تأليفه في المحرر. وتستخدم الحزم متعددة الملفات أمر الرفع عبر CLI أو بيانًا تصريحيًا (declarative manifest) يتم تطبيقه من خلال GitOps. تنشئ جميع المسارات مهارة مدارة الإصدارات تحت مستودع وتنتج FQN مثل مهارة مؤهلة بالمستودع في الإصدار 1.

تدعم واجهة المستخدم UI حاليًا ملف SKILL.md أحادي فقط. تتطلب المراجع والبرامج النصية والأصول مسار CLI أو GitOps؛ وتم توثيق دعم المهارات متعددة الملفات في واجهة المستخدم UI كخارطة طريق مستقبلية. يتحقق CLI من البيانات التمهيدية (frontmatter) ويرفع الحزمة. يوجه GitOps البيان التصريحي إلى دليل مهارة محلي وينشر من خلال نفس سير عمل التطبيق (apply workflow) المستخدم لموارد TrueFoundry الأخرى.

تختلف مسارات النشر من الناحية التشغيلية ولكنها تتجمع في نفس المستودع وهُوية الإصدار. تتيح تلك الهُوية للوكلاء وأسطح البرمجة المحلية استهلاك حزمة ملموسة بدلاً من نسخة غير رسمية.

الوصول إلى المستودع موروث

لا تحتوي المهارات على أذونات منفصلة لكل مهارة في النموذج الموثق. تأتي حقوق الاكتشاف والتعديل والاستخدام من المستودع (Repository) الأب. وهذا يجعل حدود المستودع هي الوحدة العملية للحوكمة. قم بتجميع المهارات حسب الملكية والحساسية المتوافقة بدلاً من وضع كل إجراء في كتالوج واحد يمتلك صلاحيات وصول واسعة.

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

تثبيت الإصدار (Version pinning) هو أساس التكرارية والإعادة

تتطلب وثائق Skills CLI إصدار عدد صحيح موجب عند التنزيل وتذكر أن الاسم المستعار latest غير مدعوم. هذه خاصية تشغيلية مفيدة: يحدد المستهلكون حزمة ملموسة. قم بتثبيت نفس الإصدار الملموس في تكوين الوكيل وبيئات المطورين المحلية عندما تحتاج إلى سلوك قابل للمقارنة.

لا يزال الإصدار بحاجة إلى مصدر معروف (provenance). قم بتسجيل التزام (commit) المستودع المصدر، والناشر، وعملية البناء أو التجميع، وملخصات الملفات (file digests)، والتبعيات، ونتيجة المراجعة. بالنسبة للبرامج النصية، قم بتثبيت الحزم الخارجية وسجل بيئة التنفيذ. يحدد FQN المرقم ما تم تخزينه في السجل؛ بينما يشرح المصدر كيفية إنتاج تلك الحزمة.

تنشئ البرامج النصية والمراجع مخاطر مختلفة

يمكن أن تكون الملفات المرجعية قديمة أو غير مكتملة أو معدلة بشكل ضار. يمكن للبرامج النصية قراءة البيانات وتحويلها، أو استدعاء الأوامر المحلية، أو طلب الخدمات من خلال الواجهات المتاحة. يمكن أن تحتوي الأصول على محتوى نشط أو مشوه. قم بمراجعة كل فئة باستخدام عنصر التحكم المناسب بدلاً من التعامل مع الدليل على أنه Markdown غير متمايز.

يمكن للفحوصات الاستاتيكية (Static checks) التحقق من البيانات التمهيدية (frontmatter)، والعبور بين المسارات (path traversal)، وهيكل الأرشيف، وحجم الملف، والملفات الثنائية المحظورة، وإعلانات التبعية، والأنماط الخطرة المعروفة. ويمكن للاختبارات داخل البيئة المعزولة (sandboxed tests) تشغيل البرامج النصية بمدخلات اصطناعية ومنع الوصول إلى الشبكة. كما يمكن لتقييمات المهام قياس ما إذا كان الوكيل يحدد المهارة ويتبع قيودها. ويجب أن تركز المراجعة البشرية على الإجراءات ذات الصلاحيات المرتفعة والأفعال غير القابلة للعكس.

يفصل خط أنابيب القبول (admission pipeline) بين التخزين، والتفتيش، وأداء المهام، والتفويض في وقت التشغيل. ولا يوجد فحص واحد يعتمد كل خاصية للمهارة.

يجب أن يأخذ الترقية مستهلك المهارة في الاعتبار

يمكن استخدام نفس المهارة بواسطة TrueFoundry Agent، وClaude Code، وCursor، ولكن هذه الأسطح لا تتشارك بالضرورة في النماذج، أو الأدوات، أو البيئات المعزولة، أو هُوية المستخدم نفسها. إن قابلية نقله الهيكل لا تعني تكافؤ سلوك وقت التشغيل. اختبر المهارة في كل سطح مدعوم وسجل البيئة في النتيجة.

فالمهارة الآمنة عند إقرانها بأدوات MCP للقراءة فقط قد تكون غير آمنة عندما تعرض بيئة البرمجة المحلية صلاحية الكتابة وأوامر الشل (shell commands). يجب أن تذكر البيانات الوصفية للإصدار تبعيات الأدوات المتوقعة، والأذونات المطلوبة، وإصدارات وقت التشغيل المتوافقة، والبيئات المحظورة.

دورة حياة منضبطة للمهارة

ابدأ بمهمة ضيقة ووصف يجعل التحديد قابلاً للاختبار. قم بتأليف الإجراء مع تحديد الشروط المسبقة الصريحة، والأدوات المسموح بها، ومتطلبات الأدلة، ومعالجة الأخطاء، وقواعد التوقف. انشر إصدارًا مرشحًا. قم بإجراء الاختبارات الاستاتيكية والبيئة المعزولة والسلوكية. اعتمد المهارة للمستهلكين المحددين. راقب التحديد، واستخدام الأدوات، والإخفاقات، والنتائج. قم بإيقاف (retire) الإصدار عن طريق إزالة المستهلكين وصلاحيات الوصول، ثم احتفظ بالأدلة المطلوبة بموجب السياسة.

لا تقم بتعديل مهارة مستخدمة على نطاق واسع في مكانها من خلال التوزيع غير الرسمي للملفات. انشر إصدارًا جديدًا، واعرض الفروقات (diff) للحزمة الكاملة، وقم بتمرير المستهلكين بشكل متعمد. عند العثور على ثغرة أمنية في برنامج نصي أو مرجع، حدد كل وكيل ومسطح مطور مستهلك من خلال مخزون الإصدارات.

الإصدارات المرقمة هي هُويات، وليست وعودًا بالتوافق

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

انشر البيانات الوصفية للتوافق إلى جانب الحزمة: وقت التشغيل المتوقع، والأدوات المطلوبة، وعقود المدخلات والمخرجات المدعومة، وإصدارات التبعية، وتصنيفات البيانات، وعمليات ترحيل البيانات المعروفة. بالنسبة للتغييرات الجوهرية (breaking changes)، حافظ على إتاحة الإصدار السابق لوقت كافٍ يتيح للمستهلكين الانتقال بشكل متعمد. تجنب تعليم الوكلاء تنزيل حزمة "latest" متغيرة في وقت التشغيل؛ بل قم بحل الرقم المعتمد أثناء الإصدار.

الجرد ضروري للاستجابة للحوادث

عندما يصبح المرجع خاطئًا أو يتم اختراق تبعية برنامج نصي، يحتاج المستجيبون إلى الإجابة عن سؤالين بسرعة: ما هي الإصدارات التي تحتوي على المشكلة، وأين تُستخدم تلك الإصدارات؟ توفر هُوية السجل الركيزة الأولى، ولكن جرد المستهلكين يجب أن يشمل TrueFoundry Agents وأي تثبيتات محلي لـ Claude Code أو Cursor تم مزامنتها من السجل.

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

تقييم النتيجة يجب أن يتبع الإجراء

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

قم بتخزين FQN للمهارة مع كل تقييم وأثر وقت التشغيل (runtime trace). يتيح ذلك للفرق مقارنة الإصدارات، واكتشاف التراجع (regression)، وتحديد ما إذا كان الفشل يعود إلى المهارة، أو النموذج، أو الأداة، أو البيانات، أو السياسة المحيطة. بدون رابط الإصدار، يصبح من المستحيل حوكمة الإجراء المشترك على نطاق واسع.

اختبارات الفشل التي تستحق الاحتفاظ بها

• استخدم موجهات يجب ولا يجب أن تحدد المهارة؛ وقم ببيان التحديد الخاطئ والتحديد المفقود.
• انشر حزمة متعددة الملفات تحتوي على مسارات غير متوقعة، ووصلات رمزية (symlinks)، وملفات ضخمة، وتبعيات غير معلنة.
• قم بتغيير برنامج نصي أو مرجع داعم فقط؛ وتأكد من أن فرق الحزمة وتغيير الإصدار يكشفان ذلك.
• قم بتشغيل نفس الإصدار عبر الأسطح المدعومة وقارن بين وصول الأدوات وسلوكها.
• قم بإلغاء وصول استخدام المستودع وتأكد من أن المستهلكين لا يمكنهم استرداد نسخة جديدة.
• قم بإزالة مهارة من وكيل مع ترك الوصول إلى الأدوات سليمًا؛ وتأكد من فهم هذا التمييز.
• قم بإيقاف إصدار يحتوي على ثغرة أمنية وجرد كل مستهلك مثبت قبل إعلان اكتمال المعالجة.

كيف يتكامل Skills Registry وTrueForge معًا

إن Skills Registry هو سطح التوزيع والحوكمة لحزم الإجراءات مدارة الإصدارات. وTrueForge هو وقت التشغيل الذي يعرض البيانات الوصفية للمهارات المرفقة، ويحمل الإجراء الكامل عند الطلب، وينفذ الأعمال الداعمة من خلال بيئته المعزولة وأدواته. وتحكم AI Gateway وMCP Gateway حركة مرور النماذج والأدوات حول وقت التشغيل هذا.

لا تعتمد أي من هذه الطبقات الإجراء بمفردها. إن قصة المنصة المفيدة هي تركيبية: إذ يمكن لهُوية السجل والوصول إلى المستودع، وإدارة سياق وقت التشغيل، وتفويض الأدوات، والأدلة أن تصطف جميعها حول نفس إصدار المهارة المظبوط.

الصحيفة التشغيلية

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

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

المراجع

1. TrueFoundry — AI Gateway Skills Registry.
2. TrueFoundry — Create, Manage, and Use Skills.
3. TrueForge — Skills.
4. TrueForge — Harness Capabilities.

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

‍