نظام المهارات
والمهارات هي مجموعات من القدرات للوكلاء: فالمهارات العامة الغرض، مثل توليد وثائق المكتب، مهيأة مسبقا، ويمكن تركيب المزيد منها من سوق المهارة وممكنة أو معوقة لكل مستخدم.
A Skill is a capacity package for an agent: a directory built around a SKILL.md file, containing instructions, scripts, and reference material. وكيل يقرأ هذه عند الطلب بينما يُدير مهمّة، يُمكّنها من فعل شيء ما... لمْ يكن بوسعها... أن تُولّد وثيقة وورد مع طاولة محتويات و عناوين.
يا لها من مهارة
كل مهارة هي دليل يحتوي على حد أدنى على (سكايلل) حرف الواجهة يحمل الاسم والوصف والجسد هو التعليمات التي يقرأها Agent ويمكن أن يشمل الدليل أيضاً ملحقات (المحاضر، والكتب المرجعية، ونماذج التداول) وأن يعلن عن مُعالي الموظفين وخواديم برنامج المقارنات المتعددة الكلور.
---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---
# 使用说明
正文写给 Agent 看:什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。تستخدم المهارات الإفصاح التدريجي: عادة ما يرى Agent فقط اسم كل مهارة ووصفها، ويقرأ في كامل الجسم والملحقات فقط عندما يقرر أن المهارات تنطبق على المهمة الحالية. بهذه الطريقة، حتى مع العديد من المهارات، ليس كل شيء يتم تحميله في كل محادثة.
فالمهارات والنماذج هي أمور مختلفة: فالوحدة هي جزء من تدفق العمل يمكن إعادة استخدامه، يستدعيه تدفق آخر للعمل عن طريق تدفق العمل الفرعي؛ والمهارة هي مجموعة من المعارف والكتابات التي يستخدمها الوكيل داخل خطوة واحدة، دون تغيير هيكل تدفق العمل. انظروحدة بناء مكتبة.
مهارات النظام والمهارات التي يكتسبها المستخدمون
| النوع | المصدر | من يستطيع رؤيته | ما يمكن القيام به |
|---|---|---|---|
| مهارات النظام | Preinstalled by the platform | جميع المستعملين | القراءة فقط، لا يمكن حذفها، يمكنك تعطيلها على حسابك الخاص |
| مهارات المستعملين | Installed from the skills marketplace or imported from ZIP | فقط الشخص الذي ركبها | يمكن تمكينها/تشويهها، ورفع مستواها، وغير مكتملة |
وتندرج مهارات نظام الأغراض العامة المأخوذة مسبقاً في فئتين رئيسيتين: توليد وثائق المكتب (Docx / xlsx / pptx / pdf) ومهارات التنمية (الواجهة، والحزمة الكاملة، و iOS، و Android, Flutter, React Native, and more). وتظهر صفحة إدارة المهارات في المجموعة القائمة الكاملة، وفتح أي مهارة يكشف عن نسختها وملحقاتها ورموزها بالكامل.
توليد الوثائق المكتبية
هذه المجموعة من مهارات النظام تسمح للعميل بأن يُنتج ملفات مستندات مكتبية مباشرةً، وليس فقط نص "ماركداون"
| المهارات | القدرة |
|---|---|
docx | وثائق الإنشاء والتحرير: المستويات العليا، جداول المحتويات، الجداول، إدخال الصور، العثور على التغييرات واستبدالها وتتبعها، والتعليقات |
xlsx | إنتاج صحائف إكسيل مع شكل وصيغ، وقراءة، وتنظيف البيانات الموجودة في صحيفة البيانات، ووضع الخرائط |
pptx | إنتاج شرائح من الخدش، أو تحرير عرض نموذجي قائم واستخلاص نصه |
pdf | Extract text and tables from PDFs, merge and split, add watermarks, and fill PDF forms |
استخدام نموذجي: خطوة Agent في سير العمل اليومي في مجال تقديم التقارير تستخدم مهارة اكسليكس لإنتاج ورقة أسبوعية مصممة، محملة بالقطع الأثرية للتنفيذ أو تسليمها مباشرة إلى سلاك أو البريد الإلكتروني. ويمكن أيضا نشر القطع الأثرية كوصلات عامة؛ انظرالمشاركة الصناعية العامة.
سوق المهارات: تركيب ونسخ
The ClawHub Skill Marketplace page in the console connects to the ClawHub registry. البحث بالكلمات الرئيسية، والنظر في نسخة كل مهارة، المؤلف، عدد تحميل، وآخر تحديث، والنقر في تركيب لإضافة ذلك إلى حسابك.
# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
-H "Authorization: Bearer <token>"
# 安装(安装状态只记在你自己的账号下)
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
-H "Authorization: Bearer <token>"
# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
-H "Authorization: Bearer <token>"- المهارات تحمل أرقام النسخ. بالنسبة للمهارات التي تم تركيبها، يرجى الاطلاع على آخر المستجدات في صفحة إدارة المهارات؛ والارتقاء بتحميل آخر نسخة
- فالمهارات التي تم تركيبها من السوق هي وحدها التي تمر بتدفقات الترفيع؛ فالمهارات التي تستورد من شركة ZIP ليس لها أي إعادة تحديث للمصدر فقط
- التثبيت يزيل فقط المهارة من حسابك ولا يؤثر على المستخدمين الآخرين الذين قاموا بتركيب نفس المهارة
- يمكنك أيضاً تحميل (زي بي) لاستيراد مهارة كتبتها بنفسك: يجب أن تحتوي الحزمة على (شيلد) مع حقول الاسم والوصف الصحيحة
وتأتي مهارات السوق من المؤلفين من أطراف ثالثة. قبل تركيبها، قراءتها من خلال SKILL.md على الصفحة التفصيلية لتأكيد أي النصوص والمكالمات الخارجية ستجعل Agent يهرب.
المستفيد/المعوق لكل مستخدم
كل مهارة في صفحة إدارة المهارات لها منافستها الخاصة الدولة المُمكنة/المُشوّهة تُسجّل على حسابك: عندما تُبطل مهارة النظام، لم يعد مرئياً لعُملاءك، بينما المُستخدمون الآخرون غير مُتأثرين. المهارات الخاصة التي يركبها مستعملون آخرون ليست مرئية لك ولا محشوة لك.
نطاق Agent: تحديد المهارات التي يمكن أن يستخدمها Agent
بعد النظارات على مستوى الحساب يمكنك تحديد نطاق أضيق لمهارة عميل واحد في تشكيله المجالات المشتركة:
- نظام المهارات الفرعي لإيقاف تشغيله وهذا Agent لا يستخدم أي مهارات على الإطلاق
- ولا يمكن لهذا الوكيل أن يكتشف سوى المهارات المسموح بها في القائمة، ويضاف إلى القائمة المسموح بها بصورة تلقائية المهارات القائمة
- قائمة غير قابلة للحذف - قائمة منكرة لا تزال سارية عندما تكون طريقة التسجيل غير متاحة
- الحد الأقصى للمهارات حسب الطلب - الحد الأقصى لعدد المهارات التي تحقن في طلب واحد
- التفتيش والتنزيل الآليين عن طريق التقصير؛ وعندما يحدث ذلك، يقوم الوكيل تلقائياً بتفتيش كلاو هوب وتحميل مهارات جديدة عندما يجد قدرة مفقودة محلياً. This introduces external downloads, so use it with caution in enterprise settings
وفي وقت التنفيذ، يدمج المنصّة تشكيلة Agent مع حالتك على مستوى المستعمل في نطاق المهارة الفعّال: فالمهارة التي عاقتها في صفحة إدارة المهارات غير متاحة لكل عميل في ذلك التنفيذ.
تشكيلة الموظفين
وتحتاج بعض المهارات إلى المعلمات أو وثائق تفويض تم ملؤها قبل أن تعمل، من قبيل مدخل مخصص لخدمة طرف ثالث. وتظهر مهارة مع نموذج للثقة أو غير مثبتة على بطاقتها؛ ونقر سكايل المؤمنة وملء الحقول.
- الحقول الحساسة (الكلب، كلمة السر، المفتاح الخاص، وما إلى ذلك) مُقنعة بعد حفظ ولم تظهر أبداً في النص السهري؛ إن تقديم القناع بدون تغيير يبقي القيمة القديمة
- يمكنك تحديد المهارات التي قمت بتركيبها بنفسك، فقط المديرون يمكنهم تغيير التشكيل الزمني لمهارات النظام
نقاط النهاية المشتركة
| نقطة النهاية | الغرض |
|---|---|
GET /api/skills | قائمة بكل المهارات المرئية لك |
GET /api/skills/{name} | Skill details, including the full SKILL.md and attachment list |
PUT /api/skills/{name}/toggle | غير قابل للتصرف على حسابك الخاص |
GET /api/skills/market/search | ابحث عن سوق كلاوهوب للمهارة |
POST /api/skills/market/{slug}/install | اثبت لحسابك الخاص |
POST /api/skills/market/{slug}/upgrade | ترقية إلى آخر نسخة |
DELETE /api/skills/market/{slug} | Uninstall |
POST /api/skills/import | تحميل زي بي لاستيراد مهارة |