عن المشروع

تعد Repo Agent Orchestration مهارة Codex مجتمعية غير رسمية (مرخصة بموجب MIT) تحافظ على اتفاقيات تسليم المستودعات متعددة الوكلاء داخل المستودع نفسه بدلاً من خدمة مركزية. هدفها المعلن هو إنهاء العمل في المستودع عبر السياقات المناسبة بملكية واضحة، وتحقق متناسب، وتسليم قابل للاسترداد. يشير المشروع صراحةً إلى أنه لا يمنح أي أذونات، ولا يفتح أي قدرات للمنتج، ولا يعيد إنتاج أي نظام تنسيق ملكية. تحدد الوثائق ثلاثة أنماط للملكية — المباشرة، والتسليم، والمعمارية — كأوصاف لمن يملك القرارات بدلاً من كونها أعداداً ثابتة من المحادثات. تغطي الإرشادات تفويض العمل القابل للفصل، ومتابعة العمل الجاهز للاعتماد بدلاً من استطلاع الحالة غير المتغيرة، والحفاظ على استقلالية أحكام التنفيذ والمراجعة، والتحقق من هوية Git الفعلية والمسارات الحصرية. يتم وصف الكتاب الداخليين بأنهم يتشاركون شجرة مالكهم بنطاقات منفصلة، بينما يستخدم كتاب App الذين يعملون بشكل مستقل مساحات عمل مسجلة محلياً في المستودع ومنفصلة. وتكون مراجعة التصميم المستقلة مطلوبة بناءً على طلب صريح من المستخدم أو متطلبات المستودع، أو في حالة المخاطر المادية المتقاطعة أو غير القابلة للإلغاء. يتم التثبيت من نسخة المصدر باستخدام scripts/install_repository.py الموجه إلى مسار المستودع. يقوم بنسخ المهارة إلى .agents/skills/repo-agent-orchestration وتحديث كتلة محددة في ملف AGENTS.md في جذر المستودع بشكل متكرر (idempotently)، مع الحفاظ على القواعد خارج تلك الكتلة. تتيح علامة --dry-run معاينة عمليات الكتابة، ويكتشف --check انحراف الملفات المثبتة أو الملف الشخصي دون تعديل الهدف. يقبل المثبت خيارات تغطي الفرع الرئيسي، وجذر مساحة العمل، وبادئة الفرع، وسياسة جذر مساحة العمل، وسياسة مضيف المهمة، وسياسة نموذج المتحكم، وإعدادات النموذج لكل دور، ومسارات التكامل المشتركة، وسياسة الاستمرارية والبوابات الخارجية. الافتراضيات للنماذج هي app_default، والتي تغفل تجاوزات النموذج والتفكير؛ وتحافظ التحديثات على الارتباطات الصريحة الموجودة باستثناء افتراضي مثبت متقاعد يتم ترحيله مرة أخرى إلى app_default. يدعم محول هيكلي اختياري مهام App المطلوبة صراحةً حيث يدعم المضيف مساراً محلياً للمشاريع المحفوظة (saved-project). يتعامل المنشئ والمتحقق الخاص به مع ثمانية أنواع من الحزم — binding، write، review، update، design_handoff، delivery_update، design_reopen و design_decision — والتي تتشارك في مخطط واحد. تذكر الوثائق أن المحول يتحقق من احتواء المسار، وهوية المشروع المحفوظ، وفرع Git الحالي والالتزام (commit)، والمراجعة للقراءة فقط وإعدادات التقرير المحفوظة، ولكنه لا يثبت تفويض المهمة، أو التسليم الفعلي، أو جودة المراجعة أو القبول، وأن حقل DELIVERY في التقرير هو مسار مقصود وليس إيصال استلام. يعتمد التحقق على اكتشاف unittest في المكتبة القياسية لـ Python، ومتحقق نموذجي وعرض توضيحي محلي، مع استهداف CI لإصدارات Python 3.11 و 3.13؛ ويتطلب Git لاختبارات المثبت ومساحات العمل. ينشئ العرض التوضيحي مستودع Git مؤقتاً وأشجار كتابة معزولة ويثبت فحوصات Git المحلية والتعاقدية فقط، وليس إنشاء App، أو تسليم الرسائل، أو النماذج الفعالة أو سلوك الوكيل الحقيقي. يتم توفير حالات سلوكية للتمارين التي لا يمكن لإثباتات السلاسل (string assertions) إثباتها. تتطلب إرشادات التنظيف قراراً صريحاً لكل مساحة عمل وفرع مملوك، مع إزالة البقايا التي تم التحقق من نظافتها أو تكاملها أو التخلي عنها صراحةً فقط من خلال تدفق worktree الخاص بـ Git، والاحتفاظ بالبقايا غير الآمنة أو المفيدة بإحداثيات دقيقة؛ ولا يتضمن ذلك تنظيفاً قائماً على العمر، أو حذفاً قسرياً للعمل القابل للاسترداد، أو حذف الفروع البعيدة، أو برنامجاً خلفياً (daemon)، أو تصعيداً تلقائياً للأذونات. يفصل التخطيط بين المهارة القابلة للتثبيت، والمثبت، والمتحقق النموذجي، والعرض التوضيحي المحلي، والمدخلات السلوكية، ودليل تشغيل مكتبي اختياري واختبارات حتمية.