ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

وكيل AI في VS Code يعدّ مسودة المواصفات الفنية خلال 15–20 دقيقة بدل يوم ونصف

يضطر المحللون إلى إعادة كتابة متطلبات العميل ومحاضر الاجتماعات يدويًا في مواصفات فنية خاصة (ЧТЗ)، وهي مهمة تستغرق يومًا إلى يوم ونصف. أجلس الفريق وكيل AI داخل VS Code وزوّده بمهارات (Skills)، وهي ملفات Markdown تتضمن قواعد مثل «لا تفترض من عندك» و«اذكر المصدر». أصبحت مسودة ЧТЗ جاهزة الآن خلال 15–20 دقيقة، ومع المراجعة والتدقيق خلال نصف يوم. الخلاصة: لا يأتي المكسب من النموذج نفسه، بل من الحدود الصارمة ومن مراجعة المحلل.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
وكيل AI في VS Code يعدّ مسودة المواصفات الفنية خلال 15–20 دقيقة بدل يوم ونصف
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
تحليل حساب العمولة في ثلاث خدمات40 دقيقة بدل 2–3 ساعات
مقال في Confluenceمسودة خلال 10 دقائق بدل نصف يوم
حقيقة رئيسية #3لا يُوضع في السياق أكثر من 3–4 ملفات، وإلا بدأ الوكيل يختلق المعلومات

يتلقى المحلل من العميل وثيقة بمتطلبات الأعمال والوظائف (БФТ)، ويضيف إليها محاضر اجتماعين أو أكثر، وعليه أن يحوّل ذلك كله إلى مواصفات فنية خاصة (ЧТЗ)، أي وثيقة واضحة للمطورين. يستغرق هذا العمل اليدوي يومًا إلى يوم ونصف: تفتح القالب، وتنقل المتطلبات، وتنتقي الصياغات، ثم تنسّق الوثيقة. فريق يعدّ المتطلبات اللازمة للتطوير أوكل هذه المهمة الروتينية إلى وكيل AI في VS Code. أصبحت مسودة ЧТЗ تُعدّ الآن خلال 15–20 دقيقة، وتكون الوثيقة جاهزة مع مراجعة المحلل خلال نصف يوم بدل يوم ونصف. هذه الأرقام تقديرات داخلية للفريق وليست قياسات مستقلة. لكن تجربته توضح كيف يُضبط الوكيل ليساعد بدل أن يختلق المعلومات.

كيف يعمل خط الإنتاج

المخطط كالتالي: يتحول الاجتماع أو وثيقة БФТ إلى ملخص بصيغة Markdown، ثم يعدّ الوكيل المسودة، ويعدّلها المحلل، وبعد ذلك تنتقل الوثيقة إلى Confluence أو إلى التطوير. هناك عدة وكلاء. يعمل بعضها على خوادم داخلية بنماذج محلية، ويمكن تزويدها بالشيفرة المصدرية دون الحاجة إلى موافقات. أما البقية فمتصلة بالسحابة عبر وصول مؤسسي، ولا تُمنح سوى المستندات التي تسمح بها سياسة الشركة.

يجري العمل في الدردشة المدمجة في VS Code (GitHub Copilot Chat). وتُربط النماذج المحلية عبر BYOK («أحضر مفتاحك الخاص»): تحدد المزوّد (Ollama أو Azure أو أي endpoint متوافق مع OpenAI) والمفتاح، فيظهر النموذج في القائمة بجانب النماذج السحابية. اختار الفريق VS Code لأن المستودعات مفتوحة فيه أصلًا، ويمكن إبقاء مجلد منفصل بجواره يعمل كـ«صندوق رمل»، وتُرفق الملفات بالدردشة عبر روابط مثل #file:requirements.md دون نسخ النص إلى الـprompt. وينجح النهج نفسه في Cursor وIntelliJ IDEA وopencode.

وللأمر جانب اقتصادي أيضًا. فتحليل وثيقة БФТ كبيرة مع شيفرة ثلاث خدمات يستهلك كثيرًا من الرموز (tokens)، ولذلك يكون النموذج المحلي على عتاد الشركة أرخص في كثير من الأحيان من النموذج السحابي.

