Ghost: الالتزامات القائمة على النوايا لإدارة الكود الذكي

الالتزام بالنوايا، وليس بالكود.

Ghost هي واجهة سطر أوامر (CLI) تعيد تشكيل سير عمل Git. فبدلاً من الالتزام بالكود مباشرة، تقوم بالالتزام بـ المطالبات. يعمل وكيل الذكاء الاصطناعي على إنشاء المخرجات، بينما يجسد الالتزام كلًا من النية والنتيجة. يصبح سجل Git الخاص بك سلسلة من المطالبات ونتائجها.

يدعم Ghost كلاً من Claude، وGemini، وCodex، وOpenCode، مما يتيح لك تبديل الوكلاء لكل التزام أو تعيين وكيل افتراضي.

الفكرة

الكود زائل، لكن النية دائمة.

كل أمر ghost commit يجيب على سؤال: ماذا كنت تريد أن يحدث هنا؟ بدلاً من ما هي البايتات التي تغيرت؟. كل التزام قابل للتكرار من خلال موجهاته؛ إذا تعطل الكود، فستحصل على التعليمات الدقيقة التي أدت إلى إنشائه. يصبح سجل Git الخاص بك بمثابة وثيقة تصميم، وليس مجرد ملخص للتغييرات.

كل سطر في السجل التالي هو التزام شبح، يمثل رسالة ذكاء اصطناعي تحول الكلمات إلى كود فعال، مع معرف جلسة يربط المخرجات بالجيل الذي أنتجها:

• a3f2c1b add JWT authentication middleware
• 7e91d4a create user registration endpoint with email validation
• 2bc0f88 scaffold Express app with TypeScript and Prettier

لماذا الالتزامات القائمة على النوايا؟

الكود قطعة أثرية، والنية هي مصدر الحقيقة.

عندما تقرأ سجل Git تقليديًا، فإنك تلاحظ ماذا تغير. مع Ghost، ترى المطالبات – وهي القرارات البشرية التي أدت إلى التغيير. بعد عام، عندما تصبح نماذج اللغة الكبيرة أكثر تقدمًا، يمكنك إعادة تشغيل سجل Git وإنشاء نسخة أفضل.

كل التزام قابل للتكرار. يتم الاحتفاظ بالمطالبة مع بيانات وصفية إضافية حول النموذج والوكيل المستخدم. يمكنك إعادة تشغيل أي التزام مقابل دفعة جديدة لمعرفة ما ينتجه Claude من نفس التعليمات.

يصبح السجل وثيقة تصميم. يقرأ ghost log من الأعلى إلى الأسفل، حيث سترى هدف كل قرار معماري، وليس فقط الكود الناتج عنه.

الاختلافات تظهر ما قرره الذكاء الاصطناعي؛ الرسائل تظهر ما طلبته. يمنحك الاثنان معًا سياقًا كاملاً: الهدف والتنفيذ، مرتبطان بشكل لا ينفصم.

كيف يعمل

تبدأ بـ ghost commit -m "Your prompt". يقوم الوكيل بإنشاء الكود، ويكتشف Ghost التغييرات، ثم يقوم بعمل التزام Git برسالة غنية تتضمن الموجه، الوكيل، النموذج، معرف الجلسة، وقائمة الملفات.

البدء السريع

للبدء، استنسخ المستودع، أضف Ghost إلى مسار النظام الخاص بك، قم بتهيئته، ثم قم بإنشاء أول التزام لك بالمطالبة.

• git clone <this-repo>
• export PATH="$(pwd)/ghost/bin:$PATH"
• cd your-project
• ghost init
• ghost commit -m "create a REST API endpoint for user registration"

الأوامر

• ghost init: تهيئة مستودع Git وتثبيت الخطافات وإنشاء دليل .ghost/.
• ghost commit -m "prompt": إنشاء كود من الموجه، تعديل الملفات، ثم الالتزام.
• ghost commit --agent TWIN -m "prompt": استخدام وكيل محدد (Claude، Gemini، Codex، OpenCode).
• ghost commit --dry-run -m "prompt": إنشاء الكود وإظهار التغييرات دون الالتزام.
• ghost log: عرض سجل التزامات Ghost بتنسيق جميل (المطالبة، الوكيل، النموذج، الجلسة، الملفات).
• GHOST_SKIP=1 ghost commit -m "...": الانتقال إلى أمر git commit العادي.

أمثلة

• ميزة جديدة (الوكيل الافتراضي: Claude)
  ghost commit -m "add a login page with email/password form and client-side validation"
• استخدام Gemini
  ghost commit --agent Gemini -m "refactor the database layer to use connection pooling"
• استخدام Codex
  ghost commit --agent Codex -m "fix the race condition in the payment processing queue"
• استخدام OpenCode
  ghost commit --agent OpenCode -m "add OpenAPI documentation for all endpoints"
• مع نموذج محدد
  ghost commit --agent Claude --model claude-opus-4-6 -m "architect a microservices migration plan as code comments"
• المعاينة دون الالتزام
  ghost commit --dry-run -m "add OpenAPI documentation for all endpoints"
• تعيين الوكيل الافتراضي عبر متغير بيئة
  GHOST_AGENT=Gemini ghost commit -m "scaffold a new service"
• التزام يدوي (تجاوز Ghost بالكامل)
  GHOST_SKIP=1 ghost commit -m "bump version to 1.2.0"

تنسيق رسالة الالتزام

كل التزام شبح يحتوي على رسالة غنية تتضمن بيانات وصفية:

• ghost-meta: علامة تشير إلى أن هذا التزام شبح.
• ghost-prompt: المطالبة الدقيقة التي تم تمريرها إلى الوكيل.
• ghost-agent: الوكيل الذي أنشأ الكود (Claude، Gemini، Codex، OpenCode).
• ghost-model: النموذج الذي استخدمه الوكيل.
• ghost-session: معرف فريد لجلسة الإنشاء.
• ghost-files: قائمة مفصولة بفواصل للملفات التي تم إنشاؤها أو تعديلها.

التكوين

• GHOST_SKIP=1: لتجاوز Ghost والانتقال إلى git commit عادي.
• GHOST_AGENT=<agent>: لتعيين الوكيل الافتراضي.
• GHOST_MODEL=<model>: لتعيين النموذج الافتراضي.

• --agent AGENT: لتحديد وكيل لالتزام معين (Claude، Gemini، Codex، OpenCode).
• --model MODEL: لتجاوز النموذج للوكيل المحدد.
• --dry-run: لإنشاء الكود دون مرحلة أو التزام.

المتطلبات

• git الإصدار 2.x أو أحدث.
• bash الإصدار 4 أو أحدث.
• uuidgen (متوفر على macOS ومعظم توزيعات Linux).
• تثبيت وتكوين واجهة سطر الأوامر للوكلاء الذين ترغب في استخدامهم (Claude، Gemini، Codex، OpenCode).

تشغيل الاختبارات

تجري اختبارات التكامل دورة حياة كاملة في مستودع Git مؤقت، بما في ذلك إنشاء وتجميع كود C، والتحقق من صحة جميع حقول البيانات الوصفية.