البداية مع Gentle-AI: إضافة الذاكرة وسير العمل والأدلة إلى وكيل برمجة بالذكاء الاصطناعي قائم

لمن يناسب

أنت تستخدم بالفعل وكيل برمجة بالذكاء الاصطناعي، ومع ذلك تتكرر المشكلة نفسها في كل مرة: بمجرد أن ينتهي من كتابة الكود يمسح السياق ويبدأ الجولة التالية من الصفر؛ ولا لديه حكم ثابت تجاه مشروعك؛ وبعد انتهاء العمل، لا يبقى أمامك سوى قراءة الفروق بنفسك سطرًا سطرًا لتُثبت ما غيّره حقًا.

وهنا بالضبط يستهدف Gentle-AI. فهو لا يستبدل وكيلك، بل يضيف فوق الوكيل الذي تستخدمه بيئة هندسية حتمية، يلخّصها التوثيق الرسمي بأنها "The deterministic engineering environment"، ولا يستقيم الأمر إلا في ثلاثة أمور: الذاكرة، وسير العمل، والأدلة.

يناسب هذا المطوّرين الذين لديهم مستودع فعلي ويريدون أن يحتفظ الوكيل بقواعد المشروع على المدى البعيد؛ ومن يقود فريقًا ويريد أن يتقدّم الوكيل وفق عملية ثابتة بدل الارتجال في كل مرة؛ والحالات التي تحتاج فيها كل تغيير إلى سجل قابل للمطابقة، لتسهيل التعاون وتسليم المهام.

وبالمقابل، هو لا يحلّ رغبة تبديل محرّر أو نموذج أفضل: فما يضبطه هو طريقة عمل وكيلك الحالي، لا الأداة التي تستعملها. وإن كان الأمر مجرّد نص برمجي عابر ولا تحتاج إلى سجل قابل للتتبع، فاسأل نفسك أولًا إن كانت طبقة إعدادات إضافية تستحق الإضافة.

أول محاولة في 3 دقائق

لا تسلك إلا المسار الرسمي: افتح Quickstart.

https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.md

الشروط المسبقة: أن يكون لديك وكيل مدعوم مثبَّت بالفعل (مثل Claude Code)، وأن يُسمح له بالقراءة والكتابة داخل مجلد المشروع. أما Gentle-AI نفسه فلا يوفّر وكيلًا، بل مهمّته كتابة الإعدادات في الوكيل الذي لديك سلفًا. ويعلن التوثيق الرسمي تغطية 17 تكاملًا، وتُدوَّن الفروق بين كل وكيل في docs/agents.md، كما يوضّح لك ذلك الجدول المقارن ما هي القدرات التي يمكن لكل وكيل أن يحصل عليها.

قبل أن تبدأ، امنح نفسك دقيقة لقراءة ذلك الجدول المقارن وتأكّد من أن الوكيل الذي تستخدمه يوميًا مدرَج فيه. فإن لم يكن مدرَجًا، فبدّل الوكيل قبل الحديث عن الإعدادات؛ فالتجاوز هنا لا ينتج سوى بيئة يتعذّر تثبيتها ويصعب تفسير أثرها.

أما موضع التثبيت فهو مجلد الوجهة المذكور في قسم وكيلك ضمن Quickstart. فالصفحة الرئيسية تذكر فقط أنه ينفّذ إعدادات أصلية، ولا تسرد لكل وكيل مسار حفظه على القرص؛ فلا تخمّن المجلدات من الذاكرة ولا تنسخ مسار وكيل آخر.

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

توجد علامتان واضحتان للنجاح: بدّل الجلسة، فيظل الوكيل قادرًا على ذكر القواعد الموجودة سلفًا في مشروعك، ما يدل على أن الذاكرة استقرّت على القرص؛ وفي الجلسة نفسها يلتزم الوكيل بسير ثابت — خطة أولًا، ثم العمل، ثم سجل قابل للمطابقة — بدل أن يقتصر على إلقاء إجابة. أما وصف المسار الكامل رسميًا فهو: تعمل مطالبة واحدة حتى تصل إلى إيداع مزوّد بنتيجة مراجعة.

أمثلة استخدام

المثال الأول: مطالبة واحدة، من الفكرة إلى إيداع مزوّد بنتيجة مراجعة. فالقسم الموجود في الصفحة الرئيسية للمستودع يعرض هذا المسار بالتحديد: تستعيد الذاكرة سياق المشروع، ويقيّد سير العمل الخطوات، وتشرح الأدلة التغييرات. وعند الأدلة يتوقف الأمر — فالصفحة الرئيسية تعرض هذه السلسلة، لكنها لا تطلع تفاصيل الواجهة خطوة بخطوة؛ أما الترتيب الحقيقي والمخرجات فيُرجَع فيهما إلى Quickstart وdocs/intended-usage.md.

المثال الثاني: إضافة الذاكرة وسير العمل والأدلة القابلة للمطابقة إلى الوكيل. والطريقة هي كتابة إعدادات الوكيل المختار وفق Quickstart؛ والخيارات التي يسردها التوثيق الرسمي تشمل الذاكرة الدائمة ومهارات skills المختارة وخوادم MCP والشخصيات personas. أما ما ينبغي الانتباه إليه فهو أن الصفحة الرئيسية تذكر أسماء هذه الخيارات فقط، دون أن تحدد أي ملف يقابل أي وكيل، ولا من يحسم عند التعارض؛ وهذه أمور يلزم الرجوع فيها إلى docs/agents.md وإلى وثائق كل وكيل على حدة.

ما يشترك فيه المثالان: لست مضطرًا إلى استبدال الوكيل الذي بين يديك، وكل ما يُضاف هو أمران: أن تتذكّر وأن تشرح. أما الصفحة الرئيسية فلا تقدّم بيانات كمّية عن تحسّن الكفاءة أو الجودة، فلا تتوقّع منها أن تثبت لك العائد.

حدود الاستخدام

إنها طبقة إعدادات، لا وكيل جديد ولا بيئة تطوير متكاملة جديدة: يلزم أولًا وجود وكيل مدعوم لتجد الإعدادات مطبَّقة عليه. ويعلن التوثيق الرسمي 17 تكاملًا، بينما تذكر الصفحة الرئيسية منها جزءًا فقط؛ فللتحقق مما إذا كان مُحرِّر ما أو أداة سطر أوامر مُدرَجًا، راجع الجدول المقارن في docs/agents.md، ولا تفترض أن كل شيء مدعوم.

وتصف الصفحة الرئيسية التحقق الثاني بأنه اختياري ومحدود النطاق فقط، من دون ذكر عتبات القرار ولا سيناريوهات الانطباق؛ فلا تتّخذه بوابة جودة، فالتغييرات المهمة تبقى في حاجة إلى مراجعتك أنت.

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

وأخيرًا، التوثيق والموقع الرسمي وويكي كلها بالإنجليزية حاليًا؛ فانسخ الأوامر والمسارات كما هي وانتبه لحالة الأحرف. ويحمل مستودع الصفحة الرئيسية مدخلين: الموقع الرسمي وويكي، فإذا واجهتك مشكلة إعداد تخصّ وكيلًا بعينه فابحث أولًا عن إجابة جاهزة في هذين الموضعين.