عن المشروع

## ما هي هذه المكتبة هذا المستودع هو مكتبة الوحدات الرسمية لـ start CLI. يقوم بجمع وحدات CUE التي تصف وكلاء الذكاء الاصطناعي (AI agents)، والأدوار، والسياقات، والمهام، والمهارات، وينشرها في CUE Central Registry تحت المسار `github.com/p3bot/library` حتى يتمكن CLI من تحليلها أثناء التشغيل. ## الهيكل يوثق ملف README المجلدات الرئيسية التالية: - `agents/` – قوالب الأوامر لأدوات AI CLI - `roles/` – تعريفات سلوك ومطالبات النظام (system prompt) - `contexts/` – تعريفات السياق البيئي - `tasks/` – تعريفات تعليمات المهام - `skills/` – مهارات الوكيل، كل منها عبارة عن `SKILL.md` مع موارد اختيارية - `schemas/` – تعريفات مخطط CUE schema - `index/` – فهرس اكتشاف الوحدات - `docs/` – كتالوجات التسمية والنشر والتأليف والأنماط ## كيفية استخدام الوحدات يمكن استيراد الوحدات مباشرة في CUE، على سبيل المثال: ```cue import "github.com/p3bot/library/roles/golang/assistant@v0" ``` والأكثر شيوعاً هو استهلاكها بشكل غير مباشر من خلال start CLI: ``` start --role golang/assistant start task review/pre-commit ``` ## نظام العناوين تأخذ العناوين المؤهلة بالكامل والموجهة للمستخدم شكل `category:name` مثل `agents:claude/interactive` أو `roles:golang/assistant` أو `contexts:cwd/agents-md` أو `tasks:review/pre-commit` أو `skills:finding/one-by-one`. تعمل الأسماء المجردة بدون بادئة `:category` كعمليات بحث عبر الفئات. يشير ملف README إلى أن مسارات الوحدات في استيرادات CUE تظل تعتمد على الشرطة المائلة (slash)، بينما ينطبق شكل النقطتين الرأسيتين فقط على إدخال المستخدم والعرض. ## التوثيق المرجعي توجه المكتبة القراء إلى `docs/naming.md` (اتفاقيات التسمية)، و `docs/publishing.md` (النشر في CUE Central Registry)، و `docs/authoring.md` (إنشاء أو تحديث وحدة)، و `docs/agent-patterns.md` و `docs/role-patterns.md` (أنماط التأليف)، بالإضافة إلى مرجع المخطط في `schemas/README.md`. ## الترخيص MPL-2.0.