AI CodeOps

وكيل Architect

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

وكيل Architect هو المخطط في جلسة AI CodeOps. يحول المهمة إلى نهج ملموس: الملفات والوحدات التي ستتغير، والقرارات الأساسية والمفاضلات بينها، والمخاطر. وله في مسارات سير عمل المراجعة مهمة ثانية: يقرأ ما وجده الوكلاء الآخرون ويجمعه في إجابة واحدة.

وهو أكثر الوكلاء استخداما على المنصة. يعمل في عشرة من مسارات سير العمل المضمّنة الستة عشر، ويعمل ثلاث مرات في Architecture Debate.

أين يعمل

سير العملالخطوة
Plan, Build, Review & TestPlan
Security-Sensitive ChangeScope change
Parallel ReviewMerge findings
Architecture DebateArchitect A, Architect B, Final synthesis
Threat ModelScope & data-flow
Swarm InspectionMerge summary
Feature SDLCTechnical design
Release ReadinessGo / no-go
Incident ResponseRoot cause
Performance TuningOptimization plan

المدخلات

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

المخرجات

يعيد وكيل Architect نصا: خطة أو تصميما أو ملخصا جامعا أو قرارا، بحسب الخطوة. واثنان من هذه المخرجات يبقيان بعد انتهاء الجلسة:

  • في سير العمل Plan, Build, Review & Test وفي Performance Tuning، تُزامن خطته مع لوحة Plan في مساحة العمل على شكل عناصر خطة.
  • في Architecture Debate، يحفظ توليفه النهائي (Final synthesis) سجل قرار معماري (ADR) مقترحا. ولا يقبل تلقائيا أبدا، بل يقبله شخص أو يرفضه.

حين تعمل الجلسة على نماذج المنصة بفئة Auto، تذهب خطوات Architect إلى فئة Premium أولا، لأن مخرجاته توجه كل خطوة بعده. راجع النماذج والفئات.

مثال على تشغيل

مثال توضيحي، وليس جلسة مسجلة. يبدأ Matt سير العمل Plan, Build, Review & Test بالمهمة «أضف تحديدا لمعدل الطلبات إلى نقطة نهاية تسجيل الدخول العامة». يقرأ وكيل Architect مسارات المصادقة في اللقطة. ثم يقترح محددا للمعدل بنافذة زمنية ثابتة، مفتاحه عنوان IP والحساب، ويسمي ملف الوسيط (middleware) الذي سيضاف وملفي المسارات اللذين سيتغيران، ويقرر أن يكون الرد HTTP 429 مع ترويسة Retry-After. وينبه إلى خطر واحد: عنوان IP مشترك في مكتب قد يمنع فريقا كاملا من الدخول. بعد ذلك يعمل وكلاء Builder و Reviewer و Tester انطلاقا من تلك الخطة، وتظهر خطواتها على لوحة Plan.

الحدود

  • يستنتج من الكود الذي يعرض عليه. فلا يشغل الكود ولا يقيس أداءه ولا يقرأ بيانات الإنتاج.
  • في Release Readiness، قراره بالمضي أو التوقف (go/no-go) نصيحة. أما ما يحتجز التغيير فعلا فهو بوابة الإصدار: الاختبارات ومراجعة الملاحظات والموافقات.
  • في مسارات سير العمل الطويلة تصله الخطوات السابقة مختصرة، فتفقد المخرجات الطويلة جدا بعض تفاصيلها.
  • الخطة لا تكون أفضل من المهمة. فالمهمة المبهمة تنتج خطة عامة.

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

هل يكتب وكيل Architect الكود؟

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

هل يمكنني تغيير سلوك وكيل Architect؟

نعم. أنشئ وكيلا مخصصا باسم Architect في صفحة Agents في مساحة العمل، لتستبدل تعليماته أو لتشغله على نموذج آخر.