Plugin ورشة المهارات

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

<workspace>/skills/<skill-name>/SKILL.md

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

• كيفية التحقق من أصول GIF المتحركة المستوردة من مصادر خارجية
• كيفية استبدال أصول لقطات الشاشة والتحقق من الأبعاد
• كيفية تشغيل سيناريو ضمان جودة خاص بالمستودع
• كيفية تصحيح فشل متكرر لمزوّد
• كيفية إصلاح ملاحظة سير عمل محلية قديمة

• حقائق مثل “المستخدم يفضّل اللون الأزرق”
• ذاكرة ذاتية واسعة
• أرشفة نصوص المحادثات الخام
• الأسرار، أو بيانات الاعتماد، أو نص المطالبة المخفي
• تعليمات لمرة واحدة لن تتكرر

​

الحالة الافتراضية

• الـ Plugin مدعوم بما يكفي للاختبار الاختياري والاستخدام الداخلي
• يمكن أن يتطور تخزين المقترحات، وعتبات المراجعة، واستدلالات الالتقاط
• الموافقة المعلّقة هي وضع البدء الموصى به
• التطبيق التلقائي مخصص لإعدادات شخصية/مساحات عمل موثوقة، وليس للبيئات المشتركة أو العدائية كثيفة الإدخال

​

التفعيل

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "pending",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

• تصبح أداة skill_workshop متاحة
• تُضاف التصحيحات الصريحة القابلة لإعادة الاستخدام إلى قائمة انتظار كمقترحات معلّقة
• يمكن لتمريرات المراجع المعتمدة على العتبات اقتراح تحديثات للمهارات
• لا يُكتب أي ملف مهارة حتى يُطبّق مقترح معلّق

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "auto",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

​

التكوين

// Conservative: explicit tool use only, no automatic capture.
{
  autoCapture: false,
  approvalPolicy: "pending",
  reviewMode: "off",
}

// Review-first: capture automatically, but require approval.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "hybrid",
}

// Trusted automation: write safe proposals immediately.
{
  autoCapture: true,
  approvalPolicy: "auto",
  reviewMode: "hybrid",
}

// Low-cost: no reviewer LLM call, only explicit correction phrases.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "heuristic",
}

​

مسارات الالتقاط

​

اقتراحات الأداة

​

الالتقاط بالاستدلال

• next time
• from now on
• remember to
• make sure to
• always ... use/check/verify/record/save/prefer
• prefer ... when/for/instead/use
• when asked

• مهام GIF المتحركة -> animated-gif-workflow
• مهام لقطات الشاشة أو الأصول -> screenshot-asset-workflow
• مهام ضمان الجودة أو السيناريوهات -> qa-scenario-workflow
• مهام PR في GitHub -> github-pr-workflow
• المسار الاحتياطي -> learned-workflows

​

مراجع LLM

• نص المحادثة الأخيرة، محدودًا بآخر 12,000 حرف
• ما يصل إلى 12 مهارة حالية في مساحة العمل
• ما يصل إلى 2,000 حرف من كل مهارة حالية
• تعليمات JSON فقط

• disableTools: true
• toolsAllow: []
• disableMessageTool: true

{
  "action": "create",
  "skillName": "media-asset-qa",
  "title": "Media Asset QA",
  "reason": "Reusable animated media acceptance workflow",
  "description": "Validate externally sourced animated media before product use.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution.\n- Store a local approved copy.\n- Verify in product UI before final reply."
}

​

دورة حياة المقترح

• id
• createdAt
• updatedAt
• workspaceDir
• agentId اختياري
• sessionId اختياري
• skillName
• title
• reason
• source: tool، أو agent_end، أو reviewer
• status
• change
• scanFindings اختياري
• quarantineReason اختياري

• pending - ينتظر الموافقة
• applied - كُتب إلى <workspace>/skills
• rejected - رُفض بواسطة المشغّل/النموذج
• quarantined - حُظر بسبب نتائج فحص حرجة

<stateDir>/skill-workshop/<workspace-hash>.json

​

مرجع الأداة

skill_workshop

​

status

{ "action": "status" }

{
  "workspaceDir": "/path/to/workspace",
  "pending": 1,
  "quarantined": 0,
  "applied": 3,
  "rejected": 0
}

​

list_pending

{ "action": "list_pending" }

{ "action": "list_pending", "status": "applied" }

• pending
• applied
• rejected
• quarantined

​

list_quarantine

{ "action": "list_quarantine" }

​

inspect

{
  "action": "inspect",
  "id": "proposal-id"
}

​

suggest

{
  "action": "suggest",
  "skillName": "animated-gif-workflow",
  "title": "Animated GIF Workflow",
  "reason": "User established reusable GIF validation rules.",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify the URL resolves to image/gif.\n- Confirm it has multiple frames.\n- Record attribution and license.\n- Avoid hotlinking when a local asset is needed."
}

{
  "action": "suggest",
  "apply": true,
  "skillName": "animated-gif-workflow",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution."
}

{
  "action": "suggest",
  "apply": false,
  "skillName": "screenshot-asset-workflow",
  "description": "Screenshot replacement workflow.",
  "body": "## Workflow\n\n- Verify dimensions.\n- Optimize the PNG.\n- Run the relevant gate."
}

{
  "action": "suggest",
  "skillName": "qa-scenario-workflow",
  "section": "Workflow",
  "description": "QA scenario workflow.",
  "body": "- For media QA, verify generated assets render and pass final assertions."
}

