← العودة إلى المدونة
Aiحوالي 1 دقيقة قراءة

ub-mode: كيف يُلزم Uncle Bob وكيل البرمجة بتقديم دليل على إنجاز العمل

نُشر في 15 نوفمبر 2026
ub-mode: كيف يُلزم Uncle Bob وكيل البرمجة بتقديم دليل على إنجاز العمل

ملف skill خلفه أربعة برامج

كل أسبوع يُطلق مستودع جديد شخصيةً لوكيل البرمجة لديك. ملف markdown فيه اسم ونبرة وقائمة بما ينبغي أن يهتم به النموذج. تضعه في مجلد skills، وتكتب أمراً بخط مائل، فيبدأ الوكيل بكتابة رسائل commit بنبرة مهندس أول شاهد الكثير.

يحمل ub-mode على GitHub 7,989 نجمة حتى 15 نوفمبر 2026، في unclebob/ub-mode. والتثبيت يتبع النمط نفسه بالضبط: انسخ SKILL.md إلى ~/.claude/skills/ub-mode/SKILL.md، أو ما يقابله في Cursor أو Grok، ثم اكتب /ub-mode. ثلاث مراحل. تضم «First Make it Work» كلاً من Laziness Protocol وFoundational Thinking وTDD وRedesign From First Principles وAttack the Premise وSubtract Before You Add وOutcome-Oriented Execution وBuild the Lever، إضافة إلى قسم في المعمارية عن نمذجة النطاق والحدود والانضباط في الأنواع والعمليات المتساوية الأثر وفصل الحالة المشتركة قبل تسلسلها. وتضم «Then Make it Right» كلاً من Fix Root Causes وSequence Work into Verifiable Units وTest Behavior Not Implementation وRefactoring. أما «Practice» فهي سجل، ونظافة نافذة السياق، وتنظيف worktree، وcommits صغيرة مرتبة.

هذه القائمة هي ما سيقتبسه الناس في لقطات الشاشة. أما الجزء الجدير بالقراءة فهو ما بداخل «Then Make it Right»: أربعة برامج سطر أوامر كتبها المؤلف لفحص عمل الوكيل.

مشكلة الجملة

اسأل وكيل برمجة هل انتهى فتحصل على جملة. «نفّذت الـ endpoint، وأضفت اختبارات، والمجموعة تنجح.» تلك الجملة أنتجتها العملية نفسها التي كتبت الكود، فهي لا تحمل أي معلومة مستقلة. من هنا يأتي الـ slop. علاقته بشخصية النموذج ضعيفة، وعلاقته بالحلقة التي يجلس داخلها قوية. تعريف الوكيل للانتهاء ادعاء، والادعاءات رخيصة الإنتاج.

تستبدل الـ skill الادعاء بأرقام على الوكيل أن يحرّكها. يحسب Crapper التعقيد الحلقي وتغطية الاختبارات ودرجة CRAP لكل دالة، والقاعدة أن تبقى كل دالة تحت CRAP < 10. ويبحث Dryer عن التكرار البنيوي ويشترط إزالة الكتل التي تبلغ درجة تشابهها 0.8 أو أكثر. أما Mutator فيشغّل اختبار الطفرات: يكسر الكود عن قصد وينظر هل لاحظت الاختبارات ذلك. ويرسم UML-viewer المكوّنات والتغطية ودرجات CRAP ودرجات الطفرات واتجاهات الاعتماد.

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

Attack the Premise

من بين المبادئ التسعة في المرحلة الأولى، يختلف مبدآن في سلوكهما حين يكون القارئ نموذجاً.

Attack the Premise هو المبدأ الذي كنت سأطلقه وحده. الوكيل مطيع على نحو محدد ومكلف: ينفّذ الطلب كما كُتب، بجدارة، ولا يسأل أبداً هل ينبغي أن يوجد هذا الطلب. اطلب من أحدها إضافة طبقة cache فتحصل على طبقة cache. مختبَرة، ومُودَعة على خطوات صغيرة، بحدود نظيفة. لم يتحقق أحد هل كان الـ endpoint بطيئاً بسبب خطة الاستعلام. ولن يلاحظ الوكيل أن التذكرة التفاف حول قرار اتخذه قبل عامين شخص غادر منذ ذلك الحين.

المراجع البشري يعترض لأن الاعتراض مجاني ولأنه يحمل السياق المحيط في رأسه. أما الوكيل فلا يعترض إلا حين تأمره قاعدة بذلك، وهذا ما يجعل Attack the Premise عنصراً حاملاً. وموقعه في المرحلة الأولى مهم أيضاً، قبل أن يوجد أي كود، حين يكون تغيير الجواب ما زال رخيصاً.

