التغييرات
اقرأ التغييرات التي تهم فعلًا.
أصبح الذكاء الاصطناعي يكتب الشيفرة أسرع مما يستطيع المطورون مراجعتها. يسلّمك وكيلٌ آلاف الأسطر في diff، ولا تعرف أي الملفات قد تُدخل حالة تراجع. يمنح Panolayer كل ملف متغيّر درجة مخاطر ويشرح السبب، فتعرف أيها تراجع أولًا. ونفّذ commit وpush من المكان نفسه حين تكون جاهزًا.
لا أحد يقرأ diff من 3,000 سطر. كلنا نمرّر إلى النهاية وننفّذ commit.
معظم الـ diff الكبير ملفات قفل وإعدادات وتعديلات صغيرة لا تحتاج إلى انتباهك. أما الملفات القليلة التي قد تُعطّل شيئًا فعلًا فمدفونة في مكان ما في المنتصف. يُبرزها Panolayer في المقدمة، فتنظر إليها أولًا وتواصل التقدّم بسرعة الوكيل.
01
اعرف أين تنظر أولًا
ليس لديك وقت لقراءة كل ملف لمسه الوكيل، ولا حاجة إلى ذلك. يُظهر لك ملخّص عدد الملفات المتغيّرة والأسطر المضافة والمحذوفة، ويحصل كل ملف متغيّر على درجة مخاطر من 0 إلى 100% مع سبب في سطر واحد. يضع طيف المخاطر الملفات الأعلى خطورة عند الطرف الأحمر. وتعرض أشرطة المخاطر والتداخل الدرجات نفسها عموديًا، أو مجمّعة بحسب ما مسّه كل تغيير.
- الواجهة
- المنطق
- البيانات
- API
- الإعدادات
- البنية التحتية
- الاعتماديات
- الأمان
- الاختبار
- التوثيق
- التنسيق
- التحليلات
- أخرى
02
افتح الملف
حين يحتل ملف مرتبة عالية، تريد أن تعرف السبب قبل قراءته. انقر عليه لترى الـ diff، بعرض منقسم أو مضمّن، مع الاستدلال الكامل لدرجته فوقه.
03
حين لا تكفي الدرجة
تقرأ ميزة «تحليل الكل» مجموعة التغييرات كاملة وتُرجع ملخّصًا، ومخاطر إجمالية، ومخاوف محدّدة، وملاحظة عن كل ملف. ولأي شيء أبعد من ذلك، تفتح «الدردشة» محادثة مع Panolayer Agent، مع إرفاق الملفات المتغيّرة والتغيير نفسه مسبقًا، فتسأل عنه بدلًا من قراءته سطرًا سطرًا.
04
قارن بأحدث commits لديك
تكتسب الدرجة العالية معنى أكبر حين تعرف ما هو المعتاد في مستودعك. يسرد السجل شجرة العمل فوق أحدث commits، ولكل منها تسمية مخاطر ومؤلف وhash. فتعرف ما إذا كان هذا التغيير روتينيًا أم الأخطر مما نفّذت له commit هذا الأسبوع.
05
نفّذ commit وpush
بعد أن تراجع ما يهم، نفّذ commit من الشاشة نفسها. يصوغ Panolayer مسودة لرسالة commit من الـ diff، ويمكنك تعديلها. يكتب Commit إلى فرعك المحلي، ويرسله Commit & Push إلى المستودع البعيد الذي يتتبّعه. تتضمن commits كل ملف متغيّر. وللإعداد الجزئي (partial staging)، يمكنك استخدام Git مباشرةً.
تجري مراجعة pull request على مضيف Git الخاص بك، بعد هذه المرحلة.
Panolayer يقيّد الوكلاء، لا أنت
لا يستطيع الوكيل دمج عمله في فرعك دون موافقتك. يُتحقق من تغييراته أولًا في الـ worktree الخاص بها، ثم تقرر أنت ما إذا كنت ستدمجها. أما عملك أنت فلا يخضع لأي بوابة أبدًا. نفّذ commit متى شئت، حتى مع إخفاق الفحوصات. تبقى الإخفاقات مدرجة في التحقق، فلا شيء مخفي.
أسئلة
ماذا تعني النسبة المئوية للمخاطر؟
إنها تقدير نموذج لمقدار الانتباه الذي يحتاجه تغيير الملف، من 0 إلى 100%، استنادًا إلى الـ diff. وتُجمَّع الدرجات في فئات: آمن، أو منخفض، أو تحذير، أو حرج.
هل هذا هو التحقق نفسه؟
لا. الدرجة تقرأ الـ diff. أما التحقق فيفحص التغيير مقابل البنية المعمارية والقواعد التي يستمدها Panolayer من شيفرتك، ويعمل حين تحفظ ملفًا وحين ينتهي وكيل.
ما الفرق بين الدرجة و«تحليل الكل»؟
الدرجة قراءة سريعة لـ diff كل ملف، مع كل تغيير. أما «تحليل الكل» فيقرأ التغيير كاملًا دفعة واحدة حين تطلب ذلك. وللأسئلة الأعمق، تسلّم «الدردشة» التغيير إلى Panolayer Agent.
هل يمكنني تنفيذ commit عند إخفاق الفحوصات؟
نعم. Panolayer يقيّد الوكلاء، لا أنت. تبقى الإخفاقات مدرجة في التحقق.
هل يمكنني تنفيذ commit لبعض تغييراتي فقط؟
يتضمن commit من Panolayer كل ملف متغيّر. لتنفيذ commit لجزء منها، جهّزه (stage) باستخدام Git مباشرةً.
هل يتصل هذا بـ GitHub؟
يرسل Commit & Push فرعك إلى أي مستودع بعيد يتتبّعه. وتجري طلبات pull request والمراجعة على مضيف Git الخاص بك.