Community

سير العمل: النصف المفقود من أتمتة المباني المدعومة بالذكاء الاصطناعي

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

Alper Üzmezler· Sep 19, 2026 · 11 دقيقة قراءة

إليك فشلًا لا علاقة له بالذكاء.

اطلب من مساعد ذكاء اصطناعي جيّد التأسيس أن ينشئ قاعدة Spark في SkySpark. إنه يعرف Axon. ومكتبة الدوال مفهرسة لديه. سيكتب لك شيفرة نظيفة وصحيحة نحويًا — ثم يسلّمك سجلًا واحدًا.

قاعدة Spark العاملة تحتاج اثنين: سجل func يحمل منطق الاكتشاف، وسجل sparkRule يضبط كيف وأين تُطبَّق القاعدة. ويجب أن يتوافق أحدهما مع الآخر. أغفِل الثاني ولن يظهر أي خطأ — ستحصل ببساطة على قاعدة لا تُطلَق أبدًا، في موقع كنت تظن أنه تحت المراقبة.

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

ما هو سير العمل فعليًا

سير العمل هو ملف ماركداون. هذه هي الحيلة كلها.

يحمل قليلًا من البيانات الأمامية (frontmatter) كي يمكن فهرسته، ثم نصًا عاديًا وجداول تصف كيفية إنجاز شيء واحد على الوجه الصحيح:

---
title: Create Spark Rule
description: Step-by-step guide for creating a Spark rule with func and sparkRule records
category: fault-detection
tags: [spark, rule, fault, automation]
version: 1.0
---

كلا خادمَي MCP يحمّلان كل ملف .md في مجلد workflows/ عند الإقلاع، ويعرضانه عبر Model Context Protocol كموارد قابلة للقراءة تحت معرّف workflow://. لا حاجة لإخبار المساعد بوجودها — يستطيع سردها والبحث فيها وسحب نصها الكامل عند الطلب، في منتصف المهمة.

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

يصل سؤال — والمساعد يبحث عن الإجراء أولًا listWorkflows اكتشاف منخفض التكلفة المعرّف · العنوان · الوسوم searchWorkflows كلمات مفتاحية + دلالي درجة الصلة workflow:// قراءة النص الكامل مورد MCP عمل موجَّه كلا السجلَّين، وبالترتيب الصحيح سير العمل هو ماركداون. إضافة ملف إلى workflows/ تجعله حيًّا — فخادم Fantom MCP يراقب المجلد، فلا إعادة بناء ولا إعادة تشغيل. شرط المساهمة هو: «هل تستطيع تدوين كيف تفعلها؟».

الكتالوجان اليوم

خادم Fantom MCP — 13 سير عمل، تغطي جانب البناء والصيانة:

ai-coding-loop · api-migration-reference · connector-workflow · create-pod · create-skyspark-extension · explore-code-relations · haxall-basics · haxall-coding-standards · haxall-methods-workflow · skyspark-4x-migration · unit-testing · use-fanr · xeto-spec-guide

خادم Axon MCP — 10 سير عمل، تغطي جانب التحليلات والعمليات:

app-creation · axon-func-update · axon-lang-information · curRule-computed-points · html-email-skyspark · job-status-check · recform-template-design · spark-rule-creation · task-subscriber-permissions · visualytik-mcp-authoring

ثلاثة وعشرون ملفًا. هذه هي كامل الذاكرة الإجرائية المشفَّرة لسلسلة الأدوات هذه في الوقت الحالي — وهي بعيدة كل البعد عن الكفاية.

كيف يبدو السير الجيد

المثال الرائد هو ai-coding-loop، الذي يعلّم المساعد كيف يغيّر الشيفرة دون أن يدع الفهرس يتعفّن من تحته. تمتد الذاكرة البنيوية للخادم عبر أكثر من 240 مشروعًا وأكثر من 156 ألف دالة؛ وأي تعديل لا يُعاد فهرسته يجعل كل بحث لاحق خاطئًا على نحو خفيّ.

1 · التوجيه askCodebase · getCallers 2 · التغيير أنت تحرّر — الخادم لا يكتب أبدًا 3 · إعادة الفهرسة reindexChangedFiles(paths) 4 · التحقق إعادة البحث · فحص الأثر أكثر من 240 مشروعًا أكثر من 156 ألف دالة

القاعدة التي تتوقف عليها الحلقة كلها جملة واحدة: بعد كل تغيير في الشيفرة، استدعِ reindexChangedFiles على المسارات التي لمستها. أعد التحليل، وأعد بناء عقد الرسم البياني وحوافه، وأعد التضمين. تجاوزها، وسيجيب البحث الدلالي التالي انطلاقًا من قاعدة شيفرة لم تعد موجودة.

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

ويحمل ذلك الملف أيضًا سطرًا يستحق السرقة: «تم التحقق منه حيًّا في 2026-06-10 مقابل sedonaWebEditor سير عمل يحمل تاريخ تحقق هو سير عمل يمكنك الوثوق به أو إحالته إلى التقاعد. أما الذي بلا تاريخ فهو مجرد شائعة.

