عن المشروع

# VibeCoder **أنشئ مشكلات GitHub من هاتفك، واحصل على طلبات السحب (PRs) تلقائيًا، وراجع واطلب الإصلاحات بإبهام لأعلى.** VibeCoder هو عامل مؤتمت لمشكلات GitHub مدفوع بواجهة سطر أوامر لوكيل البرمجة. يراقب مستودعاتك، ويلتقط المشكلات، ويكتب الكود، ويشغّل فحوصات الجودة، ويفتح طلبات السحب — كل ذلك دون أن تلمس لوحة المفاتيح. وهو **محايد تجاه المزوّد**: `claude` ([Claude Code](https://docs.anthropic.com/en/docs/claude-code)) هو الافتراضي، كما أن `codex` (واجهة OpenAI Codex CLI)، و`gemini` (واجهة Gemini CLI)، و`deepseek` (DeepSeek، يُقدَّم عبر Claude Code CLI) مدمجة ويتم اختيارها عبر الإعدادات. ## كيف يعمل 1. تنشئ مشكلة على GitHub (مثلًا من هاتفك). 2. يكتشف VibeCoder Worker المشكلة ويعيّنها لنفسه. 3. ينشئ العامل فرع ميزة ويفوّض العمل إلى وكيل البرمجة المُهيأ. 4. يكتب الوكيل تغييرات الكود. 5. يشغّل العامل فحوصات الجودة (التدقيق، الاختبار، التنسيق). 6. إذا نجحت الفحوصات، يفتح العامل طلب سحب على GitHub. 7. تراجع طلب السحب، وتترك تعليقات، أو تعطي إبهامًا لأعلى لتفعيل الإصلاحات. 8. يطبّق العامل الملاحظات ويدفع التحديثات. 9. توافق وتدمج طلب السحب. ## اختر وكيل البرمجة الخاص بك وكيل البرمجة طبقة قابلة للفصل. هناك أربعة مزوّدين مدمجين: | معرّف المزوّد | الوكيل | ملف بيانات الاعتماد | | --- | --- | --- | | `claude` (افتراضي) | Claude Code | `claude/provider.env` | | `codex` | Codex CLI | `codex/provider.env` | | `gemini` | Gemini CLI | `gemini/provider.env` | | `deepseek` | DeepSeek (عبر Claude Code CLI) | `deepseek/provider.env` | اختر واحدًا باستخدام مفتاح `agent_provider` في `.config.json`. يمكن للمضيفين المختلطين الاشتراك في اختيار يراعي الحصص. ## الميزات الرئيسية - **خط أنابيب من المشكلة إلى طلب السحب**: اكتب مشكلة، واحصل على طلب سحب. يتولى العامل التفريع والبرمجة والاختبار وإنشاء طلب السحب. - **حلقة ملاحظات المراجعة**: اترك تعليقات على طلب السحب، وإبهام لأعلى لتفعيل الإصلاحات. - **التوضيح والتحسين**: إذا كانت المشكلة غير واضحة، يطرح العامل أسئلة قبل البدء. - **وضع التخطيط**: أضف تسمية `planning` للحصول على تقسيمات المهام ومشكلات فرعية بدلًا من التنفيذ المباشر. - **الإجابة على الأسئلة**: أضف تسمية `question` للحصول على إجابات حول قاعدة الكود دون تنفيذ. - **الإصلاح التلقائي للإملاء**: يتم تصحيح فحوصات الإملاء الفاشلة على طلبات السحب تلقائيًا. - **الإصلاح التلقائي لفشل CI**: يتم تشخيص وإصلاح فحوصات CI الفاشلة على طلبات السحب المفتوحة تلقائيًا. - **إطار المهام الخاملة**: عندما لا يوجد عمل قابل للمطالبة، يسجّل العامل مهام خاملة منخفضة الأولوية (الأمان، أفضل الممارسات، إلخ). - **فحوصات الأمان**: تشغيل فحوصات أمان أثناء الجولات الخاملة على المستودعات المراقَبة. - **قائمة عمل قائمة على الأولوية**: يعطي الأولوية لملاحظات طلب السحب، ثم إصلاحات الإملاء، ومعالجة CI، إلخ. - **تحسين التكلفة**: اختيار النموذج حسب المرحلة، والتخزين المؤقت للمطالبات، وتتبع استخدام الرموز. - **عمليات استدعاء بعد التشغيل**: تنفيذيات اختيارية تُشغَّل بعد الجولات الناجحة/الفاشلة. - **إعداد لكل مستودع**: خصّص سلوك العامل لكل مستودع. - **تحسينات المعالم**: إشعارات التقدم، والتراجع التلقائي عن الفروع العالقة. - **الإصلاح الذاتي**: تنفيذ بنسخة ظل، وإعادة تعيين المستودع تلقائيًا، وتنظيف القرص، ومقاومة الأعطال. - **آمن افتراضيًا**: يعالج فقط المشكلات من المؤلفين المسموح لهم وبالتسميات المُهيأة. - **قابل للتوسيع**: أضف وظائف جديدة عبر أوامر Deno/TypeScript. ## الجودة والتحكم لا شيء يصل إلى الفرع الافتراضي (الإنتاج) دون مراجعتك. كل تغيير يصل كطلب سحب؛ تراجع، وتطلب إصلاحات، وتوافق قبل الدمج. يتبع العامل TDD وKISS وDRY، ويشغّل بوابات الجودة الكاملة (`deno test`، `deno lint`، `deno check`، `deno fmt --check`، وsemgrep). ## البدء السريع ### macOS / Linux ```bash # Clone the repository gh repo clone <your-org>/VibeCoder cd VibeCoder # Configure via environment variables VIBE_ALLOWED_AUTHOR=myusername \ VIBE_REPOS="myorg/repo1,myorg/repo2" \ ./setup.sh # Start the worker ./run.sh ``` ### Windows (PowerShell) ```powershell # Clone the repository gh repo clone <your-org>/VibeCoder cd VibeCoder # Configure $env:VIBE_ALLOWED_AUTHOR = "myusername" $env:VIBE_REPOS = "myorg/repo1,myorg/repo2" .\setup.ps1 # Start the worker .\run.ps1 ``` ## البنية يستخدم العامل بنية مشغّل رفيع + Deno TypeScript. نقاط الدخول هي نصوص shell/PowerShell بسيطة تفوّض كل منطق الأعمال إلى Deno. عبر المنصات: macOS وLinux وWindows. يعمل العامل داخل حاوية بأقل صلاحيات. الاحتواء إلزامي. GitHub هو مستوى التحكم البعيد الطبيعي الوحيد. ## المتطلبات - بيئة تشغيل حاويات مدعومة: Apple `container` على macOS، أو Docker أو Podman على Linux وWindows. - [Deno](https://deno.com/) 2+ — الأداة الوحيدة على المضيف التي يحتاجها المشغّل. - `bash` (macOS/Linux) أو PowerShell (Windows) لتشغيل المشغّل. - للإعداد فقط: Git وGitHub CLI موثّق. ## التوثيق - [نظرة عامة](docs/OVERVIEW.md): جولة من صفحة واحدة. - [تدفقات التسميات](docs/workflows/label-flows.md): أي تسمية ومتى. - [دليل الاستخدام](docs/USAGE.md): إنشاء المشكلات، وسير عمل طلبات السحب. - [نظرة عامة على سير العمل](docs/workflows/README.md): دليل المستخدم لمالكي المستودعات. - [Quorum](docs/QUORUM.md): تشغيل عدة مزوّدين في وقت واحد.