الميزات المتقدمة
ميزات معقدة وتنسيق متعدد الوكلاء
ما ستتعلمه
يغطي هذا القسم إمكانيات المستخدم المتقدم في Verdent، بما في ذلك إدارة الوكلاء الفرعيين، وأنظمة القواعد، وتكامل الأدوات المخصصة، وخيارات القابلية للتوسيع المتقدمة.
شرح الميزات المعقدة
يقدّم Verdent for VS Code ميزات متطورة تُمكّن سير عمل تطوير متقدم يتجاوز توليد الكود الأساسي.
نظام الوكلاء الفرعيين
وكلاء ذكاء اصطناعي متخصصون:
يتضمن Verdent وكلاء فرعيين مدمجين (@Verifier، @Explorer، @Code-reviewer) يعملون بنوافذ سياق منعزلة وتوجيهات نظام مخصصة. كل وكيل فرعي متخصص في مهام معينة مثل استكشاف الكود، أو التحقق، أو مراجعة الجودة.
التفويض التلقائي واليدوي: يوجّه الوكيل الرئيسي المهام تلقائيًا إلى الوكلاء الفرعيين المناسبين بناءً على أنماط الطلب، أو يمكن للمستخدمين تحديد الوكلاء الفرعيين يدويًا باستخدام إشارات @. يحافظ هذا التفويض على السياق الرئيسي مع التعامل بكفاءة مع العمليات المتخصصة.
وكلاء فرعيون مخصصون:
أنشئ وكلاء فرعيين خاصين بالمشروع من خلال تعريف ملفات Markdown مزودة بترويسة YAML في ~/.verdent/subagents/. يمكن للوكلاء الفرعيين المخصصين التخصص في خبرة مجال معين، أو سير عمل الفريق، أو تحسينات خاصة بتقنية معينة.
اطّلع على مزيد من المعلومات حول إدارة الوكلاء الفرعيين
أنظمة القواعد
تخصيص السلوك: توجّه ملفات القواعد سلوك Verdent وتنسيق المخرجات وعملية اتخاذ القرار من خلال مستندات Markdown نصية بسيطة. تتحكم ثلاثة أنواع من القواعد في نطاقات مختلفة:
- VERDENT.md - تفضيلات شخصية عامة عبر جميع المشاريع
- AGENTS.md - معايير الفريق الخاصة بالمشروع (تخضع للتحكم بالإصدارات)
- plan_rules.md - تخصيص تنسيق مخرجات Plan Mode
أسبقية القواعد:
عند حدوث تعارض، تتفوّق قواعد المشروع (AGENTS.md) على قواعد المستخدم، مما يضمن اتساق الفريق مع الحفاظ على التفضيلات الشخصية للمشاريع الفردية.
اطّلع على مزيد من المعلومات حول أنظمة القواعد
نظام الأدوات وMCP
الأدوات المدمجة:
يقدّم Verdent أدوات شاملة لعمليات الملفات، والبحث (glob/grep)، وتنفيذ الأوامر (bash)، والوصول إلى الويب، وتفويض الوكلاء. تُمكّن الأدوات جميع عمليات التعامل مع الكود والتنقل والتفاعل الخارجي.
بروتوكول سياق النموذج (MCP): يوسّع MCP إمكانيات Verdent من خلال الاتصال بأدوات ومصادر بيانات وخدمات خارجية. اضبط خوادم MCP من خلال الإعدادات ← خوادم MCP لدمج APIs الخاصة بالمشروع والوظائف المخصصة.
عرض مرجع الأدوات تعرّف على تكامل MCP
تنسيق متعدد الوكلاء
تُمكّن بنية الوكلاء الفرعيين المتعددة في Verdent من تنفيذ المهام بالتوازي مع التوجيه والتنسيق التلقائي.
الوكيل الرئيسي (المنسّق): يحلل الوكيل الأساسي الطلبات، ويقسّم المهام المعقدة، ويفوّض العمل المتخصص إلى الوكلاء الفرعيين مع الحفاظ على سياق المحادثة ودمج النتائج.
التنفيذ المتوازي: تعمل عدة وكلاء فرعيين في آنٍ واحد للعمليات المعقدة. مثال: يبحث الوكيل الفرعي Explorer في قاعدة الكود بينما يحلّل Code-reviewer الأمان في الوقت نفسه، مما يوفّر نتائج أسرع.
عزل السياق: يعمل كل وكيل فرعي بنافذة سياق خاصة به. لا تستهلك سوى النتائج النهائية مساحة في سياق الوكيل الرئيسي، مما يمنع الاستنفاد أثناء العمليات المتعددة الخطوات.
توجيه المهام: يوجّه الاكتشاف التلقائي المهام بناءً على الأنماط:
- أسئلة قاعدة الكود ← الوكيل الفرعي
@Explorer - مراجعات الأمان ← الوكيل الفرعي
@Code-reviewer - فحوصات التحقق ← الوكيل الفرعي
@Verifier
إنشاء سير عمل مخصص
يمكن للمستخدمين المتقدمين تخصيص سلوك Verdent لمواءمة عمليات الفريق ومتطلبات المشروع.
سير عمل وكلاء فرعيين مخصصين: أنشئ وكلاء فرعيين متخصصين لتلبية احتياجات خاصة بمجال معين:
- مولّدات وثائق API - استخراج نقاط النهاية والمعاملات من الكود
- مراجعو ترحيل قواعد البيانات - التحقق من أمان تغييرات المخطط
- مدققو إمكانية الوصول - فحص كود الواجهة الأمامية لضمان التوافق مع معايير WCAG
التخصيص القائم على القواعد: حدّد معايير الترميز ومتطلبات الاختبار وتفضيلات المخرجات من خلال ملفات القواعد:
- تطبيق قواعد الفريق (المسافات البادئة، التسمية، الأنماط)
- تحديد أساليب التوثيق ومستويات تفصيل التعليقات
- التحكم في بنية مخرجات Plan Mode ومستوى التفصيل بها
قابلية التوسيع من خلال MCP: دمج الأدوات والخدمات الخارجية:
- أدوات استعلام قواعد البيانات
- APIs الخدمات السحابية (AWS، وAzure، وGCP)
- تكاملات إدارة المشاريع (Jira، وLinear)
- اتصالات خطوط أنابيب CI/CD
تعرّف على الوكلاء الفرعيين المخصصين استكشف خيارات قابلية التوسيع
تقنيات إدارة السياق المتقدمة
تُعد إدارة السياق الفعّالة أمرًا بالغ الأهمية للمشاريع المعقدة وجلسات الترميز الطويلة.
قراءة استراتيجية للملفات:
استخدم file_read مع نطاقات الأسطر للملفات الكبيرة لتجنب زيادة الحمل على السياق. اقرأ فقط الأقسام اللازمة للمهمة بدلًا من الملفات كاملة.
تفويض الوكلاء الفرعيين للبحث:
فوّض المهام الاستكشافية إلى الوكيل الفرعي @Explorer للحفاظ على نظافة سياق المحادثة الرئيسية. تستهلك نتائج بحث الوكيل الفرعي مساحة قليلة من السياق الرئيسي.
البحث قبل القراءة:
استخدم grep_file لتحديد الملفات ذات الصلة قبل قراءة المحتويات كاملة. اجمع بين أنماط glob وgrep_content للحصول على عمليات بحث دقيقة تُقلّل من عمليات الملفات غير الضرورية.
اختيار الأدوات المدرك للسياق:
- قواعد الكود الكبيرة: الوكيل الفرعي
@Explorerلفهم البنية - التحقق المنعزل: الوكيل الفرعي
@Verifierللفحوصات السريعة - مراجعات الأمان: الوكيل الفرعي
@Code-reviewerلتقييم الجودة
مراقبة استخدام السياق: تابع الوكلاء الفرعيين الجاري تنفيذهم من خلال مؤشرات عرض المحادثة. تظهر عمليات الوكلاء الفرعيين في سجل المحادثة مع مؤشرات التقدّم وإسناد النتائج.