المهارات بدل الـprompts الطويلة

يُضبط الوكيل عبر المهارات (Skills). المهارة ملف Markdown عادي يتضمن تعليمات، ويوجد في VS Code ضمن المسار .github/skills/<имя>/SKILL.md، ويستخدمه الوكيل تلقائيًا عندما يطابق وصفه المهمة. تتألف المهارة من ثلاثة أجزاء: بنية النتيجة مع قيود صارمة («لا تفترض من عندك»، «اذكر المصدر»، «أبرِز التباينات»)، وملخص لسياق المشروع (المجال والتقنيات والأدوار والأنظمة والمعايير التنظيمية)، وروابط إلى المراجع مثل المسرد ووصف البنية المعمارية. لذلك لا يتجاوز الطلب نفسه سطرين: الملفات والمهمة.

أدوات الوكيل في حدها الأدنى: قراءة الملفات، والبحث بالكلمات المفتاحية، والكتابة في المجلد output/ فقط. ويحذّر المؤلفون من أن الوكيل قد يكتب فوق ملف خاطئ إذا مُنح صلاحية الكتابة، ولذلك لا بد من الحدود.

تُحفظ المهارات في مستودع git مشترك، بمعدل مهارة واحدة لكل نوع من الأعمال: ЧТЗ، ومقال في Confluence، وتحليل الشيفرة، وحالات الاختبار، وملخص الاجتماع، ومذكرة توضيحية للمشروع التقني، ونقاط الوظائف لحساب السعر الأقصى الابتدائي للعقد (НМЦК)، ومتطلبات التطوير. يستنسخ الموظف الجديد المستودع فيحصل على مجموعة جاهزة. وإذا بدأ الوكيل «يتصرف بغرابة»، تُقارَن مهارة المستخدم بالمهارة المرجعية. واختار الفريق المهارات بدل Cursor Rules وprompts النظام لأنها ملف قابل للنقل، ويمكن مراجعته وإدارة إصداراته.

السياق محدود بصرامة: من 2 إلى 4 ملفات Markdown تحوي الوثائق، ومن 1 إلى 3 خدمات برمجية، مع تحديد الدالة المطلوبة، مثل «انظر إلى حساب العمولة في CommissionService.java». وعندما حاولوا تزويد الوكيل بكل شيء دفعة واحدة، غرق في المعلومات وبدأ يختلق. ومن هنا جاءت القاعدة: لا أكثر من 3–4 ملفات في كل مرة، ومع المصطلحات المفتاحية للمهمة فقط.

النتائج وأين يخطئ الوكيل

ثلاث حالات من الممارسة. استغرق تحليل حساب العمولة، المتناثر عبر ثلاث خدمات مصغّرة دون توثيق جيد، نحو 40 دقيقة (20 دقيقة لعمل الوكيل و15 للمراجعة، والباقي لصياغة المهمة) بدل ساعتين إلى ثلاث، ودون إشغال المطور. وتُعدّ مسودة ЧТЗ خلال 15–20 دقيقة، يضاف إليها ساعة إلى ساعتين للتدقيق. وبالمنطق نفسه تُعدّ مقالة Confluence: مسودة خلال 10 دقائق بدل نصف يوم. وهنا تُربط خوادم MCP، فينشئ الوكيل الصفحة بنفسه ويسحب المرفقات. في التعديل الصغير تكفي بضع تصحيحات، أما في ميزة كبيرة ذات عشرة سيناريوهات تقريبًا فيُعاد كتابة نصف النص.

الأخطاء نمطية. فعند نقص السياق يفترض الوكيل من عنده: من عبارة «ناقشنا تطوير نموذج الحالات» قد يستنتج حالات غير موجودة في النظام. ونادرًا ما يعترف بجهله، ويقدّم بثقة معلومات معقولة المظهر لكنها خاطئة. وفي المشاريع الناطقة بالروسية تختلط مصطلحات «заявка» و«обращение» و«запрос»، ولذلك فإن وجود مسرد في المهارة أمر إلزامي. وإذا تعارضت وثيقة БФТ مع محضر الاجتماع، فقد يأخذ الوكيل النسخة الأنسب له دون أن يشير إلى التباين، ولذلك يُدقَّق قسم «التباينات» يدويًا مقابل المصادر.