Sequence Work into Verifiable Units هو الثاني، وهو في الحقيقة عن الذاكرة. الجلسات الطويلة تتعفن. قيد وُضع في الدور الثالث يبقى في النافذة في الدور التسعين، لكن وزنه لم يعد نفسه، ويبدأ النموذج بثقة في خرق قاعدة وضعتها قبل ساعة. تقطيع العمل إلى وحدات مع فحص في نهاية كل واحدة يمنحك مكاناً تتوقف عنده وتنظر، ويمنح البوابات شيئاً تعضّه. بوابة في نهاية تعديل بأربعة آلاف سطر تقول لك إن التعديل سيئ. وبوابة في نهاية أربعين سطراً تقول لك أي أربعين.

حيث تتوقف الأرقام عن المساعدة

هنا أتوقف عن الثقة به.

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

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

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

الكاتب الذي يسلّم بوابات الآن

في هذا المشروع نكتة لا يقولها الـ README. جرى الجدل حول Robert C. Martin عشرين عاماً، وأكثره حول نصائح الأسلوب في Clean Code، وحول ما إذا كانت تلك القواعد خبرة مكتسبة بالجهد أم فلكلور بتسويق جيد. والمؤلف نفسه يقدّم اليوم القواعد كبرامج لها حدود ورموز خروج، ويطلب منك تثبيتها بدل قراءتها.

يُقرأ هذا كتنازل، وهو تنازل منصف. المقال لا يمكن تنفيذه. يمكنك أن تختلف مع فصل سنوات ولا تحسم الأمر أبداً. ويمكنك أن تختلف مع CRAP < 10 في أصيل واحد، بتشغيل الأداة على مستودعك والنظر فيما تريد تغييره. تنتهي معارك الأسلوب حين يقدّم أحدهم رقماً، أو على الأقل تصبح أهدأ وأكثر تحديداً. الرجل المشهور بالنثر عن الكود قرر أن النثر هو الجزء الضعيف.

ما لا تراه البوابات

ثمة قيد واحد، أقوله بوضوح. هذه skill واحدة وأربع أدوات CLI. لا شيء في المجموعة يتحقق من أن إنساناً قرأ الـ diff. البوابات تفحص الكود الذي أنتجه الوكيل. ولا تقول شيئاً عن هل وافق أحد على أن هذا الكود ينبغي أن يوجد، أو هل كانت التذكرة تستحق. Attack the Premise، القاعدة التي كنت سأبقيها لو أمكنني إبقاء واحدة، ما زال جملة في ملف markdown، لا يفرضه شيء سوى استعداد النموذج لاتباع التعليمات. أقوى عنصر في المجموعة كلها هو الوحيد الذي لا يقف خلفه برنامج، وهذا يقول شيئاً عن أي المشكلات صعب فعلاً.

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

مقالات ذات صلة

خادم واحد ومذيعة ذكاء اصطناعي واحدة: داخل الكود الذي يُشغّل بثًا ليليًا

open-yoki هو الكود الإنتاجي لمذيعة ذكاء اصطناعي تبث كل ليلة على Binance Square، بعد نزع الشخصية والصوت وكل ما يمس المال. متصفح Chrome يرسم الإطار، وffmpeg يدفع RTMP، ومجلد Markdown يحدد مزاجها وما تنشره.

Pinky يدع الـ agent يقود هاتفك، ويُبقي زر الإرسال مضغوطًا حتى تنقر على «السماح»

يوصّل Pinky أي agent يعمل بـ MCP بهاتف iPhone أو Android حقيقي، ويفرض الموافقة في بوابته هو لا في prompt. تطبيقات البنوك غير مرئية، وحقول كلمة المرور ممنوعة، وعلى Android 13 يحصل الـ agent على شاشة ثانية مخفية.

SeedRealtime من ByteDance يلتقط إطارين في الثانية ويقرر بنفسه متى يتكلم

يجمع Doubao-Seed-Realtime-1.0 إطارات الكاميرا وإطارات الشاشة والصوت في جلسة واحدة ثنائية الاتجاه، بإطارين في الثانية كحد أقصى. القرارات المثيرة هي معدل الإطارات، والكلام التلقائي، وردّ التدقيق الذي يأتي مفعّلاً من المصنع.

أحدهم وضع قوانين العالم في git، فصار بالإمكان عمل blame لمادة قانونية

يحفظ global-law نصوص القوانين في كل بلد داخل مستودع git يمثّل فيه كل commit قانونًا يدخل حيّز التنفيذ في تاريخ معروف. يمكنك تشغيل log وblame وshow وdiff على مادة ما، والسؤال عمّا كان ساريًا في كل بلد في يوم معيّن، وتسليم المدوّنة كاملة إلى مساعد عبر MCP.