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

plannotator يضع نقطة تحقق بشرية أمام كل diff لوكيل

نُشر في 14 نوفمبر 2026
plannotator يضع نقطة تحقق بشرية أمام كل diff لوكيل

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

plannotator، مشروع عنده نحو 10,500 نجمة ويتصاعد بسرعة هذا الأسبوع، محاولة لإصلاح تلك اللحظة. إنه سطح مراجعة محلي داخل المتصفح، يتصل بوكيل برمجة ويفتح عندما يكون لدى الوكيل شيء يحتاج إلى قرار. تُعلّم على الخطة أو المستند أو الفرق، فتعود تعليقاتك إلى الوكيل كمدخله التالي.

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

كيف يتصل

إنه لا يستبدل وكيلك. إنه يُركّب على وكيل. يذكر README كلاً من Claude Code وCodex وCopilot CLI وGemini CLI وOpenCode وKiro وDroid وAmp وDeepSeek Harness وPi، ويعمل Inbox أيضاً مع مساعدين شخصيين مثل Grok Bot وMuse وHermes وOpenClaw. يتم الاتصال عبر إضافات كل harness وخطافاته وأوامره، ولهذا يختلف عمق التكامل من أداة إلى أخرى.

الأوامر بالشكل المألوف:

/plannotator-review                    # uncommitted changes
/plannotator-review <github-pr-url>    # a pull request
/plannotator-annotate README.md        # a file
/plannotator-annotate https://docs.rs  # a URL
/plannotator-last                      # the agent's last message
plannotator inbox                      # the queue

على Codex تصبح أوامر الشرطة المائلة `!plannotator ...` أو مهارات skills المعبأة. وضع الخطة لا يحتاج إلى أي أمر: إنه موصول بخطافات كل harness، فحين يكتب الوكيل خطة، يُفتح سطح المراجعة من تلقاء نفسه. هذه التفصيلة أهم مما تبدو. نقطة التحقق التي تحتاج منك أن تتذكر استدعاءها هي نقطة تُتخطى في الأيام المزدحمة، وتلك هي الأيام التي تحتاجها فيها.

تشمل المراجعة Git وGitButler وJujutsu وPerforce وGitHub وGitLab، فالسطح غير مربوط بمنصة واحدة. تُعلّق على الأسطر، وتقترح شيفرة، وتعود التعليقات إلى الوكيل بدل أن تذهب إلى خيط PR لا يقرأه أحد.

صندوق الوارد هو الجزء المثير للاهتمام

مراجعة وكيل واحد مسألة محلولة بحل ممل: افتح الفرق واترك تعليقات.

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

تلك الجملة الواحدة تحل جموداً حقيقياً. النمط المعتاد في human-in-the-loop أن يتوقف الوكيل وينتظر. مع وكيل واحد لا مشكلة. مع أربعة، تصبح أنت أبطأ عملية في النظام، وثلاثة منهم يحرقون السياق بينما تنهي غداءك. صندوق وارد غير متزامن يتيح للوكيل أن يوقف السؤال بدل الجلسة.

يتصل Claude Code وPi وOpenCode عبر إضافات، فتصل الردود في الدور التالي. كل ما عداها يصل عبر MCP بالأمر `plannotator inbox mcp`، و`plannotator inbox --help` يعمل أيضاً كمستند يقرأه الوكيل ليتعلم البروتوكول. هذه قطعة تصميم صغيرة بأثر كبير: نص المساعدة هو مواصفة التكامل.

لماذا متصفح، ولماذا محلي

الفرق في الطرفية جيد لقراءة الشيفرة وسيئ لقراءة أي شيء آخر. مراجعة مواصفة منتج أو نموذج HTML أو تقرير معروض داخل pager تمرين على تضييق العينين، والوكلاء ينتجون هذه الثلاثة بانتظام الآن. عرضها في المتصفح وترك المراجع يضع علامات على الناتج هو السطح الصحيح لهذا النوع من المخرجات.

لقطة من سطح المراجعة المحلي في plannotator

قسم الخصوصية في README محدد بشكل غير معتاد لأداة بهذا الحجم، ويستحق نقله في جوهره بدل تلخيصه. لا توجد قياسات عن بُعد. الخطط والفروق والتعليقات والمسودات والسجل تبقى محلية افتراضياً. يتحقق كل سطح من GitHub بحثاً عن أحدث إصدار عند التحميل، وهذا التحقق لا يمكن إيقافه. قد تشغّل مراجعة Git المحلية `git ls-remote` تجاه origin المضبوط لديك لتحديد الفرع الافتراضي وخط أساس قديم، ويُطلق هذا الاستعلام عند فتح المراجعة، وعند تحميل الفرق، وعند تبديل الأساس، وعند الضغط على fetch. صفحة مراجعة خاملة لا تجري أي اتصال بالشبكة، وهذا وعد أقوى من وعد معظم الأدوات.

لا يغادر المحتوى الجهاز إلا عندما تحتاجه ميزة شبكية: تعليم الروابط يجلب الصفحة، ومراجعة GitHub تستخدم CLI الموثّق لديك، ويرسل Ask AI السؤال المحدد والسياق إلى المزوّد المضبوط، ويرفع المشاركة نصاً مشفّراً إلى خدمة paste.

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

الأثر المقلق

كل شيء في هذا المشروع رهان على أن القيد في عمل الوكلاء هو عرض نطاق المراجعة البشرية، لا قدرة النموذج.

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

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

هذا هو الأصل. عارض الفروق يستطيع أي أحد بناءه. أثر الاستدلال لا.

حيث ما زال يؤلم

أمران، وكلاهما جوهري.

الأول أن أدوات المراجعة تحسّن المراجعة، والمراجعة ليست هي الصحة. الموافقة المعلّمة جيداً على بنية سيئة تبقى موافقة على بنية سيئة، وسطح المراجعة المرتب يجعل الموافقة تبدو كأنها اجتهاد. وInbox على وجه الخصوص يسهّل إفراغ طابور، وإفراغ الطابور سلوك مختلف عن فهمه.

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

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

إذا جرّبت شيئاً واحداً

شغّل `/plannotator-review` على تغييرك غير المودع التالي وعلّق على ثلاثة أسطر، حتى لو لم يكن لديك ما تقوله. التعليقات عرضية. ما تتعلمه هو كم تستغرق مراجعة حقيقية حين يكون السطح مصمماً لها، وهذا الرقم هو سقف إنتاجيتك الجديد. معظم الفرق لم تقسه قط.

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

جدول نقرات يديره المجتمع يطفئ الإعلانات داخل بناءات أندرويد الصينية

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

GPT Image 2.6 أبقى على سعر الرموز ورفع الفاتورة

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

أحدهم أعاد بناء IDM من الخارج وكتب ما لم يمسّه

إعادة تنفيذ بلغة Rust لبرنامج Internet Download Manager تزعم سرعة أكبر بخمسة أضعاف ودعماً لـ 86 لغة. والوثيقة الأكثر إثارة للاهتمام هي الفقرة التي تشرح كيف بُني المشروع دون نسخ أي شيء.

Rune إطار عمل UI بلغة Rust صُمم كي يستطيع الوكيل التحقق من عمله

يرسم Rune بلا واجهة، ويفرّغ شجرة عناصره، ويقبل إدخالًا مكتوبًا، ما يمنح وكيل البرمجة إشارة قابلة للمقارنة لا تقدمها لقطة الشاشة أبدًا. الإطار في مرحلة ما قبل الإصدار ولا يستقبل pull requests.