التحقق متعدد المراحل: يقارن المحلل المسودة بالمصادر والمنطق والتنسيق، وتُعتمد الوثيقة الموجهة للعميل بالاتفاق معه، ويراجع فريق التطوير متطلبات التطوير. وتسهل معالجة الأخطاء المنهجية بجملة واحدة («في القسم 3 خلطتَ بين «مرفوض» و«مسحوب»، صحّح ذلك في كل مكان»)، أما الأخطاء الصغيرة فتُصحَّح يدويًا.

ما الذي يمكنك تطبيقه

ابدأ بوثيقة БФТ واحدة ومحضر اجتماع واحد في مجلد فارغ، وليس بميزة كبيرة. أنشئ مهارة مستقلة لكل نوع من الوثائق. اقصر صلاحية الكتابة للوكيل على مجلد واحد. يستحق كتابة المهارة أن تُبذل إذا كانت المهمة تتكرر، مثل الملخص الأسبوعي للاجتماعات، أما في المهمة لمرة واحدة فإنجازها بنفسك أسرع. تعامل مع الوكيل كمتدرب كفء: سيجمع المادة ويبرز المواضع الغامضة، لكن المسؤولية عن الوثيقة النهائية تقع على المحلل.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول كيف يعمل خط الإنتاج؟

المخطط كالتالي: يتحول الاجتماع أو وثيقة БФТ إلى ملخص بصيغة Markdown، ثم يعدّ الوكيل المسودة، ويعدّلها المحلل، وبعد ذلك تنتقل الوثيقة إلى Confluence أو إلى التطوير. هناك عدة وكلاء. يعمل بعضها على خوادم داخلية بنماذج محلية، ويمكن تزويدها بالشيفرة المصدرية دون الحاجة إلى موافقات. أما البقية فمتصلة بالسحابة عبر وصول مؤسسي، ولا تُمنح سوى المستندات التي تسمح بها سياسة الشركة. يجري العمل في الدردشة المدمجة في VS Code (GitHub Copilot Chat).

ما أبرز التفاصيل حول المهارات بدل الـprompts الطويلة؟

يُضبط الوكيل عبر المهارات (Skills). المهارة ملف Markdown عادي يتضمن تعليمات، ويوجد في VS Code ضمن المسار .github/skills/<имя>/SKILL.md، ويستخدمه الوكيل تلقائيًا عندما يطابق وصفه المهمة. تتألف المهارة من ثلاثة أجزاء: بنية النتيجة مع قيود صارمة («لا تفترض من عندك»، «اذكر المصدر»، «أبرِز التباينات»)، وملخص لسياق المشروع (المجال والتقنيات والأدوار والأنظمة والمعايير التنظيمية)، وروابط إلى المراجع مثل المسرد ووصف البنية المعمارية. لذلك لا يتجاوز الطلب نفسه سطرين: الملفات والمهمة.

ما أبرز التفاصيل حول النتائج وأين يخطئ الوكيل؟

ثلاث حالات من الممارسة. استغرق تحليل حساب العمولة، المتناثر عبر ثلاث خدمات مصغّرة دون توثيق جيد، نحو 40 دقيقة (20 دقيقة لعمل الوكيل و15 للمراجعة، والباقي لصياغة المهمة) بدل ساعتين إلى ثلاث، ودون إشغال المطور. وتُعدّ مسودة ЧТЗ خلال 15–20 دقيقة، يضاف إليها ساعة إلى ساعتين للتدقيق. وبالمنطق نفسه تُعدّ مقالة Confluence: مسودة خلال 10 دقائق بدل نصف يوم. وهنا تُربط خوادم MCP، فينشئ الوكيل الصفحة بنفسه ويسحب المرفقات. في التعديل الصغير تكفي بضع تصحيحات، أما في ميزة كبيرة ذات عشرة سيناريوهات تقريبًا فيُعاد كتابة نصف النص.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…