الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt

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

​
مرجع SKILL.md

تتطلب كل قدرة ملف SKILL.md. يتكوّن من جزأين: واجهة YAML العلوية (بيانات وصفية قابلة للقراءة آليًا) ومتن Markdown (تعليمات يقرأها نموذج اللغة).

​
حقول الواجهة العلوية

---
name: my-capability
version: 1.0.0
description: A short description of what this capability does
triggers:
  - keyword1
  - keyword2
  - keyword3
tools:
  - name: my_tool
    description: What this tool does
    parameters:
      type: object
      properties:
        arg1:
          type: string
          description: What arg1 is for
        arg2:
          type: number
          description: What arg2 is for
      required:
        - arg1
danger_patterns:
  - "rm -rf"
  - "sudo"
confirm_patterns:
  - "npm install"
  - "git push"
requires:
  - shell
---

​
مرجع الحقول

الحقلمطلوبالوصف
nameنعممعرّف فريد للقدرة
versionلاإصدار دلالي لمنطق التحديث
descriptionنعموصف قصير يظهر في تعريفات الأدوات
triggersنعمكلمات مفتاحية لمطابقة الصلة في RAS
toolsلاتعريفات الأدوات بتنسيق JSON Schema لواجهة استدعاء الأدوات في نموذج اللغة
danger_patternsلاتعابير نمطية ستقوم amygdala بـ حجبها
confirm_patternsلاتعابير نمطية ستتطلب فيها amygdala موافقة
requiresلاقدرات أخرى تعتمد عليها هذه القدرة

​
مخطط الأدوات

تتبع مصفوفة tools تنسيق JSON Schema القياسي المستخدم في واجهات استدعاء الأدوات في نماذج اللغة. تحتاج كل أداة إلى name وdescription وكائن parameters. 
tools:
  - name: shell_exec
    description: Execute a shell command and return stdout/stderr
    parameters:
      type: object
      properties:
        command:
          type: string
          description: The shell command to execute
        background:
          type: boolean
          description: Run the command detached in the background
      required:
        - command
يجب أن تكون أسماء الأدوات فريدة عبر جميع القدرات المُحمَّلة. إذا عرّفت قدرتان نفس اسم الأداة، فإن الثانية ستستبدل الأولى.

​
أنماط الخطر والتأكيد

هذه تعابير نمطية تُطابق ضد toolName + " " + JSON.stringify(args). تستخدمها amygdala للتحكم في استدعاءات الأدوات.
  • danger_patterns: تُحجب الاستدعاءات المطابقة. يتلقى نموذج اللغة رسالة رفض.
  • confirm_patterns: تُطلق الاستدعاءات المطابقة مربع حوار موافقة في واجهة المستخدم. يجب أن يوافق المستخدم قبل التنفيذ.
تُصنَّف الاستدعاءات التي لا تطابق أي نمط على أنها آمنة وتُنفَّذ فورًا.

​
متن Markdown

كل شيء أسفل --- في الواجهة العلوية هو متن Markdown. يقرؤه نموذج اللغة في وقت التشغيل عندما تكون القدرة ذات صلة. اكتبه كتعليمات مباشرة لنموذج اللغة: 
---
name: git
triggers:
  - git
  - commit
  - branch
  - merge
---

# Git Operations

You have access to git through shell commands. When the user asks about git:

1. Always run `git status` first to understand the current state
2. Use conventional commit format: `type(scope): description`
3. Never force-push without explicit confirmation
4. Show diffs before committing when the user hasn't reviewed changes
متن Markdown هو المكان الذي تُرمّز فيه معرفة الخبراء. اكتب التعليمات كأنك تعلّم مطورًا مبتدئًا ذكيًا كيف يستخدم الأداة بشكل صحيح. كلما كانت التعليمات أفضل، كان أداء الوكيل أفضل.