لماذا يمثّل هذا عنق الزجاجة

الميل الغريزي هو افتراض أن النماذج الأفضل ستسدّ هذه الفجوة. إنها لا تفعل، ويستحق الأمر دقّة في بيان السبب.

ضعف النموذج في هذا المجال ليس في الاستدلال، ولم يعد في الصياغة إلى حدٍّ متزايد — الفهارس المؤسَّسة تتكفّل بالصياغة. الضعف هو أن المعرفة الإجرائية في أتمتة المباني لم تُدوَّن قط في صيغة يستطيع أي شيء تنفيذها. إنها تعيش في رؤوس بضعة آلاف من الممارسين حول العالم، وتنتقل بالتلمذة المهنية: تتعلم أن قاعدة Spark تحتاج سجلَّين لأن مهندسًا أقدم رآك تُطلق قاعدة لم تعمل.

آلية النقل هذه لا تتوسّع، ولا تصمد حين يغيّر الناس وظائفهم. كل متكامل يعيد اشتقاق الإجراءات نفسها بمفرده. وتُهدر الظهيرة نفسها، بالتوازي، في عشرات الشركات.

سير العمل هو تلك اللحظة من التلمذة، مكتوبةً مرة واحدة، ومنفَّذةً من كل مساعد في كل مشروع من بعدها.

لماذا يجب أن يكون الأمر بيد المجتمع

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

الأشخاص الذين يملكون هذه المعرفة لا يكتبون خوادم في الغالب. المهندس الذي يعرف الترتيب الصحيح لتشغيل وحدة سطحية، أو أي نمط curRule يصمد فعلًا على النقاط المحسوبة، هو شخص تحكّم — لا مطوّر TypeScript. ولو كانت المساهمة تتطلب طلب سحب على محرك فهرسة، لبقيت معرفته حيث هي.

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

ممارس يكتب كيف ينجز عمله فعلًا — ملف ‎.md مُراجَع · مُرقَّم الإصدار مُختبَر على مشروع حقيقي، ومؤرَّخ كل مساعد في كل مشروع، من تلك اللحظة فصاعدًا يُكتب مرة واحدة يُفحص مرة واحدة

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

والمجال أصغر من أن يتحمّل التشظّي. أتمتة المباني ليست تطوير ويب؛ لا يوجد جيش من المساهمين في الطريق. إن ظل كل من يعرف Sedona وHaxall وAxon وXeto محتفظًا بإجراءاته لنفسه، فسيواصل الجميع دفع الرسوم الدراسية نفسها. ثلاثة وعشرون ملفًا هي ما استطاعت حفنة منّا إنجازه. مئتان، مُراجَعة ومؤرَّخة، ستغيّر ما يستطيع القادم الجديد فعله في أسبوعه الأول.

المخاطر بصراحة

كتالوج سير العمل ليس جيدًا تلقائيًا، والتظاهر بغير ذلك سيهيّئ هذا المسعى للفشل.

سير عمل خاطئ أسوأ من غياب سير العمل. يتبعه المساعد بثقة فينتج نتيجة خاطئة بثقة. غياب الإجراء ينتج ترددًا على الأقل؛ أما الإجراء السيئ فينتج تشغيلًا سيئًا. المراجعة هنا أهم منها في معظم التوثيق.

سير العمل يتقادم بصمت. غيّرت SkySpark 4.0 صيغة الامتدادات وأبطلت إجراءات حقيقية بين ليلة وضحاها. وسير العمل لا يلاحظ أنه شاخ. ومن هنا وجود version: في البيانات الأمامية، والأفضل من ذلك تاريخ تحقق صريح والمشروع الذي جرى فحصه عليه آخر مرة.

انضباط النطاق. سير العمل الذي يحاول شرح كل شيء لا يعلّم شيئًا. الجيد منها يؤدي مهمة واحدة — أنشئ هذا الشيء، هاجر ذاك الشيء، أبقِ الفهرس محدَّثًا.

لا شيء من هذا يناقض المقاربة. بل يدعم أن تكون المراجعة والتأريخ وإعادة التحقق جزءًا منها من البداية، لا ملحقًا يُضاف عند بلوغ المئتي ملف.

تعال وابنِ الكتالوج

كلا الخادمين متاح المصدر، ومجلدات سير العمل هي أسهل مكان ممكن للبدء:

  • FantomMcpServerworkflows/، 13 ملفًا، للبناء والصيانة
  • AxonMcpServerworkflows/، 10 ملفات، للتحليلات والعمليات

الفجوات ليست خفية. لا يوجد سير عمل لاصطلاحات تسمية نقاط BACnet، ولا لتشغيل تسلسل محطة مبرّدات، ولا لنصف دزينة من قرارات وسم Haystack التي يعيد كل مشروع التقاضي بشأنها.

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

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


المزيد عن كيفية عمل هذه الخوادم: خادم Axon MCP · ذكاء الشيفرة عبر اللغات · أسطول Sidecar ونموذج RLM.