{
  "action": "suggest",
  "skillName": "github-pr-workflow",
  "oldText": "- Check the PR.",
  "newText": "- Check unresolved review threads, CI status, linked issues, and changed files before deciding."
}

​

apply

{
  "action": "apply",
  "id": "proposal-id"
}

quarantined proposal cannot be applied

​

reject

{
  "action": "reject",
  "id": "proposal-id"
}

​

write_support_file

• references/
• templates/
• scripts/
• assets/

{
  "action": "write_support_file",
  "skillName": "release-workflow",
  "relativePath": "references/checklist.md",
  "body": "# Release Checklist\n\n- Run release docs.\n- Verify changelog.\n"
}

​

كتابات Skill

<workspace>/skills/<normalized-skill-name>/

• تحويلها إلى أحرف صغيرة
• تصبح تتابعات غير [a-z0-9_-] على شكل -
• تزال الأحرف غير الأبجدية الرقمية في البداية/النهاية
• الحد الأقصى للطول هو 80 حرفًا
• يجب أن يطابق الاسم النهائي [a-z0-9][a-z0-9_-]{1,79}

• إذا لم تكن Skill موجودة، يكتب Skill Workshop ملف SKILL.md جديدًا
• إذا كانت موجودة بالفعل، يضيف Skill Workshop المتن إلى ## Workflow

• إذا كانت Skill موجودة، يضيف Skill Workshop إلى القسم المطلوب
• إذا لم تكن موجودة، ينشئ Skill Workshop Skill دنيا ثم يضيف إليها

• يجب أن تكون Skill موجودة بالفعل
• يجب أن يكون oldText موجودًا تمامًا
• يستبدل أول تطابق تام فقط

​

نموذج السلامة

• تحتفظ بـ scanFindings
• تحتفظ بـ quarantineReason
• تظهر في list_quarantine
• لا يمكن تطبيقها عبر apply

​

إرشادات المطالبة

• الإجراءات، وليس الحقائق/التفضيلات
• تصحيحات المستخدم
• الإجراءات الناجحة غير البديهية
• العثرات المتكررة
• إصلاح Skills القديمة/الرقيقة/الخاطئة عبر الإضافة/الاستبدال
• حفظ الإجراء القابل لإعادة الاستخدام بعد حلقات أدوات طويلة أو إصلاحات صعبة
• نص Skill قصير بصيغة الأمر
• عدم تفريغ النصوص الحوارية

• وضع الانتظار: ضع الاقتراحات في قائمة الانتظار؛ استخدم apply بعد موافقة صريحة
• الوضع التلقائي: طبّق تحديثات Skills الآمنة في مساحة العمل ما لم يجعل apply: false ذلك في قائمة الانتظار بدلًا من ذلك

​

التكاليف وسلوك وقت التشغيل

• يستخدم سياق المزوّد/النموذج نفسه عند توفره
• يعود إلى افتراضيات وكيل وقت التشغيل
• لديه reviewTimeoutMs
• يستخدم سياق تمهيد خفيفًا
• لا يملك أدوات
• لا يكتب شيئًا مباشرة
• يمكنه فقط إصدار مقترح يمر عبر الماسح العادي ومسار الموافقة/العزل

​

أنماط التشغيل

• “next time, do X”
• “from now on, prefer Y”
• “make sure to verify Z”
• “save this as a workflow”
• “this took a while; remember the process”
• “update the local skill for this”

## Workflow

- Verify the GIF URL resolves to `image/gif`.
- Confirm the file has multiple frames.
- Record source URL, license, and attribution.
- Store a local copy when the asset will ship with the product.
- Verify the local asset renders in the target UI before final reply.

The user asked about a GIF and I searched two websites. Then one was blocked by
Cloudflare. The final answer said to check attribution.

• على شكل نص حواري
• ليست بصيغة الأمر
• تتضمن تفاصيل مزعجة لمرة واحدة
• لا تخبر الوكيل التالي بما يجب فعله

​

تصحيح الأخطاء

openclaw plugins list --enabled

{ "action": "status" }

{ "action": "list_pending" }

{ "action": "list_quarantine" }

• skill-workshop: queued <skill>
• skill-workshop: applied <skill>
• skill-workshop: quarantined <skill>
• skill-workshop: heuristic capture skipped: ...
• skill-workshop: reviewer skipped: ...
• skill-workshop: reviewer found no update

​

سيناريوهات QA

• qa/scenarios/plugins/skill-workshop-animated-gif-autocreate.md
• qa/scenarios/plugins/skill-workshop-pending-approval.md
• qa/scenarios/plugins/skill-workshop-reviewer-autonomous.md

pnpm openclaw qa suite \
  --scenario skill-workshop-animated-gif-autocreate \
  --scenario skill-workshop-pending-approval \
  --concurrency 1

pnpm openclaw qa suite \
  --scenario skill-workshop-reviewer-autonomous \
  --concurrency 1

​

متى لا تفعّل التطبيق التلقائي

• تحتوي مساحة العمل على إجراءات حساسة
• يعمل الوكيل على إدخال غير موثوق
• تتم مشاركة Skills عبر فريق واسع
• ما زلت تضبط المطالبات أو قواعد الماسح
• يتعامل النموذج كثيرًا مع محتوى ويب/بريد إلكتروني عدائي

​

المستندات ذات الصلة

• Skills
• Plugins
• الاختبار