AI CodeOps

تخطيط بالذكاء الاصطناعي يحسم النهج قبل كتابة الكود

وكلاء AI CodeOps يقرؤون مستودعك ويكتبون المتطلبات وخطة التسليم ويسجلون القرارات في صورة ADR قبل توليد أي كود أو مراجعته.

في AI CodeOps، التخطيط هو الخطوات الأولى من الجلسة: يقرأ الوكلاء كود المشروع الفعلي، ثم يكتبون المتطلبات أو تصميما أو خطة تسليم قبل بناء أي شيء. تمرر مخرجاتهم إلى كل خطوة لاحقة، وتضاف إلى لوحة Plan في مساحة العمل، وفي مسارات سير العمل الاستكشافية تسجل بوصفها سجل قرار معماري (ADR) مقترحا.

الخطة التي يكتبها نموذج لا تنفع إلا إذا استندت إلى الكود الذي ستغيره. لذلك حين تستهدف الجلسة مشروعا له مستودع، يستنسخه AI CodeOps أولا للقراءة فقط، مستخدما اتصال git الخاص بمن بدأ الجلسة. يتلقى الوكلاء شجرة الملفات والملفات الأوثق صلة بالمهمة. وإذا تعذرت قراءة المستودع، مثلا لأن أحدا لم يربط حساب git يستطيع رؤيته، تفشل الجلسة مع ذكر هذا السبب. ولا تخطط بصمت لتطبيق جديد كليا بدلا من ذلك.

ميزة Plan with AI، قبل وجود أي مهمة

كثيرا ما يبدأ التخطيط قبل الجلسة: بفكرة لم تصبح مهمة بعد. ميزة Plan with AI في لوحة Plan محادثة مع مساعد تخطيط يعمل كقائد تقني في اجتماع تخطيط. يسأل عما يغير الخطة (لمن هي، وما النطاق، وما معنى «منجز»)، ويقترح نهجا، ويبين ما يترك خارج النسخة الأولى، ويقسم العمل إلى أجزاء يستطيع وكيل واحد إنهاء كل منها في جلسة واحدة.

حين توافق، اختر Draft tasks (صياغة المهام). يحول المساعد المحادثة إلى مهام، لكل منها وصف ومعايير قبول وأولوية والوكيل الأنسب لها والمشروع. لا شيء يسجل بعد: تزيل علامة الاختيار عما لا تريده، وتعدل الباقي، وتختار Backlog أو To do، ثم تنشئها. ويذكر الخط الزمني لكل مهمة أنها سجلت بواسطة مساعد التخطيط.

يعرف المساعد مشاريع مساحة العمل ووكلاءها والمهام المفتوحة أصلا في اللوحة، فلا يصوغ المهمة مرتين. وهو لا يقرأ المستودع: يفعل الوكلاء ذلك حين تعمل جلسة المهمة. ويعمل على مزود النماذج الخاص بمساحة العمل، أو على فئة Standard لدى المنصة ضمن حصة خطتك، ويتوقف حين تنفد ميزانية الذكاء الاصطناعي لمساحة العمل.

الوكلاء الذين يعملون

يتوزع التخطيط على عدة وكلاء مضمّنين. ولكل منهم تعليماته الخاصة:

  • وكيل Architect: النهج، والملفات والوحدات التي ستتغير، والقرارات الرئيسية والمفاضلات والمخاطر.
  • وكيل Product Analyst: المتطلبات مع معايير القبول، وما يدخل في النطاق وما يخرج منه.
  • وكيل Project Planner: خطة تسليم على مراحل مع التبعيات والمعالم الرئيسية وتقديرات الجهد.
  • وكيل Researcher: الأعمال السابقة في قاعدة الكود، والمكتبات المستخدمة والقيود المهمة.
  • وكيل ADR Writer: سجل قرار معماري (Architecture Decision Record) فيه Context و Decision و Consequences و Alternatives.
  • الوكيلان UI Designer و DevOps Engineer: خطة أعمال الواجهة الأمامية وخطة تغييرات البنية التحتية أو خطوط النشر.

