المهارات الأصلية
المهارات الأصلية أدوات Python داخل العملية تُرفق مع كاظمة وتُسجَّل تلقائيًا على
LocalToolRegistry عند الإقلاع (لا عملية فرعية، لا جولة شبكة — على عكس
خوادم MCP).
تعيش في kazma-skills/kazma_skills/native/ ويكتشفها NativeSkillLoader.
المهارات تُحمَّل دائمًا حتى عند غياب تبعية اختيارية — استدعاء أداة دون تثبيت خلفيتها يعيد سلسلة تلميح تثبيت ودّية بدل الفشل. ثبّت الـ extra لتفعيل الخلفية:
pip install -e ".[document,database,web]".
لقائمة الأدوات الكاملة (أسماء، وسائط، تصنيف الخطر)، انظر كتالوج الأدوات.
أتمتة المتصفح (browser_automation)
Section titled “أتمتة المتصفح (browser_automation)”تحكّم متصفح headless عبر Playwright للصفحات المعروضة بـ JS التي لا يقرأها
جلب HTTP العادي. يتطلّب extra [web] + تثبيت المتصفح مرة واحدة:
pip install -e ".[web]"playwright install chromium| الأداة | الوظيفة |
|---|---|
browser_navigate | فتح رابط، إرجاع العنوان + النص الظاهر |
browser_click | نقر عنصر بمحدّد CSS |
browser_extract_text | استخراج نص العناصر (أو الجسم كاملًا) |
browser_screenshot | لقطة صفحة كاملة → kazma-data/images/ |
browser_fill_form | تعبئة حقول من {selector: value} |
browser_eval_js | تنفيذ JS في الصفحة — HITL كخطر |
سياق Chromium headless مشترك يستمر عبر الاستدعاءات للكفاءة.
التقويم (calendar)
Section titled “التقويم (calendar)”قراءة وإدارة الأحداث. ثلاث خلفيات حسب توفر الاعتمادات:
- Google Calendar — رمز OAuth عبر
GOOGLE_CALENDAR_TOKEN(أوGOOGLE_OAUTH_TOKEN). - Microsoft Outlook (MS Graph) —
MS_CALENDAR_TOKEN(أوMS_GRAPH_TOKEN). - Sandbox — تقويم محلي في الذاكرة (دائمًا متاح؛ للأحداث داخل العملية).
export GOOGLE_CALENDAR_TOKEN=ya29... # or MS_CALENDAR_TOKEN| الأداة | الوظيفة |
|---|---|
list_events | سرد أحداث في نطاق زمني (ISO 8601؛ افتراضي 7 أيام) |
create_event | إنشاء حدث (ملخص، بداية، نهاية، موقع، وصف) |
update_event | تحديث حدث بالمعرّف |
delete_event | حذف حدث بالمعرّف |
find_free_slots | إيجاد فترات حرّة لمدة معيّنة في يوم |
provider="auto" (افتراضي) يختار أول خلفية مُعتمدة، أو ثبّت google / outlook.
توليد المستندات (document_generator)
Section titled “توليد المستندات (document_generator)”إنشاء مستندات من محتوى منظم. يحتاج extra [document]:
pip install -e ".[document]" # reportlab, python-docx, openpyxl| الأداة | المخرج | المكتبة |
|---|---|---|
generate_pdf | .pdf في kazma-data/documents/ | reportlab |
generate_docx | .docx | python-docx |
generate_xlsx | .xlsx (متعدد الأوراق) | openpyxl |
generate_markdown_doc | .md | (بلا اعتماد) |
كل أداة تأخذ عنوانًا + أقسامًا ([{heading, body}])، أو أوراقًا لـ XLSX.
خطوط PDF العربية: generate_pdf تسجّل تلقائيًا خطًا عربيًا (Amiri) مع محاذاة
TA_RIGHT وترابط صحيح. تبحث أولًا في مسارات النظام ثم تحتفظ باحتياطي تحميل Amiri
من مرآة Google Fonts.
توليد الصور
Section titled “توليد الصور”أداة أساسية مدمجة (generate_image في kazma_core/tools/image_gen.py) وليست
مهارة native — خلفيات متعددة عبر image_backends/router.py:
| الخلفية | مفتاح المزوّد | يحتاج |
|---|---|---|
| Pollinations | pollinations | لا شيء (بلا مفتاح، الافتراضي) |
| DALL-E (OpenAI) | dall-e | OPENAI_API_KEY |
| Stability (SDXL) | stability | STABILITY_API_KEY |
| Flux (FAL.ai) | flux | FAL_KEY |
provider="auto" يختار أول خلفية مُعتمدة. تجاوز بـ KAZMA_IMAGE_PROVIDER.
المخرج → kazma-data/images/.
عميل قاعدة البيانات (database_client)
Section titled “عميل قاعدة البيانات (database_client)”استعلام للقراءة فقط. SQLite مدمج؛ Postgres/MySQL/Mongo تحتاج [database]:
pip install -e ".[database]" # psycopg, pymysql, pymongo| الأداة | الوظيفة |
|---|---|
inspect_db_schema | جداول، أعمدة، أنواع، مفاتيح أساسية، فهارس |
execute_db_query | SELECT للقراءة فقط (اللهجة من مخطط URI) |
sqlite_query | اختصار لـ SQLite محلي |
اللهجة من مخطط db_uri: postgresql:// → Postgres، mysql:// → MySQL،
mongodb:// → Mongo، وإلا SQLite. كل لهجات SQL تفرض القراءة فقط
(SELECT/WITH؛ كلمات الكتابة محجوبة).
مهارات أصلية أخرى
Section titled “مهارات أصلية أخرى”| المهارة | الأدوات | ملاحظات |
|---|---|---|
email_manager | email_list/get/send/delete/categorize/analyze | Gmail، MS Graph، IMAP/POP، sandbox |
git_github_manager | git_status/commit/push_pull، github_create_pr/list_issues | |
secret_vault | vault_store/retrieve/list/delete | AES-256-GCM |
advanced_web_crawler | web_search_duckduckgo، crawl_page، parse_document | CSV/JSON/XLS/PDF |
system_health_monitor | get_system_stats، list_active_processes، read_system_logs | |
task_scheduler_cron | schedule_task، list_scheduled، cancel_scheduled | HITL |
environment_bootstrapper | install_python_packages، install_npm_packages، check_environment | HITL |
visual_interpreter_generator | analyze_local_image، generate_ui_mockup | |
arabic_bilingual_nlp | arabic_translate، hijri_convert، insert_diacritics | |
chat_platform_dispatcher | dispatch_notification، send_approval_request، send_message | إشعار متعدد المنصات |
code_analyzer_linter | lint_code، format_code، run_unit_tests | ruff + pytest |
code-review، fix-lint، refactor-file، write-tests | (manifest فقط) | مهارات موجّه/سير عمل |
تأليف مهارتك
Section titled “تأليف مهارتك”انظر إنشاء المهارات و
مواصفة الـ Manifest.
المهارة الدنيا مجلد تحت native/<name>/ مع skill_manifest.yaml وtools.py
(دوال async بأسماء تطابق مفاتيح الـ manifest). الاكتشاف تلقائي — بلا استدعاء تسجيل.