تختار سير العمل حين تبدأ جلسة. ومسارات سير العمل المضمّنة التالية تدور في معظمها أو كلها حول التخطيط:

سير العملالخطوات
Discovery & SpecResearcher (الأعمال السابقة)، Product Analyst (المتطلبات)، Project Planner
Architecture DebateArchitect A، Architect B، Reviewer (ناقد)، Architect (التوليف النهائي)
Threat ModelArchitect (النطاق وتدفق البيانات)، Security Auditor (STRIDE)، ADR Writer
Feature SDLCProduct Analyst، Project Planner، Architect، ثم البناء والاختبار والتوثيق

معظم مسارات سير العمل الأخرى تفتتح بخطوة تخطيط واحدة. فسير العمل Plan, Build, Review & Test يبدأ بوكيل Architect، و UI Implementation بوكيل UI Designer، و DevOps Change بوكيل DevOps Engineer، و Performance Tuning بخطة تحسين يضعها Architect بعد قياس الأداء (profiling).

تعمل الخطوات واحدة تلو الأخرى. يتلقى كل وكيل المهمة وسياق المستودع وما كتبته الخطوات السابقة. وفي Architecture Debate يعني ذلك أن الناقد يقرأ مقترحي المعماريين كليهما، وأن الخطوة الأخيرة توازن بين الثلاثة.

مع فئة النماذج Auto، يعامل وكلاء التخطيط على أنهم خطوات توجيه. فيحصل Architect و Product Analyst و Project Planner و Researcher و ADR Writer على أفضل فئة لديك حصة فيها، لأن كل ما يأتي بعدهم يعتمد على مخرجاتهم. راجع النماذج.

ما ينتجه التخطيط

خطة في صفحة الجلسة. تبث مخرجات كل خطوة مباشرة، مع رموزها وتكلفتها. ويمكنك قراءة الخطة قبل أن تنتهي خطوة البناء.

عناصر في لوحة Plan. حين تكتمل الجلسة، يأخذ AI CodeOps أول خطوة يحتوي اسمها على "plan" (وهي Plan أو Delivery plan أو UI plan أو DevOps plan أو Optimization plan) ويحول عناصر قائمتها إلى إدخالات في لوحة Plan. يحصل كل إدخال على درجة خطورة تخمن من صياغته، ويبدأ بحالة to do، ويسجل الجلسة التي جاء منها. أما العناصر التي يوجد عنوانها في اللوحة من قبل فتتخطى، ومنها المؤرشفة والمنتهية، فلا تمتلئ اللوحة من جديد عند إعادة تشغيل سير العمل. ويضاف 50 عنصرا على الأكثر في كل مزامنة. ويمكن لصفحة الجلسة أيضا أن تدفع مخرجات التخطيط فيها إلى اللوحة عند الطلب.

سجل ADR مقترح. ثلاثة من مسارات سير العمل تنتج قرارا لا قائمة مهام: Architecture Debate (توليفه النهائي)، و Discovery & Spec (متطلباته المتفق عليها)، و Threat Model (خطوته Record ADR). حين يكتمل أحدها، يسجل AI CodeOps تلك المخرجات في صورة ADR بحالة proposed (مقترح)، مرتبطا بالجلسة وبالوكيل الذي كتبه. ولا تسجل المخرجات الأقصر من أن تحسم شيئا. ولا يُقبل شيء استنادا إلى كلام الذكاء الاصطناعي: ينقل شخص سجل ADR إلى accepted أو rejected من Plan, ADRs.

هذا عنصر من لوحة Plan كما يعيده GET /api/plan، بعد أن اقترحته خطوة Plan، وهذا نصه:

{
  "id": "pln_01JA8Z3K6W9N2Q4R7T1V5X8Y0B",
  "title": "Add input validation to the coupon field",
  "body": "Reject codes longer than 32 characters and anything outside A-Z, 0-9.",
  "severity": "medium",
  "status": "todo",
  "source": "run:wfr_01JA8YQ4M2C7H5K9P3S6V8X1ZD",
  "projectID": "checkout",
  "createdAt": "2026-10-18T09:14:02.511Z",
  "updatedAt": "2026-10-18T09:14:02.511Z"
}

درجة الخطورة واحدة من high أو medium أو low أو info. وتنتقل الحالة بين backlog و to do و in progress و in review و blocked و done مع عمل الأشخاص والوكلاء على اللوحة.

بوابات الجودة المعنية

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

  • سياسة مساحة العمل. قبل إنفاق أي شيء، تفحص السياسة عند بدء سير العمل (workflow.dispatch) ولكل وكيل فيه (agent.dispatch). قرار الرفض (deny) يوقف الجلسة. وقرار طلب الموافقة (ask) يفتح موافقة في Review & Gate, Approvals، وتنتظر الجلسة إلى أن يبت فيها أحد. ويعاد الفحص حين تغادر الجلسة قائمة الانتظار، تحسبا لتغير السياسة أثناء انتظارها. راجع الموافقات والسياسات.
  • ميزانية التكلفة. متى تجاوز إنفاق الفترة الحد الصارم لمساحة العمل، ترفض الجلسات الجديدة عند التشغيل، وتتوقف الجلسة الجارية قبل استدعائها التالي للنموذج. راجع ضوابط التكلفة.
  • استناد للقراءة فقط. النسخة المستنسخة من المستودع المستخدمة في التخطيط لا تنفذ أبدا. يعمل الكود لاحقا، في البيئة المعزولة للاختبار.

الخطة بحد ذاتها لا تجتاز بوابة ولا تخفق فيها. فالبوابات التي تقرر هل يطلق التغيير تأتي لاحقا: الاختبارات، ومراجعة الملاحظات للفروقات الفعلية، وموافقة بشرية. وهي موصوفة في صفحة بوابات الجودة.

الحدود

وكلاء التخطيط نماذج لغوية. لا يشغلون كودك ولا يقيسون الأداء ولا يستعلمون من أنظمة خارجية، إلا إذا ربطت مساحة عملك أدوات MCP تسمح بها سياسة. قد تكون الخطة خاطئة، وقد تحيد عنها جولة كتابة الكود التي تليها. راجع الفروقات الخارجة من مرحلة البناء، لا الخطة الداخلة إليها.

الأسئلة الشائعة

هل يجري التخطيط في كل جلسة؟

معظم مسارات سير العمل المضمّنة تبدأ بخطوة تخطيط، مثل خطة وكيل Architect أو خطة UI plan لوكيل UI Designer. والاستثناء هو Quality-Gated Change، فهو يبدأ بوكيل Builder ويعمل انطلاقا من المهمة وحدها.

هل يرى وكلاء التخطيط كودي؟

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

إلى أين تنتهي الخطة؟

إلى صفحة الجلسة، بوصفها مخرجات خطوة التخطيط. كما تضاف عناصر أول خطوة يحتوي اسمها على plan إلى لوحة Plan في مساحة العمل، مع تخطي أي عنوان موجود في اللوحة من قبل.

هل يمكنني مناقشة فكرة مع الذكاء الاصطناعي قبل وجود أي مهمة؟

نعم. ميزة Plan with AI في لوحة Plan محادثة مع مساعد تخطيط. وحين تتفقان على الخطة يصوغ مسودات المهام مع معايير القبول والأولوية ووكيل مقترح والمشروع. تراجع كل مسودة ولا تنشئ إلا ما تبقيه.

هل تُقبل سجلات ADR التي يكتبها الذكاء الاصطناعي تلقائيا؟

لا. سجل ADR المأخوذ من جلسة يسجل دائما بحالة proposed. ثم ينقله شخص إلى accepted أو rejected، كما في أي سجل قرار مكتوب يدويا.

هل يمكن لسياسة أن توقف سير عمل قبل أن يبدأ؟

نعم. يمكن لقاعدة في سياسة مساحة العمل أن تسمح ببدء سير عمل أو تشغيل خطوة وكيل معين، أو تطلب موافقة عليه، أو ترفضه. وطلب الموافقة يفتح موافقة تنتظرها الجلسة.